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 Ustawienia > Sieć i usługa >Usługi XML Cisco. 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 Głos > Telefon.

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 > Telefon w interfejsie sieciowym telefonu. Definiuje również składnię ciągu dodanego do pliku konfiguracyjnego w formacie XML (cfg.xml) w celu skonfigurowania parametru.

Tabela 1. Parametry usług XML

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:

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

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:

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

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:

<XML_User_Name ua="na">nazwa_użytkownika</XML_User_Name>

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:

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

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:

<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świadczenia lokalne, Poświadczenia zdalne

Określa tryb uwierzytelniania Cisco XML EXE.

  • Zaufany — uwierzytelnianie nie odbywa się niezależnie od lokalnego poświadczenia.

  • Lokalne poświadczenie — uwierzytelnianie jest oparte na mieszaniu (digest) 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 nazwy/hasła zdalnego użytkownika ustawionych w aplikacji XML na stronie WWW (umożliwiających dostęp do serwera aplikacji XML).

Ten parametr można także skonfigurować w pliku konfiguracyjnym (cfg.xml), wprowadzając odpowiedni ciąg w następującym formacie:

<CISCO_XML_EXE_Auth_Mode ua="na">Local Credential</CISCO_XML_EXE_Auth_Mode>

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 Głos > Telefon.

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:

<Programmable_Softkey_Enable ua="na">Tak</Programmable_Softkey_Enable>
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 url jest łączem, pod którym 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<configuration code></PSK_n>

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 Głos > Telefon.

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 url jest łączem, pod którym 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<configuration code></Extended_Function_n_>

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

Tabela 2. Obsługiwane makra
Nazwa makraRozwijanie w makro
$Zapis $$ 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.
MAAdres MAC zapisany kodem szesnastkowym z małymi literami, na przykład 000e08aabbcc.
MAUAdres MAC zapisany kodem szesnastkowym z wielkimi literami, na przykład 000E08AABBCC.
MACAdres 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.
PNNazwa produktu; na przykład Telefon wideo 8875, Telefon biurkowy 9851.
PSNNumer serii produktów; 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 wewnątrz jego lokalnej podsieci, na przykład 192.168.1.100.
EXTIPZewnę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.

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

DISPLAYNAMEnWartość parametru konfiguracyjnego Nazwa wyświetlana linii N.
AUTHIDnWartość parametru konfiguracyjnego Identyfikator uwierzytelniania linii N.