Genel Bakış

XML Hizmetleri Arabirimi (XSI), uygulamalar ve telefon sistemi arasında iletişim sağlayan bir protokoldür. Desteklenen XML nesneleri ve URI'leri kullanarak kendi XSI hizmetlerinizi telefonunuza ekleyebilirsiniz.

Kullanıcılar, telefona hizmetlere abone olduktan sonra, Ayarlar >Network ve hizmet > Cisco XML hizmetlerine giderek telefondaki yapılandırılmış tüm hizmetlere erişebilir. Cisco XML hizmetleri varsayılan addır. Adı da değiştirebilirsiniz. Kullanıcılara kolay erişim sağlamak için, yazılım tuşlarına veya hat tuşlarına XML uygulamaları ekleyebilirsiniz.

Desteklenen özellikler şunlardır:

  • Mesajlar (resimler ve metin)
  • Çağrı

Desteklenen XML nesneler

  • CiscoIPPhoneMenu

  • CiscoIPPhoneText

  • CiscoIPPhoneInput

  • CiscoIPPhoneDirectory

  • CiscoIPPhoneImage

  • CiscoIPPhoneImageFile

  • CiscoIPPhoneIconMenu

  • CiscoIPPhoneIconFileMenu

  • CiscoIPPhoneStatus (9841 hariç)

  • CiscoIPPhoneStatusFile (9841 hariç)

  • CiscoIPPhoneExecute

Desteklenen URI'ler

  • Cihaz

  • Çevirmek

  • DüzenlemeTarih

  • Init

  • Anahtar

  • Çalma (yalnızca zil sesleri)

  • Ekran Tuşu

XSI hizmet yapılandırması hakkında daha fazla bilgi için bkz.Cisco Unified IP Phone Hizmetler Uygulama Geliştirme Notları.

Bir XML hizmetine bağlanmak için telefon yapılandırma

1

Telefonun yönetim web sayfasına erişin.

2

Ses > Telefon'u seçin.

3

Hizmet bölümünde XML Uygulama Hizmeti Adı ve XML XML Uygulama Hizmeti URL parametrelerini, XML hizmetleri parametrelerinde tanımlandığı şekilde yapılandırın.

4

(İsteğe bağlı) Uygulama hizmetine erişim için kimlik doğrulama eklemek için, bu alanları yapılandırın: XML Kullanıcı Adı,XML Parolası, CISCO XML EXE Etkinleştirme ve CISCO XML EXE Auth Modu.

5

Tüm Değişiklikleri Kaydet'i tıklatın.

XML hizmetleri için parametreler

Aşağıdaki tablo, telefon web arabiriminde Ses>Phone sekmesinde yer alan XML Hizmet bölümünde yer alan XML uygulama parametrelerinin işlevini ve kullanımını tanımlar. Ayrıca, bir parametreyi yapılandırmak amacıyla XML kodu bulunan telefon yapılandırma dosyasına (cfg.xml) eklenen dizenin sözdizimi de tanımlanmıştır.

Tablo 1. XML hizmetleri için parametreler

Parametre

Varsayılan ve seçenekler

Açıklama

XML Uygulaması Hizmet Adı

Varsayılan: Boş

XML uygulamasının adı. Ad, telefonda bir web uygulaması seçimi olarak görüntülenir.

Bu parametreyi, telefon yapılandırma XML dosyasına (cfg.xml) şu biçimde bir dize girerek de yapılandırabilirsiniz:

<XML_Application_Service_Name ua="na">XML APP Adı</XML_Application_Service_Name>

XML Uygulaması Hizmet URL'si

Varsayılan: Boş

XML uygulamasının bulunduğu URL.

Bu parametreyi, telefon yapılandırma XML dosyasına (cfg.xml) şu biçimde bir dize girerek de yapılandırabilirsiniz:

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

Makro değişkenleri, XML URL'lerinde desteklenir. Geçerli makro değişkenleri için bkz. XML URL'lerinde desteklenen Makro değişkenleri.

URL'de yalnızca HTTP veya HTTPs protokolleri desteklenmektedir.

XML Kullanıcı Adı

Varsayılan: Boş

Kimlik doğrulaması amacıyla XML hizmet kullanıcı adı.

Bu parametreyi, telefon yapılandırma XML dosyasına (cfg.xml) şu biçimde bir dize girerek de yapılandırabilirsiniz:

<XML_User_Name ua="na">username</XML_User_Name>

XML Parolası

Varsayılan: Boş

Belirtilen XML Kullanıcı Adı için XML hizmet parolası.

Bu alana girdiğiniz parola yapılandırma dosyasında (cfg.xml) aşağıdaki gibi gösterilir:

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

CISCO XML EXE Etkinleştirme

Varsayılan: Hayır

Seçenekler: Evet, Hayır

XML uygulama sunucusuna erişmek için kimlik doğrulamasının gerekli olup olmadığını belirtir.

