Übersicht

XML XSI (Services Interface) ist ein Protokoll, das die Kommunikation zwischen Anwendungen und dem Telefonsystem ermöglicht. Mithilfe der unterstützten XML Objekte und URIs können Sie Ihrem Telefon Ihre eigenen XSI-Services hinzufügen.

Nach dem Abonnieren der Dienste auf dem Telefon können Benutzer auf alle auf dem Telefon konfigurierten Dienste zugreifen, indem sie zu Einstellungen > Netzwerk und Dienst > Cisco XML Dienste navigieren. Cisco XML Services ist der Standardname. Sie können auch den Namen ändern. Um den Benutzern den Zugriff zu erleichtern, können Sie die XML Anwendungen zu Softkeys oder Leitungstasten hinzufügen.

Folgende Funktionen werden unterstützt:

  • Nachrichten (Bilder und Text)
  • Paging

Unterstützte XML Objekte

  • CiscoIPPhoneMenu

  • CiscoIPPhoneText

  • CiscoIPPhoneInput

  • CiscoIPPhoneDirectory

  • CiscoIPPhoneImage

  • CiscoIPPhoneImageFile

  • CiscoIPPhoneIconMenu

  • CiscoIPPhoneIconFileMenu

  • CiscoIPPhoneStatus (außer 9841)

  • CiscoIPPhoneStatusFile (außer 9841)

  • CiscoIPPhoneExecute

Unterstützte URIs

  • Gerät

  • Wählscheibe

  • EditDail

  • Init.

  • Schlüssel

  • Wiedergabe (nur Klingeltöne)

  • Softkey

Weitere Informationen zur Konfiguration des XSI-Dienstes finden Sie unter Cisco Unified IP Phone Hinweise zur Anwendungsentwicklung für Dienste.

Telefon für die Verbindung mit einem XML-Dienst konfigurieren

1

Greifen Sie auf die Webseite zur Telefonverwaltung zu.

2

Wählen Sie Sprache > Telefon aus.

3

Konfigurieren Sie im Abschnitt XML Service die Parameter XML Anwendungsdienstnamen und XML Anwendungsdienst-URL , wie unter Parameter für XML Services definiert.

4

(Optional) Um die Authentifizierung für den Zugriff auf den Anwendungsdienst hinzuzufügen, konfigurieren Sie die folgenden Felder: XML Benutzername XML Kennwort, CISCO XML EXE aktivieren undCISCO XML EXE Auth Mode.

5

Klicken Sie auf Alle Änderungen speichern.

Parameter für XML Services

In der folgenden Tabelle werden die Funktion und die Verwendung der XML Anwendungsparameter im Abschnitt XML Dienst auf der Registerkarte > Telefon auf der Telefon-Webschnittstelle definiert. Außerdem wird die Syntax der Zeichenfolge definiert, die in der Telefon-Konfigurationsdatei mit dem XML-Code (cfg.xml) hinzugefügt wird, um einen Parameter zu konfigurieren.

Tabelle 1. Parameter für XML Services

Parameter

Standard und Optionen

Beschreibung

XML Application Service Name (Name des XML-Anwendungsservices)

Standard: leer

Name der XML-Anwendung. Dieser Name wird auf dem Telefon als Web-Anwendung-Auswahl angezeigt.

Sie können diesen Parameter ebenfalls in der XML-Konfigurationsdatei (cfg.xml) des Telefons konfigurieren, indem Sie eine Zeichenfolge in folgendem Format eingeben:

<XML_Application_Service_Name ua="na">XML APP-Name</XML_Application_Service_Name>

XML Application Service URL (URL des XML-Anwendungsservices)

Standard: leer

Die URL, unter der sich die XML-Anwendung befindet.

Sie können diesen Parameter ebenfalls in der XML-Konfigurationsdatei (cfg.xml) des Telefons konfigurieren, indem Sie eine Zeichenfolge in folgendem Format eingeben:

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

Makrovariablen werden in XML-URLs unterstützt. Informationen zu den gültigen Makrovariablen finden Sie unter In XML URLs unterstützte Makrovariablen.

In der URL werden nur HTTP- oder HTTPS-Protokolle unterstützt.

XML User Name (XML-Benutzername)

Standard: leer

Benutzername für den XML-Dienst zum Zwecke der Authentifizierung.

Sie können diesen Parameter ebenfalls in der XML-Konfigurationsdatei (cfg.xml) des Telefons konfigurieren, indem Sie eine Zeichenfolge in folgendem Format eingeben:

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

XML Password (XML-Kennwort)

Standard: leer

XML-Dienstkennwort für den angegebenen XML-Benutzernamen.

Das von Ihnen in dieses Feld eingegebene Kennwort wird in der Konfigurationsdatei (cfg.xml) wie folgt angezeigt:

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

CISCO XML-EXE aktivieren

Standard: Nein

Optionen: Ja, Nein

Gibt an, ob für den Zugriff auf den XML-Anwendungsserver eine Authentifizierung erforderlich ist.

