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.

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 à Paramètres > Réseau et service > Cisco XML services. Cisco XML services est le nom par défaut. Vous pouvez également modifier le nom. Pour faciliter l'accès des utilisateurs, vous pouvez ajouter les applications XML aux touches programmables ou linéaires.

Les fonctionnalités prises en charge sont les suivantes :

  • Messages (images et texte)
  • Radiomessagerie

Objets XML pris en charge

  • CiscoIPPhoneMenu

  • CiscoIPPhoneText

  • CiscoIPPhoneInput

  • CiscoIPPhoneDirectory

  • CiscoIPPhoneImage

  • CiscoIPPhoneImageFile

  • CiscoIPPhoneIconMenu

  • CiscoIPPhoneIconFileMenu

  • CiscoIPPhoneStatus (sauf 9841)

  • CiscoIPPhoneStatusFile (sauf 9841)

  • CiscoIPPhoneExecute

URI pris en charge

  • Périphérique

  • Cadran

  • EditDail

  • Init

  • Clé

  • Lecture (sonneries uniquement)

  • Touche programmable

Pour plus d'informations sur la configuration du service XSI, consultez Cisco Unified IP Phone Notes sur le développement d'applications Services.

Configurer un téléphone pour se connecter à un service XML

1

Accéder à la page Web d'administration du téléphone.

2

Sélectionnez Voix > Téléphone.

3

Dans la section XML Service , configurez les paramètres Nom du service applicatif XML et XML URL du service d'application comme défini dans Paramètres pour XML services.

4

(Facultatif) Pour ajouter l'authentification afin d'accéder au service d'application, configurez les champs suivants : Nom d'utilisateur XML, Mot de passe XML, CISCO XML EXE Enable et CISCO XML EXE Auth Mode.

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 XML Service sous l'onglet Voix > Téléphone 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) à l'aide du code XML pour configurer un paramètre.

Tableau 1. Paramètres des services XML

Paramètre

Valeur par défaut et options

Description

XML Application Service Name

Valeur par défaut : vide

Nom de l'application XML. Le nom s'affiche sur le téléphone dcomme choix d'application wWeb.

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 :

<XML_Application_Service_Name ua="na">XML Nom de l'APPLICATION</XML_Application_Service_Name>

XML Application Service URL

Valeur par défaut : vide

L'URL de 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 :

<XML_Application_Service_URL ua="na">https://server.com/path/app.xml</XML_Application_Service_URL&gt ;

Les variables de macro sont prises en charge dans les URL XML. Pour les variables de macro valides, voir Variables de macro prises en charge dans XML URL.

Seuls les protocoles HTTP ou HTTP sont pris en charge dans l'URL.

XML Utilisateur Name

Valeur par défaut : vide

Nom d'utilisateur du service XML en vue de l’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 :

<XML_User_Name ua="na">nom_utilisateur</XML_User_Name>

XML Password

Valeur 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 :

<!-- <XML_Password ua="na">*************</XML_Password> -->

Permet d'activer XML EXE CISCO

Paramètre par défaut : non

Options : Oui, Non

Indique 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 :

<CISCO_XML_EXE_Enable ua="na">Oui</CISCO_XML_EXE_Enable>

Mode d'authentification CISCO XML EXE

Valeur par défaut : Informations d’authentification locales

Options : Fiable, Informations d'identification locales, Informations d'identification distantes

