Genel Bakış

XML Hizmetleri Arabirimi (XSI), uygulamalar ve telefon sistemi arasında iletişime izin veren bir protokoldür. Desteklenen XML nesnelerini ve URI'lerini kullanarak telefonunuza kendi XSI hizmetlerinizi ekleyebilirsiniz.

Telefon hizmetlere abone olduktan sonra, kullanıcılar Ayarlar > Ağ ve hizmet > Cisco XML hizmetleri'ne giderek telefonda yapılandırılmış tüm hizmetlere erişebilir. Cisco XML hizmetleri varsayılan addır. Ayrıca adı değiştirebilirsiniz. Kullanıcılara kolay erişim sağlamak için, XML uygulamalarını ekran tuşlarına veya hat tuşlarına ekleyebilirsiniz.

Desteklenen özellikler şunlardır:

  • Mesajlar (görüntüler ve metin)
  • Çağrı bırakma

Desteklenen XML nesneleri

  • Cisco IP TelefonuMenüsü

  • Cisco IP Telefonu Metni

  • Cisco IP TelefonuGirişi

  • Cisco IP TelefonuDizini

  • Cisco IP Telefonu Görüntüsü

  • Cisco IPhoneImageFile

  • Cisco IP TelefonuSimgesiMenüsü

  • Cisco IPPhoneIconFileMenu

  • Cisco IPPhoneStatus (9841 hariç)

  • CiscoIPPhoneStatusFile (9841 hariç)

  • Cisco IP TelefonuExecute

Desteklenen URI’ler

  • Cihaz

  • Çevir

  • Dail Düzenle

  • Başlangıç

  • Anahtar

  • Oynat (yalnızca zil sesleri)

  • Ekran Tuşu

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

Telefonu bir XML hizmetine bağlanacak şekilde yapılandırın

1

Telefon yönetimi web sayfasına erişin.

2

Ses > Telefon'u seçin.

3

XML Hizmeti bölümünde, XML Uygulaması Hizmet Adı ve XML Uygulaması Hizmeti URL’si parametrelerini XML hizmetleri için parametreler’de açıklandığı şekilde yapılandırın.

4

(Isteğe bağlı) Uygulama hizmetine erişmek için kimlik doğrulama eklemek üzere tez alanlarını yapılandırın: XML Kullanıcı Adı, XML Parolası, CISCO XML EXE Etkinleştirme ve CISCO XML EXE Kimlik Doğrulama Modu.

5

Tüm Değişiklikleri Kaydet’e tıklayın.

XML hizmetleri için parametreler

Aşağıdaki tabloda, telefon web arabirimindeki Ses > Telefon sekmesi altındaki XML Hizmeti bölümünde bulunan XML uygulama parametrelerinin işlevi ve kullanımı tanımlanmıştır. Ayrıca, bir parametreyi yapılandırmak üzere XML kodu bulunan telefon yapılandırma dosyasına (cfg.xml) eklenen dizenin sözdizimi de tanımlanı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ı tercihi 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 UYGULAMASI Adı</XML_Application_Service_Name>

XML Uygulama Hizmeti 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 desteklenir.

XML Kullanıcı Adı

Varsayılan: Boş

Kimlik doğrulama 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">kullanıcıadı</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 şekilde görünür:

<!-- <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">Evet</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 kimlik doğrulama gerçekleştirilmez.

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

  • Uzak Kimlik Bilgileri—Kimlik doğrulama, web sayfasındaki XML uygulamasında ayarlanan (bir XML uygulama sunucusuna erişmek için) uzak kimlik bilgilerini kullanarak özet kimlik doğrulamasına 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">Yerel Kimlik Bilgileri</CISCO_XML_EXE_Auth_Mode>

Ekran tuşuna bir XML uygulaması ekleme

Kullanıcıların hizmete kolayca erişmesi için sık kullanılan uygulamaları ekran tuşlarına ekleyin.

Başlamadan önce

XML Uygulama Hizmeti doğru şekilde yapılandırıldı.

1

Telefon yönetimi web sayfasına erişin.

2

Ses > Telefon'u seçin.

3

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

Bu parametreyi, yapılandırma dosyasında (cfg.xml) da yapılandırabilirsiniz. Şu biçime sahip bir dize girin:

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

Programlanabilir Ekran Tuşları bölümünde, PSK1 ile PSK16 arasındaki kullanılabilir alanları ş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. Şu biçime sahip bir dize girin:

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

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

5

Tüm Değişiklikleri Kaydet’e tıklayın.

Hat tuşuna bir 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 doğru şekilde yapılandırıldı.

1

Telefon yönetimi web sayfasına erişin.

2

Ses > Telefon'u seçin.

3

Bir hat tuşu seçin.

4

Uzantıyı devre dışı bırakmak için Dahili Numara 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ş bir işlev eklemek için uzantıyı devre dışı bırakmanız gerekir. Özellik etkinleştirilmişse bu adımı atlayabilirsiniz. Ayrıntılar için bkz. Doğrudan PLK yapılandırmasını etkinleştirme.
5

Genişletilmiş Işlev parametresinde, şu 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. Şu biçime sahip bir dize girin:

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

Burada n dahili numaradır.

6

Tüm Değişiklikleri Kaydet’e tıklayın.

XML URL'lerinde desteklenen makro değişkenleri

XML URL'lerinde makro değişkenlerini 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 $ karakterine genişletilir.
A'dan P'yeGPP_A ila GPP_P genel amaçlı parametrelerle değiştirilir.
SA'dan SD'yeGPP_SA ila GPP_SD özel amaçlı parametrelerle değiştirilir. Bu parametreler, sağlamada kullanılan anahtarları veya parolaları tutar.
$SA ila $SD isteğe bağlı yeniden eşitleme URL niteleyicisinin (--key) değişkenleri olarak tanınır.
amaKüçük harf onaltılık basamaklar kullanılan MAC adresi (000e08aabbcc).
MAUBüyük harf onaltılık basamaklar kullanılan MAC adresi (000E08AABBCC).
yağmurlukOnaltılık basamak çiftlerini ayırmak için iki nokta üst üste bulunan küçük harf onaltılık basamaklar kullanılan MAC adresi (00:0e:08:aa:bb:cc).
pnÜrün Adı; örneğin, Görüntülü Telefon 8875, Masa Telefonu 9851.
sn.Ürün Seri Numarası; örneğin, 8875, 9841, 9861
sn.Seri Numarası dizesi; örneğin, 88012BA01234.
ccertSSL Istemci Sertifikası durumu, yüklendi veya yüklenmedi.
IPTelefonun yerel alt ağı içindeki IP adresi; örneğin, 192.168.1.100.
extipTelefonun internette görülen harici IP adresi; örneğin, 66.43.16.52.

yüzücü

Yazılım sürümü dizesi. Örneğin,

telefon.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 isteği

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

1 = periyodik yeniden eşitleme

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

yükseliş

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

prvtmr_count

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

gttype

Son yükseltme denemesinden bu yana geçen saniye.

regtmr1'in

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.

Yukarý

Eski makro adı.

şema

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

sunucu

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

servis

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

bağlantı noktası

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

yol

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

hata

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

Kullanıcı Kimliği

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

iscus

Birim özelleştirilmişse değer=1, aksi takdirde 0.

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

gelenNameIlk bağlanan, çalan veya gelen çağrıyla ilişkili ad.
uzaktan numara

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