- Accueil
- /
- Article
Merci pour votre commentaire.
Configuration des applications XML pour les téléphones 9800 et 8875 (BroadWorks)
Dans cet article
Un commentaire ?Cet article d'aide concerne les téléphones de bureau Cisco de la gamme 9800 et le visiophone Cisco 8875 enregistrés auprès de Cisco BroadWorks. Lisez cet article pour connaître les objets XML pris en charge, les URI et les étapes de configuration des services XSI sur la page Web du téléphone.
Vue d'ensemble
L'interface des services XML (XSI) est un protocole qui permet la communication entre les applications et le système téléphonique. Vous pouvez ajouter vos propres services XSI à votre téléphone à l'aide des objets XML et des URI pris en charge.
Une fois le téléphone abonné aux services, les utilisateurs peuvent accéder à tous les services configurés sur le téléphone en accédant à . Cisco XML Services est le nom par défaut. Vous pouvez également changer de nom. Pour faciliter l'accès aux utilisateurs, vous pouvez ajouter les applications XML aux touches programmables ou aux touches de ligne.
Les fonctionnalités prises en charge sont les suivantes :
- Messages (images et texte)
- Pagination
Objets XML pris en charge
-
Menu du téléphone IP Cisco
-
Texte du téléphone IP Cisco
-
Entrée pour téléphone IP Cisco
-
Annuaire des téléphones IP Cisco
-
Image d'un téléphone IP Cisco
-
Fichier image pour téléphone IP Cisco
-
Menu d'icônes du téléphone IP Cisco
-
Menu Fichier de l'icône de l'iPhone Cisco
-
État de l'iPhone Cisco (sauf 9811 et 9841)
-
Fichier d'état du téléphone IP Cisco (sauf 9811 et 9841)
-
Cisco IPPhoneExecute
URI pris en charge
-
Appareil
-
Cadran
-
Modifier Dail
-
Init
-
Clé
-
Play (sonneries uniquement)
-
Softkey
Pour plus de détails sur la configuration du service XSI, consultez les notes de développement de l'application Cisco Unified IP Phone Services.
Configurer un téléphone pour se connecter à un service XML
| 1 |
Accédez à la page Web d'administration du téléphone. |
| 2 |
Sélectionnez . |
| 3 |
Dans la section Service XML, configurez les paramètres du nom du service d'application XML et de l'URL du service d'application XML, comme défini dans Paramètres des services XML. |
| 4 |
(Facultatif) Pour ajouter une authentification permettant d'accéder au service de l'application, configurez les champs suivants : nom d'utilisateur XML, mot de passe XML, activation de CISCO XML EXE et mode d'authentification CISCO XML EXE. |
| 5 |
Cliquez sur Enregistrer toutes les modifications. |
Paramètres des services XML
Le tableau suivant définit la fonction et l'utilisation des paramètres de l'application XML dans la section Service XML, sous l'onglet de l'interface Web du téléphone. Il définit également la syntaxe de la chaîne ajoutée au fichier de configuration du téléphone (cfg.xml) avec du code XML pour configurer un paramètre.
|
Paramètre |
Par défaut et options |
Description |
|---|---|---|
|
Nom du service d'application XML |
Par défaut : vide |
Nom de l'application XML. Le nom s'affiche sur le téléphone en tant que choix d'application Web. Vous pouvez également configurer ce paramètre dans le fichier XML de configuration du téléphone (cfg.xml) en saisissant une chaîne au format suivant : |
|
URL du service d'applications XML |
Par défaut : vide |
L'URL où se trouve l'application XML. Vous pouvez également configurer ce paramètre dans le fichier XML de configuration du téléphone (cfg.xml) en saisissant une chaîne au format suivant : Les variables macro sont prises en charge dans les URL XML. Pour les variables macro valides, voir Variables macro prises en charge dans les URL XML. Seuls les protocoles HTTP ou HTTPS sont pris en charge dans l'URL. |
|
Nom d'utilisateur XML |
Par défaut : vide |
Nom d'utilisateur du service XML à des fins d'authentification. Vous pouvez également configurer ce paramètre dans le fichier XML de configuration du téléphone (cfg.xml) en saisissant une chaîne au format suivant : |
|
Mot de passe XML |
Par défaut : vide |
Mot de passe du service XML pour le nom d'utilisateur XML spécifié. Le mot de passe que vous avez saisi dans ce champ apparaît dans le fichier de configuration (cfg.xml) comme suit : |
|
Activer CISCO XML EXE |
Par défaut : Non Options : Oui, Non |
Spécifie si une authentification est requise pour accéder au serveur d'applications XML. Vous pouvez également configurer ce paramètre dans le fichier XML de configuration du téléphone (cfg.xml) en saisissant une chaîne au format suivant : |
|
Mode d'authentification CISCO XML EXE |
Par défaut : identifiant local Options : Authentification fiable, locale, distante |
Spécifie le mode d'authentification pour Cisco XML EXE.
Vous pouvez également configurer ce paramètre dans le fichier XML de configuration du téléphone (cfg.xml) en saisissant une chaîne au format suivant : |
Ajouter une application XML à une touche programmable
Ajoutez les applications fréquemment utilisées aux touches programmables pour que les utilisateurs puissent accéder facilement au service.
Avant de commencer
Le service d'application XML a été correctement configuré.
| 1 |
Accédez à la page Web d'administration du téléphone. |
| 2 |
Sélectionnez . |
| 3 |
Dans la section Touches programmables, réglez la touche programmable Activer sur Oui. Vous pouvez également configurer ce paramètre dans le fichier de configuration (cfg.xml). Entrez une chaîne au format suivant : |
| 4 |
Dans la section Touches programmables, modifiez les champs disponibles du PSK1 au PSK16 au format suivant : fnc=xml;url=<xml_app_path>;nme=<app_name>
où
Exemple
Vous pouvez également configurer ce paramètre dans le fichier de configuration (cfg.xml). Entrez une chaîne au format suivant :
où n est le numéro de la touche programmable. |
| 5 |
Cliquez sur Enregistrer toutes les modifications. |
Ajouter une application XML à une touche de ligne
Ajoutez les applications les plus fréquemment utilisées aux touches de ligne pour que les utilisateurs puissent accéder facilement aux services.
Avant de commencer
Le service d'application XML a été correctement configuré.
| 1 |
Accédez à la page Web d'administration du téléphone. |
| 2 |
Sélectionnez . |
| 3 |
Sélectionnez une touche de ligne. |
| 4 |
Réglez le paramètre Extension sur Disabled pour désactiver l'extension. Si la fonction de configuration PLK directe est désactivée, vous devez désactiver l'extension pour ajouter une fonction étendue à la touche de ligne. Si la fonctionnalité est activée, vous pouvez ignorer cette étape. Pour plus de détails, voir Activer la configuration PLK directe. |
| 5 |
Dans le paramètre Extended Function, entrez une chaîne au format suivant : fnc=xml;url=<xml_app_path>;nme=<app_name>
où
Exemple
Vous pouvez également configurer ce paramètre dans le fichier de configuration (cfg.xml). Entrez une chaîne au format suivant :
où n est le numéro de poste. |
| 6 |
Cliquez sur Enregistrer toutes les modifications. |
Les variables macro sont prises en charge dans les URL XML
Vous pouvez utiliser des variables macro dans les URL XML. Les variables macro suivantes sont prises en charge :
-
ID utilisateur : UID1, UID2 vers UIDn
-
Nom d'affichage : DisplayName1, DISPLAYNAME2 vers DisplayNameN
-
ID d'authentification : AUTHID1, AUTHID2 vers AuthIDN
-
proxy : Proxy1, PROXY2 vers ProxyN
-
Adresse MAC en minuscules hexadécimales : MA
-
Nom du produit : PN
-
Numéro de série du produit : PSN
-
Numéro de série : Serial_Number
| Nom de la macro | Expansion macroéconomique |
|---|---|
| $ | La forme $$ s'étend à un seul caractère $. |
| De A à P | Remplacé par les paramètres généraux GPP_A à GPP_P. |
| SA à SD | Remplacé par les paramètres spéciaux GPP_SA à GPP_SD. Ces paramètres
contiennent les clés ou les mots de passe utilisés pour l'approvisionnement. $SA à $SD sont reconnus comme arguments pour le qualificatif d'URL de resynchronisation facultatif, --key. |
| MA | Adresse MAC en minuscules hexadécimales (000e08aabbcc). |
| MAU | Adresse MAC en chiffres hexadécimaux majuscules (000E08AABBCC). |
| MAC | Adresse MAC utilisant des chiffres hexadécimaux minuscules avec deux points pour séparer les paires de chiffres hexadécimaux (00:0 e:08:aa:bb:cc). |
| PN | Nom du produit ; par exemple, visiophone 8875, téléphone de bureau 9851. |
| PSN | Numéro de série du produit ; par exemple, 8875, 9841, 9861 |
| SN | Chaîne de numéro de série ; par exemple, 88012BA01234. |
| CCERT | État du certificat client SSL, installé ou non. |
| IP | Adresse IP du téléphone sur son sous-réseau local ; par exemple, 192.168.1.100. |
| EXTIP | Adresse IP externe du téléphone, telle qu'elle apparaît sur Internet ; par exemple, 66.43.16.52. |
|
SWVER |
Chaîne de version du logiciel. Par exemple, PHONEOS.3-2-1-0104-37 |
|
HWVER |
Chaîne de version matérielle. Par exemple, 2.0.1 |
|
PRVST |
État d'approvisionnement (chaîne numérique) : -1 = demande de resynchronisation explicite 0 = resynchronisation à la mise sous tension 1 = resynchronisation périodique 2 = échec de la resynchronisation, nouvelle tentative |
|
UPGST |
État de mise à niveau (chaîne numérique) : 1 = première tentative de mise à niveau 2 = échec de la mise à niveau, nouvelle tentative |
|
UPGERR |
Message de résultat (ERR) de la précédente tentative de mise à niveau ; par exemple, http_get a échoué. |
|
PRVTMR |
Quelques secondes se sont écoulées depuis la dernière tentative de resynchronisation. |
|
UPGTMR |
Quelques secondes se sont écoulées depuis la dernière tentative de mise à niveau. |
|
REGTMR1 |
Quelques secondes se sont écoulées depuis que Line 1 a perdu son enregistrement sur le serveur SIP. |
|
REGTMR2 |
Quelques secondes se sont écoulées depuis que Line 2 a perdu son enregistrement sur le serveur SIP. |
|
UPGCOND |
Nom de la macro Legacy. |
|
SCHEME |
Schéma d'accès aux fichiers, TFTP, HTTP ou HTTPS, obtenu après avoir analysé l'URL de resynchronisation ou de mise à niveau. |
|
SERV |
Demandez le nom d'hôte du serveur cible, tel qu'il a été obtenu après avoir analysé l'URL de resynchronisation ou de mise à niveau. |
|
SERVIP |
Demandez l'adresse IP du serveur cible, telle qu'elle a été obtenue après avoir analysé l'URL de resynchronisation ou de mise à niveau, peut-être à la suite d'une recherche DNS. |
|
PORT |
Demandez le port UDP/TCP cible, tel qu'il a été obtenu après avoir analysé l'URL de resynchronisation ou de mise à niveau. |
|
PATH |
Demandez le chemin du fichier cible, tel qu'il a été obtenu après avoir analysé l'URL de resynchronisation ou de mise à niveau. |
|
ERR |
Message de résultat d'une tentative de resynchronisation ou de mise à niveau. Utile uniquement pour générer des messages Syslog contenant les résultats. La valeur est conservée dans la variable UPGERR en cas de tentative de mise à niveau. |
|
UIDN |
Le contenu du paramètre de configuration Line n UserID. |
| ISCUST |
Si l'unité est personnalisée, valeur=1, sinon 0. L'état de personnalisation est visible sur la page d'informations de l'interface utilisateur Web. |
| INCOMINGNAME | Nom associé au premier appel connecté, à la sonnerie ou au premier appel entrant. |
| REMOTENUMBER |
Numéro de téléphone du premier appel connecté, qui sonne ou du premier appel entrant. S'il y a plusieurs appels, les données associées au premier appel détecté sont fournies. |
| Afficher le nom | Le contenu du paramètre de configuration Line N Display Name. |
| AuthID | Le contenu du paramètre de configuration de l'ID d'authentification Line N. |
