Enduser Setup et entreprises

À quoi cela sert

L’Enduser Setup est destiné aux environnements dans lesquels un outil externe, par exemple un portail de services, commande la téléphonie. L’outil envoie une commande contenant l’entreprise, le site et l’utilisateur via la Public API. EasyUC recherche la configuration correspondante et crée dans le CUCM ce qui y est enregistré : téléphone de bureau, clients Jabber, device profile, Single Number Reach, messagerie vocale et translation pattern. Les commandes de suppression retirent de nouveau les objets.

Pour cela, vous affectez deux éléments. Les entreprises (Manage Companies) sont les tenants que l’outil externe adresse avec un code. Sous Config Clusters, vous reliez un cluster CUCM à des entreprises et vous associez chaque nom de site de l’outil externe à un site EasyUC avec un package et des plages de numéros. EasyUC prend lui-même le numéro dans les plages enregistrées.

Contrairement au provisioning automatique, EasyUC attend ici une commande de l’extérieur et ne recherche pas lui-même de nouveaux utilisateurs.

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.
Un compte API pour l’outil externe sous Administration → Integrations & Communication → API Access.
Les sites EasyUC possèdent des packages et des plages de numéros. La sélection de site n’affiche que les sites dotés d’un package.
Les packages contiennent des modèles pour tous les types de périphériques pouvant être commandés.
Le nom et le code de l’entreprise sont convenus avec l’exploitant de l’outil externe, de même que les noms de sites qu’il envoie.

Procédure pas à pas : créer une entreprise

Sélectionnez l’espace de travail EasyUC Cisco dans l’en-tête.
Ouvrez Administration → CUCM & Provisioning → Enduser Setup → Manage Companies. La page s’intitule Companies.
Cliquez sur Add company. La boîte de dialogue Create Company s’ouvre.
Saisissez Company Name et Company Code.
Cliquez sur Create.

Procédure pas à pas : configurer les clusters et les sites

Ouvrez Administration → CUCM & Provisioning → Enduser Setup → Config Clusters. La page s’intitule Enduser Setup.
Cliquez sur Config Cluster. La boîte de dialogue Create an enduser setup s’ouvre.
Sous CUCM Cluster, sélectionnez la connexion CUCM.
Sous Select companies, sélectionnez les entreprises que ce cluster dessert.
Dans la section Map & Configurations, cliquez sur configure new location.
Sous Associated API Location, saisissez le nom de site qu’envoie l’outil externe.
Sous EasyUC Location, sélectionnez le site EasyUC, puis le Package.
Sous Number Ranges for auto assignment, sélectionnez les plages de numéros pour l’attribution automatique.
Avec plusieurs plages, définissez sous Number range configuration si EasyUC remplit les plages l’une après l’autre (Pick range order) ou les utilise en alternance (Round robin), et attribuez l’Index de chaque plage.
Cliquez sur Save & Continue. La boîte de dialogue suivante affiche la configuration du site.
Définissez ce que crée une commande : Enduser Template, IP Phone (modèle et template), Soft Phones, Device Profile, Single Number Reach, Translation Pattern, Voicemail, Busy Trigger et Send e-mails after job finished.
Sous Settings, vérifiez l’option Use the same phone number if line present.
Cliquez sur Save.
La configuration apparaît ensuite dans la liste. Vous basculez l’état config enabled ou config disabled avec Configuration action → Enable Configuration ou Disable Configuration.

Procédure pas à pas : autres sites, entreprises, e-mails et journaux

Pour une configuration activée, cliquez sur Configuration action → Configure new location afin d’associer un autre site d’API. La boîte de dialogue contient en plus Default Language.
Cliquez sur Configuration action → Update Companies pour modifier l’affectation des entreprises.
Cliquez sur Configuration action → Email Notifications. Définissez Enable, saisissez les destinataires et renseignez E-mail Subject et E-mail Content séparément pour la création et la suppression. Avec Preview email content, vous vérifiez le résultat.
La carte d’un site propose des icônes pour Configurations, Jobs, Request Logs et Remove location config.
Cliquez sur Request Logs en haut pour voir toutes les commandes reçues avec Sent At, Status Code, Request et Response.

Champs et options

Champs et options
Champ / action	Signification et utilisation
Company Name / Company Code	Nom et code court de l’entreprise. EasyUC utilise le code pour affecter une commande à l’entreprise.
CUCM Cluster	Connexion CUCM sur laquelle les commandes de ces entreprises sont exécutées.
Associated API Location	Nom de site tel que l’outil externe l’envoie dans la commande.
EasyUC Location / Package	Site EasyUC et package dont les modèles et les valeurs par défaut s’appliquent.
Number Ranges for auto assignment	Plages de numéros du site dans lesquelles EasyUC prend le numéro.
Pick range order	Lorsque tous les numéros de la plage 1 sont utilisés, EasyUC utilise la plage 2, et ainsi de suite.
Round robin	Le premier numéro provient de la plage 1, la requête suivante reçoit son numéro de la plage 2, et ainsi de suite.
Default Language	Langue qu’EasyUC définit si la commande n’en indique pas.
Use the same phone number if line present	Si l’utilisateur possède déjà une ligne, EasyUC utilise son numéro pour les nouveaux périphériques. La plage de numéros est alors ignorée.
Send email notification to the enduser for whom the task was run	Envoie en plus la notification à l’utilisateur concerné.
Variables de substitution dans les e-mails	Entre autres `{{firstName}}`, `{{lastName}}`, `{{userID}}`, `{{location}}`, `{{phoneNumber}}`, `{{companyName}}`, `{{companyCode}}`, ainsi que des valeurs oui/non telles que `{{ipPhoneCreated}}`, `{{windowsCreated}}`, `{{vmCreated}}` et, pour la suppression, `{{ipPhoneDeleted}}`. La liste complète s’affiche dans la boîte de dialogue.

Vérifier le résultat et circonscrire les erreurs

Pour chaque cluster, la liste affiche l’état, les entreprises avec leur code et, pour chaque site, une carte avec EUC Location, Package et Ranges.
Une commande de test apparaît sous Request Logs avec le code de statut et la réponse. Le job associé figure sous Jobs sur la carte du site.
Le journal des requêtes affiche Enduser Not Found : l’ID utilisateur de la commande n’existe pas sur ce cluster.
Une commande n’est affectée à aucune configuration : Company Code ou Associated API Location ne correspondent pas à ce que l’outil externe envoie.
Les entrées du menu d’actions manquent : la configuration est désactivée. Seuls l’activation et Delete sont alors disponibles.
Pour le dépannage en temps réel, utilisez le Live Log ; voir le chapitre « Enduser Setup : journal en direct et synchronisation avec l’outil externe ».