Bu parametreyi, telefon yapılandırma XML dosyasına (cfg.xml) şu biçimde bir dize girerek de yapılandırabilirsiniz:

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

CISCO XML EXE Kimlik Doğrulama Modu

Varsayılan: Yerel Kimlik Bilgileri

Seçenekler: Güvenilir, Yerel Kimlik Bilgileri, Uzak Kimlik Bilgileri

Cisco XML EXE için kimlik doğrulama modunu belirtir.

  • Güvenilir—Yerel kimlik bilgilerinden bağımsız olarak, hiçbir şekilde kimlik doğrulaması yapılmaz.

  • Yerel Kimlik Bilgileri—Kimlik doğrulaması, ayarlanmışsa yerel kimlik bilgileri ile özet kimlik doğrulama işlemine dayanır. Yerel kimlik bilgileri ayarlanmamışsa kimlik doğrulaması gerçekleştirilmez.

  • Uzak Kimlik Bilgileri—Kimlik doğrulama, web sayfasındaki XML uygulamasında ayarlanan (bir XML uygulama sunusuna erişmek için) uzak kimlik bilgileri ile özet kimlik doğrulama işlemine dayanır.

Bu parametreyi, telefon yapılandırma XML dosyasına (cfg.xml) şu biçimde bir dize girerek de yapılandırabilirsiniz:

<CISCO_XML_EXE_Auth_Mode ua="na">Hata Kimlik Bilgileri</CISCO_XML_EXE_Auth_Mode>

Ekran tuşuna XML uygulaması ekleme

Kullanıcıların hizmete kolayca erişebilmesi için sık kullanılan uygulamaları ekran tkey'lerine ekleyin.

Başlamadan önce

XML Uygulama Hizmeti düzgün yapılandırılmış.

1

Telefonun yönetim web sayfasına erişin.

2

Ses > Telefon'u seçin.

3

Programlanabilir Ekran Tuşları bölümünde, Programlanabilir Ekran Tuşlarını Etkinleştirme seçeneğini Evet olarak belirleyin.

Bu parametreyi, yapılandırma dosyasında (cfg.xml) da yapılandırabilirsiniz. Dizeyi aşağıdaki biçimde girin:

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

Programlanabilir Ekran Tuşları bölümünde, PSK1 ile PSK16'nın kullanılabilir alanlarını şu biçimde düzenleyin:

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

burada url , XML uygulamasının depolandığı bağlantıdır; nme , uygulamanın telefon ekranındaki görünen adıdır.

Örnek fnc=xml;url=http://10.77.21.37/xmlapp/menu.xml;nme=Menu

Bu parametreyi, yapılandırma dosyasında (cfg.xml) da yapılandırabilirsiniz. Dizeyi aşağıdaki biçimde girin:

<PSK_n ua="na">fnc=xml;url=http://10.77.21.37/xmlapp/menu.xml;nme=Menu< yapılandırma kodu></PSK_n>

burada n ekran tuşu numarasıdır.

5

Tüm Değişiklikleri Kaydet'i tıklatın.

Hat tuşuna XML uygulaması ekleme

Kullanıcıların hizmetlere kolayca erişebilmesi için sık kullanılan uygulamaları hat tuşlarına ekleyin.

Başlamadan önce

XML Uygulama Hizmeti düzgün yapılandırılmış.

1

Telefonun yönetim web sayfasına erişin.

2

Ses > Telefon'u seçin.

3

Bir hat tuşu seçin.

4

Dahili hat özelliğini devre dışı bırakmak için Dahili Hat parametresini Devre Dışı olarak ayarlayın.

Doğrudan PLK Yapılandırması özelliği devre dışı bırakılırsa hat tuşuna genişletilmiş işlev eklemek için dahili hattı devre dışı bırakmanız gerekir. Özellik etkinse bu adımı atlayabilirsiniz. Ayrıntılar için, bkz . Doğrudan PLK yapılandırmasını etkinleştirme.
5

Genişletilmiş İşlev parametresine, aşağıdaki biçimde bir dize girin:

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

burada url , XML uygulamasının depolandığı bağlantıdır; nme , uygulamanın telefon ekranındaki görünen adıdır.

Örnek fnc=xml;url=http://10.77.21.37/xmlapp/menu.xml;nme=Menu

Bu parametreyi, yapılandırma dosyasında (cfg.xml) da yapılandırabilirsiniz. Dizeyi aşağıdaki biçimde girin:

<Extended_Function_n_ ua="na">fnc=xml;url=http://10.77.21.37/xmlapp/menu.xml;nme=Menu< yapılandırma kodu></Extended_Function_n_>

Burada n dahili numaradır.

6

Tüm Değişiklikleri Kaydet'i tıklatın.

XML URL'lerinde desteklenen makro değişkenleri

