- Strona główna
- /
- Artykuł
XML dla telefonów w systemie BroadWorks
Ten artykuł Pomocy dotyczy telefonów Cisco Desk Phone z serii 9800 i Cisco Video Phone 8875 zarejestrowanych w programie Cisco BroadWorks. W tym artykule przedstawiono obsługiwane obiekty XML, identyfikatory URI oraz procedurę konfigurowania usług XSI na stronie WWW telefonu.
Omówienie
XML Services Interface (XSI) to protokół umożliwiający komunikację między aplikacjami a systemem telefonicznym. Do telefonu można dodawać własne usługi XSI, korzystając z obsługiwanych obiektów XML i identyfikatorów URI.
Po zasubskrybowaniu usług w telefonie użytkownicy mogą uzyskać dostęp do wszystkich skonfigurowanych usług w telefonie, przechodząc do
. Usługi XML Cisco to nazwa domyślna. Możesz także zmienić nazwę. Aby zapewnić użytkownikom łatwy dostęp, można dodać XML aplikacje do programowych lub linii.Obsługiwane funkcje to:
- Wiadomości (obrazy i tekst)
- Poszukiwanie
Obsługiwane obiekty XML
-
CiscoIPPhoneMenu
-
CiscoIPPhoneText
-
CiscoIPPhoneInput
-
CiscoIPPhoneDirectory
-
CiscoIPPhoneImage
-
CiscoIPPhoneImageFile
-
CiscoIPPhoneIconMenu
-
CiscoIPPhoneIconFileMenu
-
CiscoIPPhoneStatus (oprócz 9841)
-
CiscoIPPhoneStatusFile (oprócz 9841)
-
CiscoIPPhoneExecute
Obsługiwane identyfikatory URI
-
Urządzenie
-
Wykręcić
-
EditDail
-
Init
-
Klucz
-
Odtwórz (tylko dzwonki)
-
Klawisz programowy
Aby uzyskać więcej informacji na temat konfiguracji usługi XSI, zobacz Cisco Unified IP Phone Services Application Development Notes.
Konfigurowanie telefonu do łączenia się z usługą XML
1 |
Przejdź do strony WWW administrowania telefonem. |
2 |
Wybierz kolejno opcje . |
3 |
W sekcji XML Usługa skonfiguruj parametry XML Nazwa usługi aplikacji i XML Adres URL usługi aplikacji zgodnie z definicją w sekcji Parametry dla usług XML. |
4 |
(Opcjonalnie) Aby dodać uwierzytelnianie w celu uzyskania dostępu do usługi aplikacji, skonfiguruj te pola: XML Nazwa użytkownika, Hasło XML, CISCO XML EXE Enable i CISCO XML EXE Auth Mode. |
5 |
Kliknij przycisk Zapisz wszystkie zmiany. |
Parametry usług XML
W poniższej tabeli opisano funkcje i wykorzystanie parametrów aplikacji XML w sekcji Usługa XML na karcie Telefon głosowy w interfejsie sieciowym telefonu. Definiuje również składnię ciągu dodanego do pliku konfiguracyjnego w formacie XML (cfg.xml) w celu skonfigurowania parametru.
Parametr |
Wartości domyślne i opcje |
Opis |
---|---|---|
Nazwa aplikacji usługowej XML |
Wartość domyślna: puste |
Nazwa aplikacji XML. Nazwa jest wyświetlana w telefonie użytkownika jako aplikacja internetowej do wyboru. Ten parametr można także skonfigurować w pliku konfiguracyjnym (cfg.xml), wprowadzając odpowiedni ciąg w następującym formacie:
|
Adres URL aplikacji usługowej XML |
Wartość domyślna: puste |
Adres URL, pod którym jest umieszczona aplikacja XML. Ten parametr można także skonfigurować w pliku konfiguracyjnym (cfg.xml), wprowadzając odpowiedni ciąg w następującym formacie:
W przypadku adresów URL XML obsługiwane są zmienne makr. Aby zapoznać się z prawidłowymi zmiennymi makr, zobacz Zmienne makr obsługiwane w XML adresach URL. W adresie URL obsługiwane są tylko protokoły HTTP lub HTTP. |
Nazwa użytkownika usługi XML |
Wartość domyślna: puste |
Nazwa użytkownika usługi XML wykorzystywana na potrzeby uwierzytelniania. Ten parametr można także skonfigurować w pliku konfiguracyjnym (cfg.xml), wprowadzając odpowiedni ciąg w następującym formacie:
|
Hasło usługi XML |
Wartość domyślna: puste |
Hasło usługi XML dla określonej nazwy użytkownika XML. Hasło wprowadzone w tym polu jest wyświetlane w pliku konfiguracyjnym (cfg.xml) w następujący sposób:
|
Włącz Cisco XML EXE |
Domyślne: Nie Dostępne opcje: Tak, Nie |
Określa, czy w celu uzyskania dostępu do serwera aplikacji XML wymagane jest uwierzytelnianie. Ten parametr można także skonfigurować w pliku konfiguracyjnym (cfg.xml), wprowadzając odpowiedni ciąg w następującym formacie:
|
Tryb uwierzytelniania Cisco EXE XML |
Wartość domyślna: Lokalne poświadczenie Opcje: Zaufane, Poświadczenia lokalne, Poświadczenia zdalne |
Określa tryb uwierzytelniania Cisco XML EXE.
Ten parametr można także skonfigurować w pliku konfiguracyjnym (cfg.xml), wprowadzając odpowiedni ciąg w następującym formacie:
|
Dodawanie aplikacji XML do programowego
Dodaj często używane aplikacje do programowych, aby użytkownicy mogli łatwo uzyskać dostęp do usługi.
Zanim rozpoczniesz
Usługa aplikacji XML została poprawnie skonfigurowana.
1 |
Przejdź do strony WWW administrowania telefonem. |
2 |
Wybierz kolejno opcje . |
3 |
W sekcji Programowalne klawisze programowe w polu Włącz programowalne klawisze programowe ustaw wartość Tak. Możesz również skonfigurować ten parametr w pliku konfiguracyjnym (cfg.xml). Wprowadź ciąg w następującym formacie:
|
4 |
W sekcji Programowalne programowe edytuj dostępne pola od PSK1 do PSK16 w następującym formacie: fnc=xml;url=<xml_app_path>; nme=<app_name>
gdzie
Przykład: Możesz również skonfigurować ten parametr w pliku konfiguracyjnym (cfg.xml). Wprowadź ciąg w następującym formacie:
gdzie n jest numerem programowego. |
5 |
Kliknij przycisk Zapisz wszystkie zmiany. |
Dodawanie aplikacji XML do klucza liniowego
Dodaj często używane aplikacje do linii, aby użytkownicy mogli łatwo uzyskać dostęp do usług.
Zanim rozpoczniesz
Usługa aplikacji XML została poprawnie skonfigurowana.
1 |
Przejdź do strony WWW administrowania telefonem. |
2 |
Wybierz kolejno opcje . |
3 |
Wybierz klawisz linii. |
4 |
Aby wyłączyć Numer wewnętrzny, w polu rozszerzenie ustaw parametr Wyłączone. Jeśli funkcja Bezpośredniej Konfiguracji PLK jest wyłączona, musisz wyłączyć rozszerzenie, aby dodać rozszerzoną funkcję do klawisza linii. Jeśli ta funkcja jest włączona, można pominąć ten krok. Szczegółowe informacje zawiera sekcja Włączanie konfiguracji bezpośredniego zestawu PLK. |
5 |
Dla parametru Funkcja rozszerzona wprowadź ciąg w następującym formacie: fnc=xml;url=<xml_app_path>; nme=<app_name>
gdzie
Przykład: Możesz również skonfigurować ten parametr w pliku konfiguracyjnym (cfg.xml). Wprowadź ciąg w następującym formacie:
gdzie n jest numerem rozszerzenia. |
6 |
Kliknij przycisk Zapisz wszystkie zmiany. |
Zmienne makr obsługiwane w adresach URL XML
W adresach URL usług XML można używać zmiennych makr. Obsługiwane są następujące zmienne makr:
-
Identyfikator użytkownika — UID1, UID2 do UIDn
-
Nazwa wyświetlana — DISPLAYNAME1, DISPLAYNAME2 do DISPLAYNAMEn
-
Identyfikator uwierzytelniania — AUTHID1, AUTHID2 do AUTHIDn
-
Serwer proxy — PROXY1, PROXY2 do PROXYn
-
Adres MAC zapisany kodem szesnastkowym z małymi literami — MA
-
Nazwa produktu — PN
-
Numer seryjny produktu — PSN
-
Numer seryjny — SERIAL_NUMBER
Nazwa makra | Rozwijanie w makro |
---|---|
$ | Zapis $$ rozwija się do jednego znaku $. |
Od A do P | Zastępowane wartościami parametrów ogólnego przeznaczenia od GPP_A do GPP_P. |
Od SA do SD | Zastępowane wartościami parametrów specjalnego przeznaczenia od GPP_SA do GPP_SD. W tych parametrach są przechowywane klucze lub hasła używane w obsłudze administracyjnej. Parametry od $SA do $SD są rozpoznawane jako argumenty opcjonalnego kwalifikatora adresu URL ponownej synchronizacji — --key. |
MA | Adres MAC zapisany kodem szesnastkowym z małymi literami, na przykład 000e08aabbcc. |
MAU | Adres MAC zapisany kodem szesnastkowym z wielkimi literami, na przykład 000E08AABBCC. |
MAC | Adres MAC zapisany kodem szesnastkowym z małymi literami, gdzie pary znaków szesnastkowych są rozdzielane dwukropkami, na przykład 00:0e:08:aa:bb:cc. |
PN | Nazwa produktu; na przykład Telefon wideo 8875, Telefon biurkowy 9851. |
PSN | Numer serii produktów; Na przykład 8875, 9841, 9861 |
SN | Ciąg określający numer seryjny, na przykład 88012BA01234. |
CCERT | Stan certyfikatu SSL klienta: Zainstalowano lub Nie zainstalowano. |
IP | Adres IP telefonu wewnątrz jego lokalnej podsieci, na przykład 192.168.1.100. |
EXTIP | Zewnętrzny adres IP telefonu widoczny w Internecie, na przykład 66.43.16.52. |
SWVER |
Ciąg określający wersję oprogramowania. Na przykład: PHONEOS.3-2-1-0104-37 |
HWVER |
Ciąg określający wersję sprzętu. Na przykład: 2.0.1. |
PRVST |
Stan obsługi administracyjnej (ciąg liczbowy): -1 = jawne żądanie ponownej synchronizacji 0 = ponowna synchronizacja podczas włączania zasilania 1 = okresowa ponowna synchronizacja 2 = ponowna synchronizacja nie powiodła się, kolejna próba |
UPGST |
Stan uaktualniania (ciąg liczbowy): 1 = pierwsza próba uaktualnienia 2 = uaktualnianie nie powiodło się, kolejna próba |
UPGERR |
Komunikat o wyniku (ERR) poprzedniej próby uaktualnienia, na przykład „wykonanie żądania http_get nie powiodło się”. |
PRVTMR |
Liczba sekund od ostatniej próby ponownej synchronizacji. |
UPGTMR |
Liczba sekund od ostatniej próby uaktualnienia. |
REGTMR1 |
Liczba sekund od utraty przez linię 1 rejestracji na serwerze SIP. |
REGTMR2 |
Liczba sekund od utraty przez linię 2 rejestracji na serwerze SIP. |
UPGCOND |
Starsza nazwa makra. |
SCHEME |
Schemat dostępu do pliku (TFTP, HTTP lub HTTPS) ustalony po analizie adresu URL polecenia ponownej synchronizacji lub uaktualnienia. |
SERV |
Nazwa hosta docelowego serwera żądania ustalona po analizie adresu URL polecenia ponownej synchronizacji lub uaktualnienia. |
SERVIP |
Adres IP docelowego serwera żądania ustalony po analizie adresu URL polecenia ponownej synchronizacji lub uaktualnienia, być może po wyszukiwaniu w usłudze DNS. |
PORT |
Docelowy port UDP/TCP żądania ustalony po analizie adresu URL polecenia ponownej synchronizacji lub uaktualnienia. |
PATH |
Docelowa ścieżka pliku żądania ustalona po analizie adresu URL polecenia ponownej synchronizacji lub uaktualnienia. |
ERR |
Komunikat o wyniku próby ponownej synchronizacji lub uaktualnienia. Ten parametr służy tylko do generowania komunikatów o wynikach zapisywanych w dzienniku systemu. W przypadku prób uaktualnienia wartość jest zapisywana w zmiennej UPGERR. |
UIDn |
Wartość parametru konfiguracyjnego identyfikatora użytkownika na linii n (Line n UserID). |
ISCUST |
Jeśli jednostka została dostosowana, to wartość wynosi 1, w przeciwnym razie wynosi 0. Stan dostosowywania można wyświetlić na stronie Web UI Info. |
INCOMINGNAME | Nazwa skojarzona z pierwszym połączeniem nawiązanym, dzwoniącym lub przychodzącym. |
REMOTENUMBER |
Numer telefonu pierwszego połączenia nawiązanego, dzwoniącego lub przychodzącego. W przypadku wielu połączeń są wyświetlane dane pierwszego znalezionego połączenia. |
DISPLAYNAMEn | Wartość parametru konfiguracyjnego Nazwa wyświetlana linii N. |
AUTHIDn | Wartość parametru konfiguracyjnego Identyfikator uwierzytelniania linii N. |