- Startseite
- /
- Artikel
XML Anwendungskonfiguration für Telefone auf BroadWorks
Dieser Hilfeartikel bezieht sich auf die Cisco Desk Phone 9800-Serie und das Cisco Video Phone 8875, die bei Cisco BroadWorks registriert sind. In diesem Artikel finden Sie Informationen zu den unterstützten XML-Objekten und URIs sowie zu den Schritten zum Konfigurieren der XSI-Dienste auf der Telefon-Webseite.
Ü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
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 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 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.
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 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:
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 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:
|
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-Authentifizierungsmodus |
Standard: Lokale Anmeldeinformationen Optionen: Vertrauenswürdig, Lokale Anmeldeinformationen, Remote-Anmeldeinformationen |
Gibt den Authentifizierungsmodus für Cisco XML EXE an.
Sie können diesen Parameter ebenfalls in der XML-Konfigurationsdatei (cfg.xml) des Telefons konfigurieren, indem Sie eine Zeichenfolge in folgendem Format eingeben:
|
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 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:
|
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
Beispiel Sie können diesen Parameter auch in der Konfigurationsdatei (cfg.xml) konfigurieren. Geben Sie eine Zeichenfolge in folgendem Format ein:
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 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
Beispiel Sie können diesen Parameter auch in der Konfigurationsdatei (cfg.xml) konfigurieren. Geben Sie eine Zeichenfolge in folgendem Format ein:
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
Name des Makros | Makroerweiterung |
---|---|
$ | $$ wird auf ein einzelnes $-Zeichen erweitert. |
A bis P | Durch allgemeine Parameter GPP_A bis GPP_P ersetzt. |
SA bis SD | Durch 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. |
MA | MAC-Adresse mit Hexadezimalzeichen in Kleinbuchstaben (000e08aabbcc). |
MAU | MAC-Adresse mit Hexadezimalzeichen in Großbuchstaben (000E08AABBCC). |
MAC | MAC-Adresse mit Hexadezimalzeichen in Kleinbuchstaben und Doppelpunkt, um die Hexadezimalzeichenpaare zu trennen (00:0e:08:aa:bb:cc). |
PN | Produktname; Beispielsweise Videotelefon 8875, Tischtelefon 9851. |
PSN | Produktseriennummer; Beispiel: 8875, 9841, 9861 |
SN | Zeichenfolge der Seriennummer. Beispiel: 88012BA01234. |
CCERT | SSL-Clientzertifikatstatus, installiert oder nicht installiert. |
IP | IP-Adresse des Telefons innerhalb des lokalen Subnetzes, beispielsweise 192.168.1.100. |
EXTIP | Externe 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. |
INCOMINGNAME | Name, 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. |
DISPLAYNAMEn | Der Inhalt des Anzeigenamen-Konfigurationsparameters für Leitung N. |
AUTHIDn | Der Inhalt des Auth.-ID-Konfigurationsparameters für Leitung N. |