Quand forcer une sync ?
RingSync maintient les contacts à jour grâce à des syncs périodiques planifiées par votre administrateur IT. Dans certaines situations, vous pouvez vouloir déclencher une sync immédiatement :
- Un collègue vient d'être ajouté à (ou retiré de) l'annuaire et vous avez besoin de son contact maintenant.
- Un admin vient de terminer la reconnexion d'un token expiré et souhaite confirmer que tout fonctionne.
- Votre appareil était hors ligne pendant une période prolongée et les contacts peuvent être obsolètes.
- Vous venez d'enrôler un nouvel appareil et souhaitez le remplir immédiatement.
Forcer une sync depuis l'application mobile
- Ouvrez l'app RingSync et allez sur l'écran Annuaires.
- Tapez sur la carte de l'annuaire que vous souhaitez synchroniser.
- Tapez sur Synchroniser maintenant. La carte passe en vue de progression affichant la page actuelle et le total des contacts traités.
- Attendez l'écran de complétion, qui affiche le nombre de contacts ajoutés, mis à jour et supprimés lors de cette exécution.
Si la carte d'annuaire affiche un état d'erreur (bordure rouge), résolvez d'abord le problème sous-jacent — voir Token Microsoft expiré ou Sync bloquée à zéro.
Après la première sync complète, toutes les syncs suivantes — y compris les manuelles — sont incrémentales. Seuls les changements depuis la dernière sync (nouveaux utilisateurs, champs mis à jour, comptes supprimés) sont récupérés. C'est beaucoup plus rapide qu'une sync complète.
Forcer une sync depuis le dashboard back-office
Les admins peuvent initier un job de sync depuis le dashboard sans accès à un appareil mobile. C'est utile pour vérifier qu'un annuaire est fonctionnel après un changement de configuration.
- Connectez-vous au back-office et ouvrez le Dashboard.
- Dans la liste des annuaires, trouvez l'annuaire que vous souhaitez tester.
- Cliquez sur le bouton Lancer une sync maintenant (l'icône de flèche circulaire à côté de la ligne d'annuaire).
- Un job de sync est mis en file d'attente. La colonne de statut passe à En cours, puis à Succès ou Erreur en quelques minutes.
- Cliquez sur la ligne du job dans le panel Logs pour voir les résultats détaillés par contact.
Une sync déclenchée depuis le dashboard est associée à une session utilisateur spécifique sur un appareil spécifique — elle ne peut pas envoyer des contacts à tous les appareils enrôlés en une seule fois. Pour remplir un nouvel appareil, l'utilisateur doit déclencher la sync depuis son propre téléphone. La sync dashboard est principalement un contrôle de connectivité et de santé.
Ce qui se passe pendant une sync
- L'app appelle le proxy RingSync (
POST /api/sync) pour créer un job de sync. - Le proxy récupère les dernières modifications depuis Microsoft Graph en utilisant un lien delta stocké (ou effectue une récupération complète si aucun n'existe).
- L'app reçoit des pages d'utilisateurs et écrit chaque contact dans le carnet d'adresses natif, en créant, mettant à jour ou supprimant selon les besoins.
- Le nouveau lien delta est sauvegardé sur l'appareil et sauvegardé sur le serveur.
- Le job est clôturé avec un statut
successouerror.
Le téléphone ne contacte jamais Microsoft directement — tous les appels Graph passent par le proxy RingSync.