Übersicht

XSI (Xml Services Interface) ist ein Protokoll, das die Kommunikation zwischen Anwendungen und dem Telefonsystem ermöglicht. Mit den unterstützten XML-Objekten und URIs können Sie Ihrem Telefon eigene XSI-Dienste hinzufügen.

Nachdem Sie das Telefon für die Dienste abonniert haben, können die Benutzer auf alle konfigurierten Dienste auf dem Telefon zugreifen, indem sie zu Einstellungen > Netzwerk und Dienst > Cisco XML-Dienste navigieren. Der Standardname ist die Cisco XML-Dienste. Sie können den Namen auch ändern. Um den Benutzern einen einfachen Zugriff zu ermöglichen, können Sie die XML-Anwendungen zu Softkeys oder Leitungstasten hinzufügen.

Die unterstützten Funktionen sind:

  • Nachrichten (Bilder und Text)
  • Paging

Unterstützte XML-Objekte

  • Cisco IP-Telefon-Menü

  • Cisco IP-Telefon-Text

  • Cisco IP-Telefon-Eingabe

  • Cisco IP-Telefon-Verzeichnis

  • Cisco IP-Telefon-Image

  • CiscoIP-TelefonImageFile

  • CiscoIP-TelefonIconMenu

  • Menü „CiscoIP PhoneIconFileMenu“

  • CiscoIP-Telefon-Status (außer 9841)

  • CiscoIPPhoneStatusFile (außer 9841)

  • Cisco IP-Telefon ausführen

Unterstützte URIs

  • Gerät

  • Einwahl

  • Bearbeiten

  • Init

  • Schlüssel

  • Wiedergabe (nur Klingeltöne)

  • Softkey

Weitere Informationen zur XSI-Dienstkonfiguration finden Sie unter Cisco Unified IP-Telefon-Services – Anwendungsentwicklungsdokumentation.

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-Dienst die Parameter XML-Anwendungsdienstname und XML-Anwendungsdienst-URL wie unter Parameter für XML-Dienste definiert.

4

(Optional) Um die Authentifizierung für den Zugriff auf den Anwendungsdienst hinzuzufügen, konfigurieren Sie diese Felder: XML-Benutzername, XML-Passwort, CISCO XML EXE Enable und CISCO XML EXE-Authentifizierungsmodus.

5

Klicken Sie auf Alle Änderungen speichern.

Parameter für XML-Dienste

In der folgenden Tabelle werden die Funktionen und die Verwendung der XML-Anwendungsparameter im Abschnitt XML-Dienst unter der Registerkarte Sprache > Telefon auf der Telefon-Weboberfläche definiert. Außerdem wird die Syntax der Zeichenfolge definiert, die in der Telefonkonfigurationsdatei (cfg.xml) mit XML-Code hinzugefügt wird, um einen Parameter zu konfigurieren.

Tabelle 1: Parameter für XML-Dienste

Parameter

Standard und Optionen

Beschreibung

Name des XML-Anwendungsdienstes

Standard: Leer

Name der XML-Anwendung. Der Name wird auf dem Telefon als gewählte Webanwendung angezeigt.

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

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

URL für XML-Anwendungsdienst

Standard: Leer

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

Sie können diesen Parameter auch 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. Die gültigen Makrovariablen finden Sie unter In XML-URLs unterstützte Makrovariablen.

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

XML-Benutzername

Standard: Leer

Benutzername für den XML-Dienst für die Authentifizierung.

Sie können diesen Parameter auch 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-Passwort

Standard: Leer

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

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

<!-- <XML_Password ua="na">lt;/;*************&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 auch 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ürdige, lokale Anmeldeinformationen, Remote-Anmeldeinformationen

Gibt den Authentifizierungsmodus für Cisco XML EXE an.

  • Vertrauenswürdig: Unabhängig von den lokalen Anmeldeinformationen wird keine Authentifizierung durchgeführt.

  • Lokale Anmeldeinformationen: Die Authentifizierung basiert auf der Digest-Authentifizierung unter Verwendung der lokalen Anmeldeinformationen, falls festgelegt. Wenn keine lokalen Anmeldeinformationen festgelegt sind, wird keine Authentifizierung durchgeführt.

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

