Omówienie

XML Services Interface (XSI) to protokół umożliwiający komunikację między aplikacjami a systemem telefonicznym. Za pomocą obsługiwanych obiektów XML i adresów URI można dodawać do telefonu własne usługi XSI.

Po zasubskrybowaniu telefonu do usług użytkownicy mogą uzyskać dostęp do wszystkich usług skonfigurowanych w telefonie, wybierając kolejno opcje Ustawienia > Sieć i usługi > Usługi XML Cisco. Nazwą domyślną są usługi XML Cisco. Można również zmienić nazwę. Aby zapewnić użytkownikom łatwy dostęp, można dodawać aplikacje XML do klawiszy programowych lub klawiszy linii.

Obsługiwane funkcje to:

  • Wiadomości (obrazy i tekst)
  • Przywoływanie

Obsługiwane obiekty XML

  • Menu telefonu IP Cisco

  • Tekst telefonu IP Cisco

  • Dane wejściowe telefonu IP Cisco

  • Książka telefoniczna CiscoIPhoneDirectory

  • Obraz telefonu IP Cisco

  • Plik obrazu telefonu IP Cisco

  • Menu ikony telefonu Cisco

  • MenuPlikIkonyTelefonuCisco

  • CiscoIPhoneStatus (z wyjątkiem 9841)

  • Plik CiscoIPhoneStatusFile (z wyjątkiem pliku 9841)

  • Polecenie CiscoIP PhoneExecute

Obsługiwane identyfikatory URI

  • Urządzenie

  • Wybierz numer

  • Edytuj

  • Inicjuj

  • Klucz

  • Odtwórz (tylko dzwonki)

  • Klawisz programowy

Aby uzyskać więcej informacji na temat konfiguracji usługi XSI, zobacz Uwagi dotyczące rozwoju aplikacji usług telefonu IP Cisco Unified.

Konfigurowanie telefonu w celu łączenia się z usługą XML

1

Przejdź do strony WWW administrowania telefonem.

2

Wybierz pozycję Głos > Telefon.

3

W sekcji Usługa XML skonfiguruj parametry Nazwa usługi aplikacji XML i Adres URL usługi aplikacji XML tak, jak zdefiniowano w Parametry usług XML.

4

(Opcjonalnie) Aby dodać uwierzytelnianie w celu uzyskania dostępu do usługi aplikacji, skonfiguruj następujące pola: Nazwa użytkownika XML, Hasło XML, Włącz CISCO XML EXE i Tryb uwierzytelniania CISCO XML EXE.

5

Kliknij Zapisz wszystkie zmiany.

Parametry usług XML

Poniższa tabela opisuje funkcje i zastosowanie parametrów aplikacji XML znajdujących się w sekcji Usługa XML w zakładce Dźwięk > Telefon w interfejsie WWW telefonu. Definiuje również składnię ciągu dodanego do pliku konfiguracyjnego telefonu (cfg.xml) za pomocą kodu XML w celu skonfigurowania parametru.

Tabela 1. Parametry usług XML

Parametr

Domyślne i opcje

Opis

Nazwa aplikacji usługowej XML

Wartość domyślna: Puste

Nazwa aplikacji XML. Nazwa jest wyświetlana w telefonie jako aplikacja internetowa do wyboru.

Możesz także skonfigurować ten parametr w pliku XML konfiguracji telefonu (cfg.xml), wprowadzając ciąg w następującym formacie:

<XML_Application_Service_Name ua="na">Nazwa APLIKACJI XML</XML_Application_Service_Name>

Adres URL aplikacji usługowej XML

Wartość domyślna: Puste

Adres URL, pod którym jest umieszczona aplikacja XML.

Możesz także skonfigurować ten parametr w pliku XML konfiguracji telefonu (cfg.xml), wprowadzając ciąg w następującym formacie:

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

W przypadku adresów URL XML obsługiwane są zmienne makr. Prawidłowe zmienne makr można znaleźć w artykule Zmienne makr obsługiwane w adresach URL XML.

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.