Spécifie le mode d'authentification pour Cisco XML EXE.

  • Approuvé : aucune authentification n'est effectuée, indépendamment des informations d'authentification locales.

  • Informations d'authentification locales : l'authentification est basée sur un résumé d'authentification à l'aide des informations d'authentification locales, si elles sont définies. Si elles ne sont pas définies, alors aucune authentification n'est effectuée.

  • Informations d'authentification à distance : l'authentification est basée sur le résumé d'authentification à l'aide des informations d'authentification distantes telles que définies par l'application XML sur la page Web (pour accéder à un 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 :

<CISCO_XML_EXE_Auth_Mode ua="na">Informations d'identification locales</CISCO_XML_EXE_Auth_Mode>

Ajout d'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éder à la page Web d'administration du téléphone.

2

Sélectionnez Voix > Téléphone.

3

Dans la section Touches de fonction programmable, définissez Activer la touche de fonction programmable à Oui.

Vous pouvez également configurer ce paramètre dans le fichier de configuration (cfg.xml). Saisissez une chaîne au format suivant :

<Programmable_Softkey_Enable ua="na">Oui</Programmable_Softkey_Enable>
4

Dans la section Programmable Softkeys , modifiez les champs disponibles de PSK1 à PSK16 au format suivant :

fnc=xml ;url=<xml_app_path> ; nme=<app_name>

où url est le lien où l'application XML est stockée ; NME est le nom d'affichage de l'application sur l'écran du téléphone.

Exemple fnc=xml ;url=http://10.77.21.37/xmlapp/menu.xml;nme=Menu

Vous pouvez également configurer ce paramètre dans le fichier de configuration (cfg.xml). Saisissez une chaîne au format suivant :

<PSK_n ua="na">fnc=xml ;url=http://10.77.21.37/xmlapp/menu.xml;nme=Menu<code de configuration></PSK_n>

où n est le numéro de la touche programmable.

5

Cliquez sur Enregistrer toutes les modifications.

Ajout d'une application XML à une touche de ligne

Ajoutez les applications 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éder à la page Web d'administration du téléphone.

2

Sélectionnez Voix > Téléphone.

3

Sélectionnez une touche de ligne.

4

Définissez le paramètre Extension sur Disabled (Désactivé) pour désactiver le numéro d'extension.

Si la fonctionnalité Direct PLK Configuration est désactivée, vous devez désactiver l'extension pour ajouter une fonctionnalité étendue à la touche de ligne. Si la fonctionnalité est activée, vous pouvez ignorer cette étape. Pour plus d'informations, reportez-vous à la section Activer la configuration PLK directe.
5

Dans le paramètre fonctionnalité étendue, saisissez une chaîne de caractères au format suivant :

fnc=xml ;url=<xml_app_path> ; nme=<app_name>

où url est le lien où l'application XML est stockée ; NME est le nom d'affichage de l'application sur l'écran du téléphone.

Exemple  : fnc=xml ;url=http://10.77.21.37/xmlapp/menu.xml;nme=Menu

Vous pouvez également configurer ce paramètre dans le fichier de configuration (cfg.xml). Saisissez une chaîne au format suivant :

<Extended_Function_n_ ua="na">fnc=xml ;url=http://10.77.21.37/xmlapp/menu.xml;nme=Menu<code de configuration></Extended_Function_n_>

Où n correspond au numéro de poste.

6

Cliquez sur Enregistrer toutes les modifications.

Variables de macro prises en charge dans les URL de XML

Vous pouvez utiliser les variables macro dans les URL XML. Les variables 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

Tableau 2. Macros prises en charge
Nom de la macroExtension macro
$La forme $$ évolue en un seul caractère $.
A à PRemplacés par les paramètres généraux GPP_A à GPP_P.
SA à SDRemplacé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 lors de la mise à disposition.
Les paramètres $SA à $SD sont reconnus comme des arguments pour l'identificateur d'URL de resynchronisation facultatif --key.
MAAdresse MAC utilisant des chiffres hexadécimaux en minuscules (000e08aabbcc).
MAUAdresse MAC utilisant des chiffres hexadécimaux en majuscules (000E08AABBCC).
MACAdresse MAC utilisant des chiffres hexadécimaux en minuscules comportant une virgule pour séparer les paires de chiffres hexadécimaux (00:0e:08:aa:bb:cc).
PNNom du produit ; par exemple, Téléphone vidéo 8875, Téléphone de bureau 9851.
PSNNuméro de la série de produits ; par exemple, 8875, 9841, 9861
NSChaîne de numéro de série ; par exemple, 88012BA01234.
CCERTÉtat du certificat Client SSL, installé ou non.
IPAdresse IP du téléphone au sein de son sous-réseau local ; par exemple 192.168.1.100.
EXTIPAdresse 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

HWVER

Chaîne de version du matériel. Par exemple, 2.0.1

PRVST

État de mise à disposition (une chaîne numérique) :

-1 = requête de resynchronisation explicite

0 = resynchronisation de démarrage

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 ligne 1 a perdu l'enregistrement sur le serveur SIP.

REGTMR2

Secondes depuis que ligne 2 a perdu l'enregistrement sur le serveur SIP.

UPGCOND

Nom de la macro existante.

SCHEME

Schéma d'accès au fichier, un parmi TFTP, HTTP ou HTTPS, comme obtenu après l'analyse de l'URL de mise à niveau ou de resynchronisation.

SERV

Demander le nom d'hôte du serveur cible, extrait après l'analyse de l'URL de resynchronisation ou de mise à niveau.

SERVIP

Demander l'adresse IP du serveur cible, extrait après l'analyse de l'URL de resynchronisation ou de mise à niveau, éventuellement suite à la recherche DNS.

PORT

Demander le port UDP/TCP cible, extrait après l'analyse de l'URL de resynchronisation ou de mise à niveau.

PATH

Demander le chemin du fichier cible, extrait après l'analyse de l'URL de resynchronisation ou de mise à niveau.

ERR

Message de résultats de la tentative de resynchronisation ou de mise à niveau. Utile uniquement pour générer les messages syslog de résultat. La valeur est conservée dans la variable UPGERR dans le cas des tentatives de mise à niveau.

UIDn

Le contenu du paramètre de configuration de l'ID utilisateur de la ligne n.

ISCUST

Si l'unité est personnalisée, la valeur est égale à 1, sinon à 0.

L'état de la personnalisation est visible dans la page Informations de l'interface utilisateur Web.

INCOMINGNAMENom associé au premier appel entrant, connecté ou qui sonne.
REMOTENUMBER

Numéro de téléphone du premier appel entrant, connecté ou qui sonne. S'il y a plusieurs appels, les données associées au premier appel trouvé seront fournies.

DISPLAYNAMEnLe contenu du paramètre de configuration du nom d'affichage de la ligne n.
AUTHIDnLe contenu du paramètre de configuration de l’ID d’authentification de la ligne n.