Règles de nommage des périphériques

Objet

Lorsqu’EasyUC crée un périphérique dans le CUCM, il a besoin d’un nom de périphérique et d’une description. Les téléphones matériels portent le nom de leur adresse MAC. Les softphones, profils de périphérique, destinations distantes, CTI route points et périphériques virtuels n’ont pas d’adresse MAC. Pour ceux-ci, EasyUC construit le nom à partir des modèles de cette boîte de dialogue. Le modèle Device Description s’applique à la description de tous les périphériques.

Un modèle se compose de texte fixe et de variables de substitution entre doubles accolades. À la création, EasyUC remplace les variables par les données de l’utilisateur et du périphérique. Pour les softphones, le type de périphérique CUCM impose un préfixe fixe (TCT, BOT, CSF, TAB). La boîte de dialogue l’affiche devant le champ ; vous ne saisissez que la partie qui suit.

L’enregistrement ne modifie pas les périphériques existants. Les règles prennent effet lorsqu’EasyUC crée un périphérique. Si CUCM Changes est activé, EasyUC redéfinit en plus les noms dès que les données d’un utilisateur changent dans le CUCM.

Prérequis

Licence avec le module cucm et la fonction provisioning. Sans provisioning, l’entrée est absente du menu Actions.
Compte EasyUC avec le rôle ROLE_APP_ADMIN. Seuls les administrateurs voient le menu Administration.
La connexion CUCM a été créée et activée. Pour une connexion désactivée, Actions n’affiche que Enable Connection.
Vous connaissez la convention de nommage de votre CUCM. Les noms de périphériques doivent être uniques dans le CUCM. Un modèle sans référence à l’utilisateur provoque un conflit de noms avec le deuxième périphérique.

Procédure pas à pas

Dans l’en-tête, sélectionnez l’espace de travail EasyUC Cisco.
Dans le menu, ouvrez Administration → CUCM & Provisioning → CUCM Connections. La page Manage CUCM Connections liste toutes les connexions.
Dans la ligne de la connexion souhaitée, cliquez sur Actions. La fenêtre contextuelle Menu s’ouvre.
Cliquez sur Device Naming. La boîte de dialogue Device naming s’ouvre.
Lisez la liste des variables de substitution dans la zone d’information en haut. Elle contient aussi les attributs d’utilisateur personnalisés de votre CUCM.
Sous Device Description, saisissez le modèle de la description du périphérique, par exemple {{phoneNumber}} {{firstName}} {{lastName}}.
Adaptez les modèles pour iPhone, Android, CSF et Tablet. Ne saisissez pas le préfixe affiché.
Si nécessaire, adaptez Device Profile, Remote Destination, Remote Destination Profile, Mobile Identity, CTI Route Point et Virtual Device.
Si certains mots du résultat doivent être remplacés, cliquez sur Add dans la zone Replace Naming Values et renseignez Text To Replace et Text To Replace With.
Cliquez sur Save (en haut à droite ou en bas de la boîte de dialogue). La boîte de dialogue se ferme et EasyUC affiche un message de réussite (« Success »). Cancel ferme la boîte de dialogue sans modification.
Créez un softphone pour un utilisateur de test et vérifiez le nom et la description dans le CUCM.

Champs et options

Champs et options
Champ / action	Signification et utilisation
Device Description	Modèle de la description du périphérique. Valeur par défaut : `{{phoneNumber}} {{firstName}} {{lastName}}`. Le résultat est tronqué à 128 caractères. Obligatoire.
iPhone	Nom pour Cisco Dual Mode for iPhone, préfixe `TCT`. Valeur par défaut : `{{userID}}`. Obligatoire.
Android	Nom pour Cisco Dual Mode for Android, préfixe `BOT`. Valeur par défaut : `{{userID}}`. Obligatoire.
CSF	Nom pour Cisco Unified Client Services Framework (Jabber/Webex sur le PC), préfixe `CSF`. Valeur par défaut : `{{userID}}`. Obligatoire.
Tablet	Nom pour Cisco Jabber for Tablet, préfixe `TAB`. Valeur par défaut : `{{userID}}`. Obligatoire.
Device Profile	Nom des profils de périphérique (Extension Mobility). Valeur par défaut : `{{location}}{{userID}}`. Obligatoire.
Remote Destination	Nom de la destination distante. Valeur par défaut : `RD{{userID}}`. Obligatoire.
Remote Destination Profile	Nom du profil de destination distante. Valeur par défaut : `RDP{{userID}}`. Obligatoire.
Mobile Identity	Nom de l’identité mobile. Valeur par défaut : `RDMI{{userID}}{{deviceName}}`. Obligatoire.
CTI Route Point	Nom des CTI route points. Valeur par défaut : `MS{{userID}}`. Obligatoire.
Virtual Device	Nom des périphériques virtuels. Valeur par défaut : `VD{{userID}}`. Obligatoire.
Replace Naming Values	Liste de remplacements. Add crée une ligne, remove la supprime. La liste s’applique aussi bien aux noms de périphériques qu’aux noms de lignes. Les deux boîtes de dialogue (Device Naming et Line Naming) modifient la même liste.
Text To Replace	Texte recherché dans le nom final. EasyUC ne remplace que des mots entiers et ignore la casse. Obligatoire dans chaque ligne.
Text To Replace With	Texte inséré à la place. Obligatoire dans chaque ligne.

Variables de substitution

Variables de substitution
Champ / action	Signification et utilisation
`{{firstName}}`	Prénom de l’utilisateur.
`{{1FirstLetterFirstName}}`, `{{2FirstLetterFirstName}}`, `{{3FirstLetterFirstName}}`	La première, les deux premières ou les trois premières lettres du prénom.
`{{lastName}}`	Nom de l’utilisateur.
`{{userID}}`	ID utilisateur dans le CUCM.
`{{department}}`	Service de l’utilisateur.
`{{title}}`	Titre de l’utilisateur.
`{{displayName}}`	Nom d’affichage de l’utilisateur.
`{{deviceType}}`	Type de téléphone, par exemple « Cisco 8811 ».
`{{deviceTypeShort}}`	Forme abrégée du type de téléphone. « Cisco » est supprimé (`8811`), les softphones deviennent `TCT`, `BOT`, `CSF` ou `TAB`.
`{{deviceName}}`	Nom du périphérique dans le CUCM, par exemple `SEP…` ou `BOT…`.
`{{phoneNumber}}`	Numéro de téléphone. Seuls les chiffres et le signe plus sont utilisés.
`{{location}}`	Emplacement de l’utilisateur.
Dynamic Custom User Fields	Si le CUCM possède ses propres attributs d’utilisateur (Custom User Fields), la boîte de dialogue les liste également. La variable de substitution est le nom de l’attribut entre doubles accolades.

Vérifier le résultat et circonscrire les erreurs

Réussite : un softphone nouvellement créé porte le nom attendu dans le CUCM, par exemple CSFmmuster avec le modèle {{userID}} et l’ID utilisateur mmuster.
Message « This value should not be blank. » sous un champ : tous les modèles sont obligatoires. Chaque ligne sous Replace Naming Values exige aussi les deux valeurs.
Des caractères manquent dans le nom : dans les noms de périphériques, EasyUC translittère les trémas et les caractères spéciaux. Les variables qu’EasyUC ne peut pas résoudre sont supprimées de la description.
Les périphériques existants conservent leur ancien nom : c’est normal. L’enregistrement ne renomme rien.
La création échoue à cause d’un nom en double : le modèle n’est pas unique. Intégrez {{userID}} ou {{phoneNumber}} dans le modèle.