Sie können diesen Parameter ebenfalls in der XML-Konfigurationsdatei (cfg.xml) des Telefons konfigurieren, indem Sie eine Zeichenfolge in folgendem Format eingeben:

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

CISCO XML-EXE-Authentifizierungsmodus

Standard: Lokale Anmeldeinformationen

Optionen: Vertrauenswürdig, Lokale Anmeldeinformationen, Remote-Anmeldeinformationen

Gibt den Authentifizierungsmodus für Cisco XML EXE an.

  • Vertrauenswürdig – es wird keine Authentifizierung unabhängig von den lokalen Anmeldeinformationen durchgeführt.

  • Lokale Anmeldeinformationen: Falls festgelegt, basiert die Authentifizierung auf der Digest-Authentifizierung unter Verwendung der lokalen Anmeldeinformationen. Falls die lokalen Anmeldeinformationen nicht festgelegt sind, wird keine Authentifizierung durchgeführt.

  • Lokale Anmeldeinformationen: Die Authentifizierung basiert auf der Digest-Authentifizierung unter Verwendung der Remote-Anmeldeinformationen, die in der XML-Anwendung auf der Webseite festgelegt ist (um auf einen XML-Anwendungsserver zuzugreifen).

Sie können diesen Parameter ebenfalls in der XML-Konfigurationsdatei (cfg.xml) des Telefons konfigurieren, indem Sie eine Zeichenfolge in folgendem Format eingeben:

<CISCO_XML_EXE_Auth_Mode ua="na">Lokale Anmeldeinformationen</CISCO_XML_EXE_Auth_Mode>

Hinzufügen einer XML Anwendung zu einem Softkey

Fügen Sie die häufig verwendeten Anwendungen zu Softkeys hinzu, damit Benutzer einfach auf den Dienst zugreifen können.

Bevor Sie beginnen:

Der XML Anwendungsservice wurde ordnungsgemäß konfiguriert.

1

Greifen Sie auf die Webseite zur Telefonverwaltung zu.

2

Wählen Sie Sprache > Telefon aus.

3

Legen Sie im Abschnitt Programmierbare Softkeys die Option Programmierbaren Softkey aktivieren auf Ja fest.

Sie können diesen Parameter auch in der Konfigurationsdatei (cfg.xml) konfigurieren. Geben Sie eine Zeichenfolge in folgendem Format ein:

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

Bearbeiten Sie im Bereich Programmierbare Softkeys die verfügbaren Felder von PSK1 bis PSK16 in folgendem Format:

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

wobei URL der Link ist, über den die XML Anwendung gespeichert wird. NME ist der Anzeigename der Anwendung auf dem Telefondisplay.

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

Sie können diesen Parameter auch in der Konfigurationsdatei (cfg.xml) konfigurieren. Geben Sie eine Zeichenfolge in folgendem Format ein:

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

Dabei ist n die Softkey-Nummer.

5

Klicken Sie auf Alle Änderungen speichern.

Hinzufügen einer XML-Anwendung zu einer Leitungstaste

Fügen Sie die häufig verwendeten Anwendungen zu Leitungstasten hinzu, damit Benutzer einfach auf die Dienste zugreifen können.

Bevor Sie beginnen:

Der XML Anwendungsservice wurde ordnungsgemäß konfiguriert.

1

Greifen Sie auf die Webseite zur Telefonverwaltung zu.

2

Wählen Sie Sprache > Telefon aus.

3

Wählen Sie eine Leitungstaste aus.

4

Legen Sie den Parameter Durchwahl auf Deaktiviert fest, um die Durchwahl zu deaktivieren.

Wenn die Funktion für die direkte PLK-Konfiguration deaktiviert ist, müssen Sie die Durchwahl deaktivieren, um der Leitungstaste eine erweiterte Funktion hinzuzufügen. Wenn die Funktion aktiviert ist, können Sie diesen Schritt überspringen. Weitere Informationen finden Sie unter Aktivieren der direkten PLK-Konfiguration.
5

Geben Sie im Parameter Erweiterte Funktion eine Zeichenfolge in folgendem Format ein:

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

wobei URL der Link ist, über den die XML Anwendung gespeichert wird. NME ist der Anzeigename der Anwendung auf dem Telefondisplay.

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

Sie können diesen Parameter auch in der Konfigurationsdatei (cfg.xml) konfigurieren. Geben Sie eine Zeichenfolge in folgendem Format ein:

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

wobei n die Durchwahlnummer ist.

6

Klicken Sie auf Alle Änderungen speichern.

In XML URLs unterstützte Makrovariablen

Sie können Makro-Variablen in XML-URLs verwenden. Die folgenden Makro-Variablen werden unterstützt:

  • Benutzer-ID: UID1, UID2 bis UIDn

  • Anzeigename: DISPLAYNAME1, DISPLAYNAME2 bis DISPLAYNAMEn

  • Auth.-ID: AUTHID1, AUTHID2 bis AUTHIDn

  • Proxy: PROXY1, PROXY2 bis PROXYn

  • MAC-Adresse mit Hexadezimalzeichen in Kleinbuchstaben: MA

  • Produktname: PN

  • Produktseriennummer: PSN

  • Seriennummer: SERIAL_NUMBER

