Atualizar as listas no app do celular

No app do Tromso ERP no celular, as listagens são atualizadas puxando a tela para baixo com o dedo, o gesto conhecido como pull-to-refresh. Ele força uma sincronização imediata com o servidor: envia na hora o que você registrou no aparelho e baixa as novidades, sem esperar a sincronização automática, que roda a cada 5 minutos. O gesto funciona em todas as listagens do app.

Para que serve o gesto

O app é feito para funcionar offline: tudo o que você registra (um apontamento, um pedido, uma entrega) fica salvo no aparelho na hora e é enviado ao servidor depois, em segundo plano. Esse envio é a sincronização.

A sincronização acontece sozinha em alguns momentos (ver Atualização manual e automática), mas nem sempre é imediata. O gesto de puxar a lista para baixo é o jeito de forçar a sincronização agora, quando você quer:

ver na lista um registro que acabou de ser criado em outra tela ou por outra pessoa,
conferir se o que você lançou no aparelho já foi enviado ao servidor,
trazer para o app uma alteração feita no sistema no computador.

Ao puxar e soltar, o app tenta enviar de novo o que travou, envia o que está pendente no aparelho e baixa do servidor os dados mais recentes. Por isso, depois do gesto, a lista reflete tanto o que saiu do aparelho quanto o que chegou do servidor.

Como atualizar

Abra a lista que você quer atualizar, por exemplo, Apontamentos ou Pedidos de venda.
Coloque o dedo no topo da lista e puxe para baixo, como se fosse rolar a lista além do começo. Um indicador de carregamento (um girador) aparece no topo da tela.
Solte. O indicador continua girando enquanto a sincronização acontece.
Quando o indicador some, a lista está atualizada, com os dados mais recentes do servidor e o que você tinha pendente já enviado, se houve conexão.

Não há mensagem de “atualização concluída”: o sinal de que terminou é o indicador parar e sumir. Se a lista não mudou, é porque não havia nada novo no servidor nem nada pendente para enviar.

Onde o gesto funciona

O gesto funciona em todas as listagens do app:

Apontamentos (produção): ver Apontamentos.
Pedidos de venda: tanto o painel de início quanto a lista de pedidos. Ver Pedidos de venda.
Pedidos de retirada: ver Pedidos de retirada.
Estoque: o painel de início e a lista de Transferências de estoque. Ver Transferências de estoque.
Entregas, no app do motorista.

Em qualquer uma dessas telas, o gesto tem o mesmo efeito: forçar a sincronização imediata.

Atualização manual e automática

O app sincroniza em quatro situações, para manter o aparelho sempre atualizado sem depender só de você:

Quando você puxa a lista (este gesto): sincronização forçada, imediata.
Quando você volta ao app: ao trazer o app de volta para a tela, ele sincroniza.
Quando a internet volta: se o aparelho estava sem conexão, o app sincroniza assim que ela retorna.
A cada 5 minutos, automaticamente: o app sincroniza em segundo plano nesse intervalo, sem você precisar fazer nada.

O gesto de puxar é o único em que você decide o momento: ele dispara a sincronização na hora e ignora a espera dos 5 minutos. Os demais são automáticos.

Há também o botão Sincronizar, no menu do usuário (o avatar, no canto superior), que dispara uma sincronização completa pelo menu, útil quando você quer sincronizar sem estar numa lista. O gesto de puxar e esse botão fazem o mesmo trabalho por baixo dos panos.

Sem internet

Sem conexão, o gesto não traz dados novos, mas nada se perde: os registros ficam salvos no aparelho, e a lista continua mostrando o que já está lá.

Quando o aparelho perde a conexão e o app não consegue falar com o servidor, aparece o aviso de atenção “Sem sinal”, com a frase “Pedidos na fila até a conexão voltar.”, na parte de baixo da tela.

O aviso sai da tela sozinho quando o app volta a falar com o servidor. Se você fechá-lo, ele some e só reaparece na próxima queda de conexão.

Enquanto a conexão não volta, o envio fica pausado, mesmo com o aviso fechado. Quando ela volta, a sincronização retoma sozinha e envia o que estava pendente. Puxar a lista também tenta de novo: se a conexão ainda não voltou, nada é enviado.

Dúvidas frequentes

Puxei a lista e ela não mudou.

Significa que não havia nada novo no servidor e nada pendente no aparelho para enviar, ou seja, a lista já estava atualizada. O indicador de carregamento girou e parou porque o gesto foi executado. O conteúdo não mudou porque não havia o que mudar. Se você esperava ver um registro, confirme se ele foi realmente criado no servidor e se você está na empresa certa.

O gesto funciona sem internet?

Sim. Sem conexão ele não baixa dados novos, mas nada se perde: os registros ficam no aparelho até a internet voltar. Veja a seção Sem internet, acima, para o aviso que aparece nesse caso.

Qual a diferença entre puxar a lista e o botão Sincronizar?

Os dois forçam a sincronização imediata, da mesma forma. A diferença é o lugar: o gesto de puxar age na lista que você está vendo. O botão Sincronizar fica no menu do usuário (avatar, no canto superior) e serve para sincronizar de qualquer tela, sem precisar estar numa lista.

Preciso puxar a lista para o app atualizar?

Não. O app sincroniza sozinho a cada 5 minutos, e também quando você volta ao app e quando a internet volta. Puxar a lista é para quando você quer o dado mais recente agora, sem esperar os 5 minutos.

Como sei se o que lancei já foi enviado?

Puxe a lista: o gesto envia as pendências antes de baixar as novidades. Em Apontamentos, cada registro mostra um indicador de sincronização. No painel de pedidos de venda, um contador mostra as alterações aguardando envio e diminui conforme o envio acontece. Se o indicador ou o contador não zera, confira o ponto no avatar: verde quando o app está online, vermelho quando está offline.

Criei um pedido no computador e não vejo no app.

O app só mostra os dados que já foram sincronizados para o aparelho. Puxe a lista da tela correspondente para forçar a sincronização imediata. Se o app estiver online, o pedido aparece. Confira também se você está na mesma empresa em que o pedido foi criado: os dados são separados por empresa.