Zx Mobile SyncStates/pt

From ZeXtras Suite Wiki

Jump to: navigation, search
Língua: English  • español • português
ZxMobile logo box.png
Available since ZeXtras version: 1.10
Latest Version: 2.12.2
Released on: January 2nd, 2019
Compatibility List
Admin Guide
FAQ
Troubleshooting
Device List
ZspMobile logo box.png

ZeXtras Mobile e o SyncState

O SyncState (abreviação de Synchronization Status) é um conjunto de informações sobre a sincronização com o dispositivo móvel mantidas no servidor. Toda vez que un dispositivo estabelece conexão com ZxMobile, acontecem as seguintes operações:

  • 1. O dispositivo pede uma operação folderSync para sincronizar as pastas locais com aquelas no servidor.
    É enviado um SyncKey por cada pasta local (ou um único SyncKey estabelecido em '0' se é a primeira conexao entre o dispositivo e o servidor)   
  • 2. O servidor responde com uma lista de pastas disponíveis.
    O servidor envía um SyncKey por cada pasta.
  • 3. Depois, o dispositivo pede uma operação itemSync para sincronizar os elementos.
    O servidor armazena os elementos sincronizados no SyncState.
  • 4. Depois de completar a operação itemSync, o dispositivo envía um comando 'ping' para manter a conexão.
    O 4º paso se repete assim que não hajam mudanças na conta sincronizada.

Toda vez que um novo elemento se armazena na conta de correio, ou um elemento antigo é modificado, o servidor notifica a disponibilidade ao dispositivo, o qual fecha a conexao ativa (aquela a manter em linha com o comando ping) e repete as operações 3 y 4.

O SyncState é a combinação dos SyncKeys salvos no passo 2 e os itemIDs salvos no passo 3. É salvo pelo servidor pelo par único userId/deviceId.

Pedido de sincronização

É o verdadeiro processo de sincronização que pode ser iniciado por ZeXtras Mobile ou pelo cliente. Durante este processo se sincroniza qualquer mudança que tenha acontecido na caixa de correio desde o último pedido, e vice-versa.

O pedido se emite quando:

  • Muda o SyncState
  • Força-se uma sincronização desde o cliente
  • Expira o "ping" actual e o dispositivo envía umo novo (a duração keepalive é definida pelo cliente)

Gerenciando o SyncState

Mediante o zimlet ZeXtras

ZxMobile oferece duas opções para gerenciar os SyncStates dos dispositivos móveis sincronizados:

  • Reset Device: Reseta o SyncState do dispositivo para uma única conta, forçando uma resincronização completa a próxima vez que o dispositivo se conecta com o servidor.
  • Remove Device: Remove do server o SyncState e o histórico. Útil quando o dispositivo móvel não se usa mais ou quando é atribuído a outra pessoa dentro da mesma empresa.

Se pode acessar ás opções desde o zimlet ZeXtras (no menú da esquerda no console Zimbra: ZeXtras -> ZxMobile).

ZxMobile resetdevice.png

Mediante a CLI de ZeXtras

O comando doRemoveDevice

Sintaxe:
   zxsuite mobile doRemoveDevice {account} {device_id} 

LISTA DE PARÂMETROS

NOME              TIPO
account(M)      Nome da conta    
device_id(M)    String

(M) == parâmetro obrigatorio, (O) == parâmetro opcional

Exemplo de uso:

zxsuite mobile doRemoveDevice joao@example.com Appl79032X2WA4S
Remove o SyncState do dispositivo de João Appl79032X2WA4S

O comando doResetAccount

Sintaxe:
   zxsuite mobile doResetAccount {account} 

LISTA DE PARÂMETROS

NOME              TIPO
account(M)    Nome da conta    

(M) == parâmetro obrigatorio, (O) == parâmetro opcional

Exemplo de uso:

zxsuite mobile doResetAccount joao@example.com
Restabelece o estado de todos os dispositivos para a conta de João

O comando doResetDevice

Sintaxe:
   zxsuite mobile doResetDevice {account} [attr1 value1 [attr2 value2...]]

LISTA DE PARÂMETROS

NOME              TIPO                 DEFAULT
account(M)      Nombre de cuenta    
device_id(O)    String                   all

(M) == parâmetro obrigatorio, (O) == parâmetro opcional

Exemplo de uso:

zxsuite mobile doResetDevice joao@example.com Appl79032X2WA4S
Restabelece o SyncState do dispositivo de João Appl79032X2WA4S

Personal tools