XML URL'lerinde makro değişkenleri kullanabilirsiniz. Aşağıdaki makro değişkenleri desteklenir:

  • Kullanıcı kimliği—UID1, UID2, UIDn...

  • Görünen ad—DISPLAYNAME1, DISPLAYNAME2, DISPLAYNAMEn...

  • Kimlik doğrulama kimliği—AUTHID1, AUTHID2, AUTHIDn...

  • Proxy—PROXY1, PROXY2, PROXYn...

  • Küçük harf onaltılık basamaklar kullanılan MAC Adresi—MA

  • Ürün Adı—PN

  • Ürün Seri Numarası—PSN

  • Seri Numarası—SERIAL_NUMBER

Tablo 2. Desteklenen Makrolar
Makro AdıMakro Genişletme
$$$ biçimi tek karakterli $ biçimine genişletilir.
A through PGPP_A ila GPP_P genel amaçlı parametreleriyle değiştirilir.
SA through SDGPP_SA ila GPP_SD özel amaç parametreleriyle değiştirilir. Bu parametreler hazırlamada kullanılan anahtarları veya parolaları barındırır.
$SA ila $SD isteğe bağlı yeniden eşitleme URL niteleyicisinin (--key) değişkenleri olarak tanınır.
MAKüçük harf onaltılık basamaklar kullanılan MAC adresi (000e08aabbcc).
MAUBüyük harf onaltılık basamaklar kullanılan MAC adresi (000E08AABBCC).
MACOnaltılık basamak çiftlerini ayırmak için iki noktalar bulunan, küçük harf onaltılık basamaklar kullanılan MAC adresi (00:0e:08:aa:bb:cc).
PNÜrün Adı; örneğin, Video Telefonu 8875, Masa Telefonu 9851.
PSNÜrün Serisi Numarası; örneğin, 8875, 9841, 9861
SNSeri Numarası dizesi; örneğin, 88012BA01234.
CCERTSSL İstemci Sertifikası durumu; yüklendi veya yüklenmedi.
IPTelefonun yerel alt ağı içerisindeki IP adresi; örneğin, 192.168.1.100.
EXTIPTelefonun internette görülen harici IP adresi; örneğin, 66.43.16.52.

SWVER

Yazılım sürümü dizesi. Örnek:

PHONEOS.3-2-1-0104-37

HWVER

Donanım sürümü dizesi. Örneğin, 2.0.1

PRVST

Hazırlama Durumu (sayısal bir dize):

-1 = açık yeniden eşitleme talebi

0 = açılırken yeniden eşitleme

1 = periyodik yeniden eşitleme

2 = yeniden eşitleme başarısız, yeniden deneme

UPGST

Yükseltme Durumu (sayısal bir dize):

1 = ilk yükseltme denemesi

2 = yükseltme başarısız, yeniden deneme

UPGERR

Önceki yükseltme denemesinin sonuç mesajı (ERR); örneğin http_get başarısız.

PRVTMR

Son yeniden eşitleme denemesinden beri geçen saniye.

UPGTMR

Son yükseltme denemesinden beri geçen saniye.

REGTMR1

Hat 1 SIP sunucusu kaydının kaybından beri geçen saniye.

REGTMR2

Hat 2 SIP sunucusu kaydının kaybından beri geçen saniye.

UPGCOND

Eski makro adı.

SCHEME

Yeniden eşitleme veya yükseltme URL'si ayrıştırıldıktan sonra elde edilen dosya erişim düzeni (TFTP, HTTP veya HTTPS'den biri).

SERV

Yeniden eşitleme veya yükseltme URL'si ayrıştırıldıktan sonra elde edilen hedef sunucusu ana bilgisayar adı talebi.

SERVIP

Yeniden eşitleme veya yükseltme URL'si ayrıştırıldıktan, muhtemelen DNS araması sonrasında elde edilen hedef sunucusu IP adresi adı talebi.

PORT

Yeniden eşitleme veya yükseltme URL'si ayrıştırıldıktan sonra elde edilen hedef UDP/TCP bağlantı noktası talebi.

PATH

Yeniden eşitleme veya yükseltme URL'si ayrıştırıldıktan sonra elde edilen hedef dosya yolu talebi.

ERR

Yeniden eşitleme veya yükseltme denemesinin sonuç mesajı. Yalnızca sonuç sistem günlüğü mesajlarını oluşturmada kullanışlıdır. Yükseltme denemeleri durumunda değer UPGERR değişkeninde korunur.

UIDn

Hat n Kullanıcı Kimliği yapılandırma parametresinin içerikleri.

ISCUST

Birim özelleştirilirse, value=1, aksi halde 0.

Özelleştirme durumu Web UI Bilgi sayfasında görüntülenebilir.

INCOMINGNAMEİlk bağlanan, çalan veya gelen çağrı ile ilişkili ad.
REMOTENUMBER

İlk bağlanan, çalan veya gelen çağrının telefon numarası. Birden fazla çağrı olması durumunda, bulunan ilk çağrı ile ilişkili veriler sağlanır.

DISPLAYNAMEnHat N Görünen Ad yapılandırma parametresinin içerikleri.
AUTHIDnHat N Kimlik Doğrulama Kimliği yapılandırma parametresinin içerikleri.