Sie können diesen Parameter auch 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 Anmeldedaten</CISCO_XML_EXE_Auth_Mode>

Eine XML-Anwendung zu einem Softkey hinzufügen

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

Vorbereitungen

Der XML-Anwendungsdienst 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 den Wert Programmierbarer 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 Abschnitt Programmierbare Softkeys die verfügbaren Felder von PSK1 bis PSK16 in diesem Format:

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

wobei url der Link ist, unter dem die XML-Anwendung gespeichert wird; nme ist der Anzeigename der Anwendung auf dem Telefonbildschirm.

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=Menü<Konfigurationscode></PSK_n>

wobei n die Softkey-Nummer ist.

5

Klicken Sie auf Alle Änderungen speichern.

Füge eine XML-Anwendung zu einer Leitungstaste hinzu

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

Vorbereitungen

Der XML-Anwendungsdienst 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 „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 Direkte PLK-Konfiguration aktivieren.
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, unter dem die XML-Anwendung gespeichert wird; nme ist der Anzeigename der Anwendung auf dem Telefonbildschirm.

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=Menü<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 Makrovariablen in XML-URLs verwenden. Die folgenden Makrovariablen 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
$Das Formular $$ wird auf ein einzelnes $-Zeichen erweitert.
A bis PErsetzt durch allgemeine Parameter GPP_A bis GPP_P.
SA bis SDErsetzt durch spezielle Parameter GPP_SA bis GPP_SD. 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 für die 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; beispielsweise 8875, 9841, 9861
snZeichenfolge für die Seriennummer; beispielsweise 88012BA01234.
CCERTStatus des SSL-Clientzertifikats, 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.

schwingen

Zeichenfolge der Softwareversion. Zum Beispiel:

Telefone.3-2-1-0104-37

hwver

Zeichenfolge der Hardware-Version. Beispiel: 2.0.1

prvst

Bereitstellungsstatus (numerische Zeichenfolge):

-1 = explizite Anfrage zur erneuten Synchronisierung

0 = Resynchronisierung einschalten

1 = regelmäßige Neusynchronisierung

2 = Resynchronisierung fehlgeschlagen, Wiederholungsversuch

upgst

Upgrade-Status (numerische Zeichenfolge):

1 = erster Upgrade-Versuch

2 = Upgrade fehlgeschlagen, Wiederholungsversuch

aktualisieren

Ergebnisnachricht (ERR) des vorherigen Upgrade-Versuchs; z. B. http_get failed.

prvtmr

Sekunden seit dem letzten Resynchronisierungsversuch.

UPGTMR

Sekunden seit dem letzten Upgrade-Versuch.

RegelMR1

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

regtmr2

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

upgcond

Name des älteren Makros.

Schema

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

Serv

Hostname 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.

Pfad

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

Fehler

Ergebnismeldung des Resynchronisierungs- oder Upgrade-Versuchs. Nur nützlich beim Generieren von Ergebnis-Syslog-Meldungen. Der Wert wird bei Upgrade-Versuchen in der UPGERR-Variablen beibehalten.

UID

Der Inhalt des Benutzer-ID-Konfigurationsparameters für Leitung n.

Iscust

Wenn die Einheit angepasst ist, ist der Wert = 1, andernfalls 0.

Der Personalisierungsstatus ist auf der Informationsseite der Webbenutzeroberfläche sichtbar.

Name des EintragsName, der dem ersten verbundenen, klingelnden oder eingehenden Anruf zugeordnet ist.
Remotenummer

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

ANZEIGENAME nDer Inhalt des Anzeigenamen-Konfigurationsparameters für Leitung N.
AUTHENTIFIZIERUNGS-IDDer Inhalt des Auth-ID-Konfigurationsparameters für Leitung N.