Enduser Setup : journal en direct et synchronisation avec l’outil externe

À quoi cela sert

L’Enduser Setup fonctionne avec un outil externe qui commande la téléphonie. Deux aides rendent ce couplage traçable. Le Live Log affiche tout ce que l’outil externe envoie à EasyUC, ce qu’EasyUC en fait et chaque réponse renvoyée à l’outil. Vous suivez une commande de la réception au traitement, puis à la réponse.

La Sync to external tool va dans l’autre sens. EasyUC contrôle chaque cluster CUCM de l’Enduser Setup : quel utilisateur possède une configuration (Jabber, téléphone de bureau, device profile) sur quel cluster, et à quel site et à quelle entreprise elle appartient. EasyUC envoie cet inventaire au format JSON, par lots, à une adresse que vous saisissez. L’outil externe connaît ainsi l’inventaire avant de déclencher des commandes. Pendant ce processus, le CUCM n’est accédé qu’en lecture.

Prérequis

• Rôle ROLE_APP_ADMIN. L’interface n’affiche le menu Administration qu’avec ce rôle.
• Le module cucm est activé. Sans ce module, l’interface verrouille la page.
• Au moins un cluster est configuré sous Config Clusters.
• Pour la synchronisation : l’adresse de l’outil externe, qui accepte du JSON via HTTPS, et l’authentification qui y est exigée.
• Le système EasyUC peut atteindre cette adresse sur le réseau.

Procédure pas à pas : consulter le journal en direct

1. Sélectionnez l’espace de travail EasyUC Cisco dans l’en-tête.
2. Ouvrez Administration → CUCM & Provisioning → Enduser Setup → Config Clusters.
3. Cliquez sur Live Log en haut. La page External tool: live log & sync s’ouvre.
4. Laissez l’affichage sur Live pour voir immédiatement les nouvelles entrées, ou arrêtez-le avec Paused.
5. Restreignez la liste avec les filtres : sens (Inbound, EasyUC, Outbound), canal (Public API, Task, Webhook, Sync), statut (Success, Warning, Error, Info), Request ID et texte de recherche.
6. Cliquez sur une entrée. La vue détaillée affiche les données envoyées, la réponse, la section What EasyUC did et les Headers.
7. Cliquez sur l’ID de requête d’une entrée pour voir toutes les étapes de cette commande sous Timeline of this order.
8. Utilisez Load older entries pour remonter dans l’historique et Clear view pour vider l’affichage.

Procédure pas à pas : configurer et tester la cible de synchronisation

1. Sur la page External tool: live log & sync, cliquez sur Sync to external tool.
2. Dans la section External tool (sync target), cochez Sync target active.
3. Saisissez l’URL of the external tool.
4. Sous Authentication, sélectionnez None, Basic Auth ou Bearer Token, puis saisissez le Username et le mot de passe ou le jeton.
5. Saisissez Users per batch.
6. Laissez Verify TLS certificate coché et décidez pour Also send users without configuration.
7. Cliquez sur Save.
8. Cliquez sur Test connection. La page signale Connection works ou Connection failed avec le statut HTTP et la durée.

Procédure pas à pas : lancer la synchronisation

1. Dans la section Sync CUCM enduser configurations, cliquez d’abord sur Dry run (build inventory only).
2. Suivez l’exécution sous Sync runs. Pour chaque cluster, la page affiche la progression, puis les compteurs d’utilisateurs, de configurations, de Jabber, de téléphones de bureau et de device profiles.
3. Cliquez sur Download inventory (JSON) dans l’exécution et vérifiez le fichier.
4. Cliquez sur Sync all CUCM enduser configs to the external tool pour l’inventaire complet, ou sur Send user base only pour les utilisateurs sans configuration.
5. Vérifiez le compteur batches sent de l’exécution et les transferts individuels dans le journal en direct avec le canal Sync.

Champs et options

Vérifier le résultat et circonscrire les erreurs

• Un test de connexion réussi affiche Connection works avec le statut HTTP et la durée en millisecondes.
• Sync runs liste le numéro, le statut, le type, l’heure et l’utilisateur déclencheur de chaque exécution. Un essai à blanc est signalé comme tel.
• Compteur without location mapping supérieur à zéro : ces configurations ne correspondent à aucun site de l’Enduser Setup. Ajoutez l’affectation de site sous Config Clusters.
• Un cluster est marqué en rouge : EasyUC n’a pas pu le lire. Le message d’erreur s’affiche à côté. Vérifiez la connexion CUCM.
• Connection failed : vérifiez l’adresse, l’accessibilité, le certificat et l’authentification. Le statut HTTP affiché permet de cerner la cause.
• Le journal en direct reste vide et affiche No communication yet : l’outil externe n’a pas encore envoyé de requête, ou les filtres sont trop restrictifs.
• Les réponses aux commandes retournent à l’outil via le webhook de la tâche Enduser. Elles apparaissent dans le journal en direct sous le canal Webhook.