Możesz także skonfigurować ten parametr w pliku XML konfiguracji telefonu (cfg.xml), wprowadzając ciąg w następującym formacie:

<XML_User_Name ua="na">nazwa użytkownika</XML_User_Name>

Hasło 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:

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

Włącz CISCO XML EXE

Wartość domyślna: Nie

Opcje: Tak, Nie

Określa, czy w celu uzyskania dostępu do serwera aplikacji XML wymagane jest uwierzytelnienie.

Możesz także skonfigurować ten parametr w pliku XML konfiguracji telefonu (cfg.xml), wprowadzając ciąg w następującym formacie:

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

Tryb uwierzytelniania CISCO EXE XML

Wartość domyślna: Lokalne poświadczenie

Opcje: Zaufane, Poświadczenie lokalne, Poświadczenie zdalne

Określa tryb uwierzytelniania Cisco XML EXE.

  • Zaufany — uwierzytelnianie nie jest wykonywane niezależnie od lokalnego poświadczenia.

  • Lokalne poświadczenie — uwierzytelnianie jest oparte na szyfrowaniu przy użyciu lokalnych danych uwierzytelniających, jeśli są one ustawione. W razie braku hasła uwierzytelnianie nie jest wykonywane.

  • Poświadczenie zdalne — uwierzytelnianie jest oparte na szyfrowaniu przy użyciu danych uwierzytelniających zdalnych ustawionych w aplikacji XML na stronie WWW (umożliwiających dostęp do serwera aplikacji XML).

Możesz także skonfigurować ten parametr w pliku XML konfiguracji telefonu (cfg.xml), wprowadzając ciąg w następującym formacie:

<CISCO_XML_EXE_Auth_Mode ua="na">Lokalne poświadczenie</CISCO_XML_EXE_Auth_Mode>

Dodawanie aplikacji XML do klawisza programowego

Dodaj często używane aplikacje do klawiszy programowych, aby użytkownicy mieli łatwy dostęp do usługi.

Przed rozpoczęciem

Usługa aplikacji XML została prawidłowo skonfigurowana.

1

Przejdź do strony WWW administrowania telefonem.

2

Wybierz pozycję Głos > Telefon.

3

W sekcji Programowalne klawisze programowe ustaw wartość Włącz programowalne klawisze programowe na Tak.

Możesz również skonfigurować ten parametr w pliku konfiguracyjnym (cfg.xml). Wprowadź ciąg w następującym formacie:

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

W sekcji Programowalne klawisze programowe zmodyfikuj dostępne pola od PSK1 do PSK16 w następującym formacie:

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

gdzie url to łącze, do którego przechowywana jest aplikacja XML; nme to nazwa wyświetlana aplikacji na ekranie telefonu.

Przykład fnc=xml;url=http://10.77.21.37/xmlapp/menu.xml;nme=Menu

Możesz również skonfigurować ten parametr w pliku konfiguracyjnym (cfg.xml). Wprowadź ciąg w następującym formacie:

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

gdzie n jest numerem klawisza programowego.

5

Kliknij Zapisz wszystkie zmiany.

Dodawanie aplikacji XML do klawisza linii

Dodaj często używane aplikacje do klawiszy linii, aby użytkownicy mieli łatwy dostęp do usług.

Przed rozpoczęciem

Usługa aplikacji XML została prawidłowo skonfigurowana.

1

Przejdź do strony WWW administrowania telefonem.

2

Wybierz pozycję Głos > Telefon.

3

Wybierz klawisz linii.

4

Aby wyłączyć numer wewnętrzny, ustaw parametr Numer wewnętrzny na Wyłączone.

Jeśli funkcja konfiguracji bezpośredniej PLK jest wyłączona, należy wyłączyć numer wewnętrzny, aby dodać funkcję rozszerzoną do klawisza linii. Jeśli funkcja jest włączona, można pominąć ten krok. Aby uzyskać szczegółowe informacje, zobacz Włączanie konfiguracji bezpośredniej PLK.
5

