- Accueil
- /
- Article
Merci pour votre commentaire.
Configuration des applications XML pour les téléphones sur BroadWorks
Dans cet article
Un commentaire ?Cet article d’aide s’applique aux téléphones de bureau Cisco série 9800 et aux téléphones vidéo Cisco 8875 qui sont enregistrés auprès de Cisco BroadWorks. Lisez cet article pour connaitre 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
XML Services Interface (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 en utilisant les objets XML et les URI pris en charge.
Après avoir souscrit au téléphone aux services, les utilisateurs peuvent accéder à tous les services configurés sur le téléphone en accédant à . Les services XML Cisco sont le nom par défaut. Vous pouvez également changer le nom. Pour fournir un accès facile aux utilisateurs, vous pouvez ajouter les applications XML à des touches programmables ou des touches de ligne.
Les fonctionnalités prises en charge sont :
- Messages (images et texte)
- Pagination
Objets XML pris en charge
-
MenuTéléphoneIP Cisco
-
TexteTéléphoneIP Cisco
-
SaisieTéléphoneIP Cisco
-
RépertoireTéléphoneIP Cisco
-
ImageTéléphoneIP Cisco
-
FichierImageTéléphoneIPCisco
-
MenuIcôneTéléphoneIP Cisco
-
MenuFichierIcôneIPPhoneCisco
-
CiscoIPPhoneStatus (sauf 9841)
-
CiscoIPPhoneStatusFile (sauf 9841)
-
CiscoIPPhoneExecute
URI pris en charge
-
Périphérique
-
Composer
-
ModifierDail
-
Initier
-
Clé
-
Lecture (sonneries uniquement)
-
Touche programmable
Pour plus de détails sur la configuration du service XSI, voir Notes sur le développement de l'application des services téléphoniques IP Cisco Unified.
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 Nom du service applicatif XML et URL du service applicatif XML comme défini dans Paramètres des services XML. |
| 4 |
(Facultatif) Pour ajouter l'authentification permettant d'accéder au service applicatif, configurez ces champs : Nom d'utilisateur XML, Mot de passe XML, Activation 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 dans le fichier de configuration du téléphone (cfg.xml) à l'aide du code XML pour configurer un paramètre.
|
Paramètre |
Par défaut et options |
Description |
|---|---|---|
|
Nom du service applicatif XML |
Par défaut : Vide |
Nom de l'application XML. Le nom s'affiche sur le téléphone comme choix d'application Web. Vous pouvez également configurer ce paramètre dans le fichier XML de configuration du téléphone (cfg.xml) en entrant une chaîne au format suivant : |
|
URL du service applicatif 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 entrant une chaîne au format suivant : Les variables de 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 pour des raisons d'authentification. Vous pouvez également configurer ce paramètre dans le fichier XML de configuration du téléphone (cfg.xml) en entrant 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 s'affiche dans le fichier de configuration (cfg.xml) comme suit : |
|
Activation de 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 entrant une chaîne au format suivant : |
|
Mode d'authentification CISCO XML EXE |
Par défaut : Informations d'identification locales Options : Approuvé, Informations d'authentification locales, Informations d'authentification distantes |
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 entrant 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 accèdent 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 de fonction programmables, configurez Activer les touches de fonction programmables sur Oui. Vous pouvez également configurer ce paramètre dans le fichier de configuration (cfg.xml). Saisissez une chaîne au format suivant : |
| 4 |
Dans la section Touches de fonction programmables, modifiez les champs disponibles de PSK1 à PSK16 au format suivant : fnc=xml;url=<xml_app_path>;nme=<app_name>
où url est le lien sur lequel l'application XML est stockée ; nme est le nom d'affichage de l'application sur l'écran du téléphone.
Exemple
Vous pouvez également configurer ce paramètre dans le fichier de configuration (cfg.xml). Saisissez 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 fréquemment utilisées aux touches de ligne pour que les utilisateurs accèdent 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 |
Configurez le paramètre Poste sur Désactivé pour désactiver le poste. Si la fonction de configuration directe de la PLK est désactivée, vous devez désactiver le poste pour ajouter une fonction étendue à la touche de ligne. Si la fonctionnalité est activée, vous pouvez ignorer cette étape. Pour des détails, voir Activer la configuration directe de la PLK. |
| 5 |
Dans le paramètre Fonction étendue, saisissez une chaîne au format suivant : fnc=xml;url=<xml_app_path>;nme=<app_name>
où url est le lien sur lequel l'application XML est stockée ; nme est le nom d'affichage de l'application sur l'écran du téléphone.
Exemple
Vous pouvez également configurer ce paramètre dans le fichier de configuration (cfg.xml). Saisissez une chaîne au format suivant :
où n est le numéro de poste. |
| 6 |
Cliquez sur Enregistrer toutes les modifications. |
Variables de macro prises en charge dans les URL XML
Vous pouvez utiliser les variables de macro dans les URL XML. Les variables de macro suivantes sont prises en charge :
-
ID utilisateur : UID1, UID2 à UIDn
-
Nom d'affichage : DISPLAYNAME1, DISPLAYNAME2 à DISPLAYNAMEn
-
ID d'authentification : AUTHID1, AUTHID2 à AUTHIDn
-
Proxy : PROXY1, PROXY2 à PROXYn
-
Adresse MAC utilisant des chiffres hexadécimaux en minuscules : 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 de macro |
|---|---|
| $ | La forme $$ se développe en un seul caractère $. |
| A à P | Remplacés par les paramètres généraux GPP_A à GPP_P. |
| SA à SD | Remplacés par les paramètres spéciaux GPP_SA à GPP_SD. Ces paramètres contiennent des clés ou des mots de passe utilisés dans la mise à disposition. $SA à $SD sont reconnus comme des arguments pour le qualificateur d'URL de resynchronisation facultatif, --key. |
| AMM | Adresse MAC utilisant des chiffres hexadécimaux en minuscules (000e08aabbcc). |
| MAU | Adresse MAC utilisant des chiffres hexadécimaux en majuscules (000E08AABBCC). |
| mac | Adresse MAC utilisant des chiffres hexadécimaux en minuscules comportant deux points pour séparer les paires de chiffres hexadécimaux (00:0e:08:aa:bb:cc). |
| PN | Nom du produit ; par exemple, téléphone vidéo 8875, téléphone de bureau 9851. |
| nsp | Numéro de série du produit ; par exemple, 8875, 9841, 9861 |
| sn | Chaîne de numéro de série ; par exemple, 88012BA01234. |
| cert | État du certificat client SSL, installé ou non. |
| IP | Adresse IP du téléphone au sein de son sous-réseau local ; par exemple 192.168.1.100. |
| exastuce | IP externe du téléphone, comme illustré sur Internet ; par exemple, 66.43.16.52. |
|
swver |
Chaîne de version du logiciel. Par exemple, phoneos.3-2-1-0104-37 |
|
ver hwver |
Chaîne de version du matériel. Par exemple, 2.0.1 |
|
prvst |
État de mise à disposition (une chaîne numérique) : -1 = demande de resynchronisation explicite 0 = resynchronisation de mise sous tension 1 = resynchronisation périodique 2 = la resynchronisation a échoué, nouvelle tentative |
|
upgst |
État de mise à niveau (une chaîne numérique) : 1 = première tentative de mise à niveau 2 = la mise à niveau a échoué, nouvelle tentative |
|
upgerr |
Message de résultat (ERR) de la tentative précédente de mise à niveau ; par exemple http_get a échoué. |
|
prvtmr |
Secondes depuis la dernière tentative de resynchronisation. |
|
upgtmr |
Secondes depuis la dernière tentative de mise à niveau. |
|
regtmr1 |
Secondes depuis que la ligne 1 a perdu l'enregistrement avec le serveur SIP. |
|
regtmr2 |
Secondes depuis que ligne 2 a perdu l'enregistrement avec le serveur SIP. |
|
upgcond |
Nom de la macro existante. |
|
schéma |
Schéma d'accès au fichier, un parmi TFTP, HTTP ou HTTPS, tel qu'obtenu après l'analyse de l'URL de mise à niveau ou de resynchronisation. |
|
serv |
Demander le nom d'hôte du serveur cible, obtenu après l'analyse de l'URL de resynchronisation ou de mise à niveau. |
|
servip |
Demander l'adresse IP du serveur cible, obtenue après l'analyse de l'URL de resynchronisation ou de mise à niveau, éventuellement après la recherche DNS. |
|
port |
Demander le port UDP/TCP cible, tel qu'obtenu après l'analyse de l'URL de resynchronisation ou de mise à niveau. |
|
chemin |
Demander le chemin du fichier cible, tel qu'obtenu après l'analyse de l'URL de resynchronisation ou de mise à niveau. |
|
erreur |
Message de résultat de la tentative de resynchronisation ou de mise à niveau. Utile uniquement pour générer des messages syslog de résultats. La valeur est conservée dans la variable UPGERR dans le cas des tentatives de mise à niveau. |
|
Identifiant universel (UID) |
Le contenu du paramètre de configuration de l'ID utilisateur de la ligne n. |
| iscust |
Si l'unité est personnalisée, valeur = 1, sinon 0. L'état de la personnalisation est visible sur la page Informations sur l'interface utilisateur Web. |
| nom du destinataire | Nom associé au premier appel entrant, connecté ou en cours de sonnerie. |
| numéroteur distant |
Numéro de téléphone du premier appel entrant, connecté ou connecté. S'il y a plusieurs appels, les données associées au premier appel trouvé sont fournies. |
| NOM D’AFFICHAGE | Le contenu du paramètre de configuration du nom d'affichage de la ligne N. |
| ID D’AUTHENTIFICATION | Le contenu du paramètre de configuration de l'ID d'authentification de la ligne n. |
