- 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 für Cisco BroadWorks registriert sind. In diesem Artikel finden Sie die unterstützten XML-Objekte, URIs und die Schritte zum Konfigurieren der XSI-Dienste auf der Telefon-Webseite.
Ü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
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 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 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.
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:
|
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:
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-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:
|
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-Authentifizierungsmodus |
Standard: Lokale Anmeldeinformationen Optionen: Vertrauenswürdige, lokale Anmeldeinformationen, Remote-Anmeldeinformationen |
Gibt den Authentifizierungsmodus für Cisco XML EXE an.
Sie können diesen Parameter auch in der XML-Konfigurationsdatei (cfg.xml) des Telefons konfigurieren, indem Sie eine Zeichenfolge in folgendem Format eingeben:
|
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 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:
|
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
Sie können diesen Parameter auch in der Konfigurationsdatei (cfg.xml) konfigurieren. Geben Sie eine Zeichenfolge in folgendem Format ein:
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 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
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 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
Name des Makros | Makroerweiterung |
---|---|
$ | Das Formular $$ wird auf ein einzelnes $-Zeichen erweitert. |
A bis P | Ersetzt durch allgemeine Parameter GPP_A bis GPP_P. |
SA bis SD | Ersetzt 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. |
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; beispielsweise 8875, 9841, 9861 |
sn | Zeichenfolge für die Seriennummer; beispielsweise 88012BA01234. |
CCERT | Status des SSL-Clientzertifikats, 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. |
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 Eintrags | Name, 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 n | Der Inhalt des Anzeigenamen-Konfigurationsparameters für Leitung N. |
AUTHENTIFIZIERUNGS-ID | Der Inhalt des Auth-ID-Konfigurationsparameters für Leitung N. |