- Strona główna
- /
- Artykuł
Dziękujemy za opinię.
Konfiguracja aplikacji XML dla telefonów 9800 i 8875 (BroadWorks)
W tym artykule
Opinia?Ten artykuł pomocy dotyczy Cisco Desk Phone 9800 Series i Cisco Video Phone 8875 zarejestrowanych w Cisco BroadWorks. Przeczytaj ten artykuł, aby zapoznać się z obsługiwanymi obiektami XML, identyfikatorami URI i krokami konfigurowania usług XSI na stronie internetowej telefonu.
Przegląd
XML Services Interface (XSI) to protokół umożliwiający komunikację między aplikacjami a systemem telefonicznym. Możesz dodać własne usługi XSI do telefonu za pomocą obsługiwanych obiektów XML i URI.
Po zasubskrybowaniu telefonu do usług użytkownicy mogą uzyskać dostęp do wszystkich skonfigurowanych usług w telefonie, przechodząc do . Domyślną nazwą są usługi Cisco XML. Możesz także zmienić nazwę. Aby zapewnić użytkownikom łatwy dostęp, możesz dodać aplikacje XML do klawiszy programowych lub klawiszy liniowych.
Obsługiwane funkcje to:
- Wiadomości (obrazy i tekst)
- Paging
Obsługiwane obiekty XML
-
CiscoipPhoneMenu
-
CiscoipphoneTekst
-
CiscoipPhoneInput
-
CiscoipPhoneKatalog
-
CiscoipphoneObraz
-
CISCOIPPhonePlik obrazu
-
CiscoipPhoneIconMenu
-
CiscoipPhoneIconMenu pliku
-
CiscoipPhoneStatus (z wyjątkiem 9811 i 9841)
-
CISCOIPPhonEstatusFile (z wyjątkiem 9811 i 9841)
-
CiscoipPhoneWykonaj
Obsługiwane adresy URI
-
Urządzenie
-
Wybieraj
-
Edytuj Dail
-
Init
-
Klucz
-
Odtwarzanie (tylko dzwonki)
-
Klucz programowy
Aby uzyskać więcej informacji na temat konfiguracji usługi XSI, zobacz Uwagi dotyczące rozwoju aplikacji Cisco Unified IP Phone Services.
Konfigurowanie telefonu do łączenia się z usługą XML
| 1 |
Uzyskaj dostęp do strony internetowej administracji telefonu. |
| 2 |
Wybierz opcję . |
| 3 |
W sekcji Usługa XML skonfiguruj parametry nazwy usługi aplikacji XML i adresu URL usługi aplikacji XML zgodnie z definicją Parametry dla usług XML. |
| 4 |
(Opcjonalnie) Aby dodać uwierzytelnianie dostępu do usługi aplikacji, skonfiguruj te pola: Nazwa użytkownika XML, Hasło XML, CISCO XML EXE En able i CISCO XML EXE Auth Mo de. |
| 5 |
Kliknij przycisk Zapisz wszystkie zmiany. |
Parametry dla usług XML
Poniższa tabela definiuje funkcję i użycie parametrów aplikacji XML w sekcji Usługa XML w zakładce w interfejsie internetowym telefonu. Definiuje również składnię ciągu dodawanego do pliku konfiguracyjnego telefonu (cfg.xml) z kodem XML w celu skonfigurowania parametru.
|
Parametr |
Domyślne i opcje |
Opis |
|---|---|---|
|
Nazwa usługi aplikacji XML |
Domyślnie: pusty |
Nazwa aplikacji XML. Nazwa jest wyświetlana w telefonie jako wybór aplikacji internetowej. Możesz również skonfigurować ten parametr w pliku XML konfiguracji telefonu (cfg.xml), wprowadzając ciąg znaków w tym formacie: |
|
Adres URL usługi aplikacji XML |
Domyślnie: pusty |
Adres URL, w którym znajduje się aplikacja XML. Możesz również skonfigurować ten parametr w pliku XML konfiguracji telefonu (cfg.xml), wprowadzając ciąg znaków w tym formacie: Zmienne makr są obsługiwane w adresach URL XML. Aby zapoznać się z prawidłowymi zmiennymi makr, zobacz Zmienne makr obsługiwane w adresach URL XML. W adresie URL obsługiwane są tylko protokoły HTTP lub HTTPS. |
|
Nazwa użytkownika XML |
Domyślnie: pusty |
Nazwa użytkownika usługi XML do celów uwierzytelniania. Możesz również skonfigurować ten parametr w pliku XML konfiguracji telefonu (cfg.xml), wprowadzając ciąg znaków w tym formacie: |
|
Hasło XML |
Domyślnie: pusty |
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: |
|
CISCO XML EXE Włącz |
Domyślnie: Nie Opcje: Tak, Nie |
Określa, czy uwierzytelnianie jest wymagane do uzyskania dostępu do serwera aplikacji XML. Możesz również skonfigurować ten parametr w pliku XML konfiguracji telefonu (cfg.xml), wprowadzając ciąg znaków w tym formacie: |
|
Tryb audycji CISCO XML EXE |
Domyślnie: Lokalne poświadczenia Opcje: Zaufane, Lokalne poświadczenia, Zdalne poświadczenia |
Określa tryb uwierzytelniania dla Cisco XML EXE.
Możesz również skonfigurować ten parametr w pliku XML konfiguracji telefonu (cfg.xml), wprowadzając ciąg znaków w tym formacie: |
Dodawanie aplikacji XML do klawisza programowego
Dodaj często używane aplikacje do klawiszy programowych, aby użytkownicy mogli łatwo uzyskać dostęp do usługi.
Zanim zaczniesz
Usługa aplikacji XML została poprawnie skonfigurowana.
| 1 |
Uzyskaj dostęp do strony internetowej administracji telefonu. |
| 2 |
Wybierz opcję . |
| 3 |
W sekcji Programowalne klawisze program owe ustaw opcję Włącz programowalny klawisz programowy na Tak. Ten parametr można również skonfigurować w pliku konfiguracyjnym (cfg.xml). Wprowadź ciąg znaków w tym formacie: |
| 4 |
W sekcji Programowalne klawis ze programowe edytuj dostępne pola PSK1 do PSK 16 w tym formacie: fnc=xml;url=<xml_app_path>;nme=<app_name>
gdzie
Przykład
Ten parametr można również skonfigurować w pliku konfiguracyjnym (cfg.xml). Wprowadź ciąg znaków w tym formacie:
gdzie n jest numerem klawisza programowego. |
| 5 |
Kliknij przycisk Zapisz wszystkie zmiany. |
Dodawanie aplikacji XML do klucza wiersza
Dodaj często używane aplikacje do kluczy liniowych, aby użytkownicy mogli łatwo uzyskać dostęp do usług.
Zanim zaczniesz
Usługa aplikacji XML została poprawnie skonfigurowana.
| 1 |
Uzyskaj dostęp do strony internetowej administracji telefonu. |
| 2 |
Wybierz opcję . |
| 3 |
Wybierz klawisz linii. |
| 4 |
Ustaw parametr Extension na Wy łączone, aby wyłączyć rozszerzenie. Jeśli funkcja Direct PLK Configuration jest wyłączona, należy wyłączyć rozszerzenie, aby dodać rozszerzoną funkcję do klawisza wiersza. Jeśli funkcja jest włączona, możesz pominąć ten krok. Aby uzyskać szczegółowe informacje, zobacz W łączanie konfiguracji Direct PLK. |
| 5 |
W parametrze Funkcja rozszer zona wprowadź ciąg znaków w tym formacie: fnc=xml;url=<xml_app_path>;nme=<app_name>
gdzie
Przykład
Ten parametr można również skonfigurować w pliku konfiguracyjnym (cfg.xml). Wprowadź ciąg znaków w tym formacie:
gdzie n jest numerem rozszerzenia. |
| 6 |
Kliknij przycisk Zapisz wszystkie zmiany. |
Zmienne makro obsługiwane w adresach URL XML
Można użyć zmiennych makr w adresach URL XML. Obsługiwane są następujące zmienne makro:
-
ID użytkownika—UID1, UID2 do UiDn
-
Wyświetlana nazwa—DisplayName1, DISPLAYNAME2 do DisplayNamen
-
Identyfikator auth — AUTHID1, AUTHID2 do AuthIDN
-
Proxy—Proxy1, PROXY2 do ProxyN
-
Adres MAC przy użyciu małych liter sześciokątnych — MA
-
Nazwa produktu—PN
-
Numer serii produktu — PSN
-
Numer seryjny — numer seryjny
| Nazwa makra | Rozszerzenie makro |
|---|---|
| $ | Forma $$ rozszerza się do pojedynczego znaku $. |
| Od A do P | Zastąpiony przez parametry ogólnego przeznaczenia GPP_A przez GPP_P. |
| SA przez SD | Zastąpiony przez parametry specjalnego przeznaczenia GPP_SA przez GPP_SD. Te parametry
zawierają klucze lub hasła używane podczas udostępniania. $SA do $SD są rozpoznawane jako argumenty opcjonalnego kwalifikatora adresu URL resync, --key. |
| MA | Adres MAC przy użyciu małych cyfr sześciokątnych (000e08aabbcc). |
| MAU | Adres MAC używający wielkich cyfr sześciokątnych (000E08AABBCC). |
| MAC | Adres MAC używający małych cyfr sześciokątnych z dwukropkiem do oddzielania par cyfr sześciokątnych (00:0 e:08:aa:bb:cc). |
| PN | Nazwa produktu; na przykład telefon wideo 8875, telefon biurkowy 9851. |
| PSN | Numer serii produktu; na przykład 8875, 9841, 9861 |
| SN | Ciąg numeru seryjnego; na przykład 88012BA01234. |
| CCERT | Status certyfikatu klienta SSL, zainstalowany lub niezainstalowany. |
| IP | Adres IP telefonu w jego lokalnej podsieci; na przykład 192.168.1.100. |
| EXTIP | Zewnętrzny adres IP telefonu, jak widać w Internecie; na przykład 66.43.16.52. |
|
SWVER |
Ciąg wersji oprogramowania. Na przykład PHONEOS.3-2-1-0104-37 |
|
HWVER |
Ciąg wersji sprzętowej. Na przykład 2.0.1 |
|
PRVST |
Stan zaopatrzenia (ciąg numeryczny): -1 = wyraźne żądanie ponownej synchronizacji 0 = ponowna synchronizacja zasilania 1 = okresowa resynchronizacja 2 = ponowna synchronizacja nie powiodła się, spróbuj ponownie |
|
UPGST |
Stan uaktualnienia (ciąg numeryczny): 1 = pierwsza próba aktualizacji 2 = aktualizacja nie powiodła się, spróbuj ponownie |
|
UPGERR |
Komunikat o wyniku (ERR) poprzedniej próby aktualizacji; na przykład http_get nie powiodło się. |
|
PRVTMR |
Sekundy od ostatniej próby ponownej synchronizacji. |
|
UPGTMR |
Sekundy od ostatniej próby aktualizacji. |
|
REGTMR1 |
Sekundy od utraty rejestracji na serwerze SIP Line 1. |
|
REGTMR2 |
Sekundy, odkąd Line 2 utracił rejestrację na serwerze SIP. |
|
UPGCOND |
Starsza nazwa makra. |
|
SCHEME |
Schemat dostępu do plików, jeden z TFTP, HTTP lub HTTPS, uzyskany po przeanalizowaniu adresu URL ponownej synchronizacji lub aktualizacji. |
|
SERV |
Poproś o nazwę hosta serwera docelowego, uzyskaną po przeanalizowaniu adresu URL ponownej synchronizacji lub aktualizacji. |
|
SERVIP |
Poproś o adres IP serwera docelowego, uzyskany po przeanalizowaniu adresu URL ponownej synchronizacji lub aktualizacji, prawdopodobnie po wyszukiwaniu DNS. |
|
PORT |
Poproś o docelowy port UDP/TCP uzyskany po przeanalizowaniu ponownej synchronizacji lub aktualizacji adresu URL. |
|
PATH |
Poproś o ścieżkę pliku docelowego, uzyskaną po przeanalizowaniu ponownej synchronizacji lub aktualizacji adresu URL. |
|
ERR |
Komunikat o wyniku ponownej synchronizacji lub próby aktualizacji. Przydatne tylko w generowaniu komunikatów syslog wyników. Wartość jest zachowana w zmiennej UPGERR w przypadku prób aktualizacji. |
|
UIDn |
Zawartość parametru konfiguracyjnego Line n userId. |
| ISCUST |
Jeśli jednostka jest dostosowana, wartość: 1, w przeciwnym razie 0. Status dostosowywania jest widoczny na stronie Informacje o interfejsie użytkownika sieci Web. |
| INCOMINGNAME | Nazwa skojarzona z pierwszym połączeniem, dzwoniącym lub przychodzącym połączeniem. |
| REMOTENUMBER |
Numer telefonu pierwszego połączenia, dzwoniącego lub przychodzącego połączenia. Jeśli istnieje wiele połączeń, podane są dane związane z pierwszym znalezionym połączeniem. |
| Nazwy wyświetlaniaNazwy | Zawartość parametru konfiguracyjnego Nazwa wyświetlania linii N. |
| AuthidN | Zawartość parametru konfiguracyjnego ID auth ID linii N. |