Tabelle 2. Unterstützte Makros
Name des MakrosMakroerweiterung
$$$ wird auf ein einzelnes $-Zeichen erweitert.
A bis PDurch allgemeine Parameter GPP_A bis GPP_P ersetzt.
SA bis SDDurch spezielle Parameter GPP_SA bis GPP_SD ersetzt. Diese Parameter enthalten Schlüssel oder Kennwörter, die in der Bereitstellung verwendet werden.
$SA bis $SD werden als Argumente für den optionalen URL-Qualifizierer der Resynchronisierung erkannt, --Schlüssel.
MAMAC-Adresse mit Hexadezimalzeichen in Kleinbuchstaben (000e08aabbcc).
MAUMAC-Adresse mit Hexadezimalzeichen in Großbuchstaben (000E08AABBCC).
MACMAC-Adresse mit Hexadezimalzeichen in Kleinbuchstaben und Doppelpunkt, um die Hexadezimalzeichenpaare zu trennen (00:0e:08:aa:bb:cc).
PNProduktname; Beispielsweise Videotelefon 8875, Tischtelefon 9851.
PSNProduktseriennummer; Beispiel: 8875, 9841, 9861
SNZeichenfolge der Seriennummer. Beispiel: 88012BA01234.
CCERTSSL-Clientzertifikatstatus, installiert oder nicht installiert.
IPIP-Adresse des Telefons innerhalb des lokalen Subnetzes, beispielsweise 192.168.1.100.
EXTIPExterne IP-Adresse des Telefons, wie sie im Internet angezeigt wird, beispielsweise 66.43.16.52.

SWVER

Zeichenfolge der Software-Version, Beispiel:

PHONEOS.3-2-1-0104-37

HWVER

Zeichenfolge der Hardware-Version. Beispiel: 2.0.1.

PRVST

Bereitstellungsstatus (numerische Zeichenfolge):

-1 = explizite Anforderung für Resynchronisierung

0 = Resynchronisierung durchführen

1 = regelmäßige Resynchronisierung

2 = Resynchronisierung fehlgeschlagen, Neuversuch

UPGST

Upgrade-Status (numerische Zeichenfolge):

1 = erster Upgrade-Versuch

2 = Upgrade fehlgeschlagen, Neuversuch

UPGERR

Ergebnisnachricht (ERR) des vorherigen Upgrade-Versuchs; beispielsweise „http_get failed“.

PRVTMR

Sekunden seit dem letzten Resynchronisierungsversuch.

UPGTMR

Sekunden seit dem letzten Upgrade-Versuch.

REGTMR1

Sekunden, die vergangen sind, seitdem die Registrierung von Leitung 1 beim SIP-Server verloren ging.

REGTMR2

Sekunden, die vergangen sind, seitdem die Registrierung von Leitung 2 beim SIP-Server verloren ging.

UPGCOND

Name des älteren Makros.

SCHEME

Dateizugriffsschema (entweder TFTP, HTTP oder HTTPS, ermittelt nach der Analyse der URL für die Resynchronisierung oder das Upgrade).

SERV

Host-Name des Anforderungszielservers, ermittelt nach der Analyse der URL für die Resynchronisierung oder das Upgrade.

SERVIP

IP-Adresse des Anforderungszielservers, ermittelt nach der Analyse der URL für die Resynchronisierung oder das Upgrade, möglicherweise nach der DNS-Suche.

Port

UDP-/TCP-Port des Anforderungsziels, ermittelt nach der Analyse der URL für die Resynchronisierung oder das Upgrade.

PATH

Dateipfad des Anforderungsziels, ermittelt nach der Analyse der URL für die Resynchronisierung oder das Upgrade.

ERR

Ergebnisnachricht bei Versuch der Resynchronisierung oder eines Upgrades. Nur bei der Generierung von Ergebnis-syslog-Nachrichten hilfreich. Der Wert wird im Falle von Upgrade-Versuchen in der Variablen UPGERR beibehalten.

UIDn

Der Wert des Benutzer-ID-Konfigurationsparameters für Leitung n

ISCUST

Wert = 1, wenn die Einheit personalisiert wird, andernfalls 0.

Der Anpassungsstatus kann auf der Infoseite der Webbenutzeroberfläche angezeigt werden.

INCOMINGNAMEName, der dem ersten verbundenen, klingelnden oder eingehenden Anruf zugeordnet ist.
REMOTENUMBER

Telefonnummer des ersten verbundenen, klingelnden oder eingehenden Anrufs. Wenn mehrere Anrufe vorhanden sind, werden die dem ersten gefundenen Anruf zugeordneten Daten bereitgestellt.

DISPLAYNAMEnDer Inhalt des Anzeigenamen-Konfigurationsparameters für Leitung N.
AUTHIDnDer Inhalt des Auth.-ID-Konfigurationsparameters für Leitung N.