W parametrze Funkcja rozszerzona wprowadź ciąg w następującym formacie:

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

gdzie url to łącze, do którego przechowywana jest aplikacja XML; nme to nazwa wyświetlana aplikacji na ekranie telefonu.

Przykład fnc=xml;url=http://10.77.21.37/xmlapp/menu.xml;nme=Menu

Możesz również skonfigurować ten parametr w pliku konfiguracyjnym (cfg.xml). Wprowadź ciąg w następującym formacie:

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

gdzie n jest numerem wewnętrznym.

6

Kliknij Zapisz wszystkie zmiany.

Zmienne makr obsługiwane w adresach URL XML

W adresach URL 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 serii produktu — PSN

  • Numer seryjny — SERIAL_NUMBER

Tabela 2. Obsługiwane makra
Nazwa makraRozwijanie w makra
$Formularz $$ rozwija się do jednego znaku $.
Od A do PZastępowane wartościami parametrów ogólnego przeznaczenia od GPP_A do GPP_P.
Od SA do SDZastę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.
mamaAdres MAC zapisany kodem szesnastkowym z małymi literami, na przykład 000e08aabbcc.
MAUAdres MAC zapisany kodem szesnastkowym z wielkimi literami, na przykład 000E08AABBCC.
komputer macAdres MAC zapisany kodem szesnastkowym z małymi literami, gdzie pary znaków szesnastkowych są rozdzielane dwukropkami (00:0e:08:aa:bb:cc).
pnNazwa produktu, na przykład Video Phone 8875, Desk Phone 9851.
psnNumer serii produktu, na przykład 8875, 9841, 9861
snCiąg określający numer seryjny, na przykład 88012BA01234.
ccertStan certyfikatu SSL klienta: Zainstalowano lub Nie zainstalowano.
IPAdres IP telefonu w jego podsieci lokalnej, na przykład 192.168.1.100.
podpowiedźZewnętrzny adres IP telefonu widoczny w Internecie, na przykład 66.43.16.52.

łabędź

Ciąg określający wersję oprogramowania. Na przykład:

phoneos.3-2-1-0104-37

grzbiet

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

do góry

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 dotyczący żądania http_get nie powiodło się.

prvtmr

Liczba sekund od ostatniej próby ponownej synchronizacji.

w górę

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.

schemat

Schemat dostępu do pliku (TFTP, HTTP lub HTTPS) ustalony po analizie adresu URL polecenia ponownej synchronizacji lub uaktualnienia.

usługa

Nazwa hosta docelowego serwera żądania ustalona po analizie adresu URL polecenia ponownej synchronizacji lub uaktualnienia.

obsługa

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.

ścieżka

Docelowa ścieżka pliku żądania ustalona po analizie adresu URL polecenia ponownej synchronizacji lub uaktualnienia.

błąd

Komunikat o wyniku próby ponownej synchronizacji lub uaktualnienia. Przydatne tylko w generowaniu wyników komunikatów dziennika systemowego. W przypadku prób uaktualnienia wartość jest zapisywana w zmiennej UPGERR.

Identyfikator UIDn

Wartość parametru konfiguracyjnego identyfikatora użytkownika na linii n.

iscust

Jeśli jednostka została dostosowana, wartość wynosi 1, w przeciwnym razie wynosi 0.

Stan dostosowania jest widoczny na stronie Informacje w internetowym interfejsie użytkownika.

nazwa przychodzącaNazwa skojarzona z pierwszym połączeniem nawiązanym, dzwoniącym lub przychodzącym.
zdalny numer

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.

Nazwa WYŚWIETLANAWartość parametru konfiguracyjnego Nazwa wyświetlana linii N.
Identyfikator AUTHIDWartość parametru konfiguracyjnego identyfikatora uwierzytelniania linii N.