- Ana Sayfa
- /
- Makale
XML uygulamaları yapılandırması
Bu Yardım makalesi, Cisco BroadWorks adına kayıtlı Cisco Masa Telefonu 9800 Serisi ve Cisco Video Phone 8875 için geçerlidir. Desteklenen XML nesneleri, URI'ler ve telefon web sayfasında XSI hizmetlerini yapılandırma adımları için bu makaleyi okuyun.
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
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 |
'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 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.
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 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:
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 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:
|
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 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.
Bu parametreyi, telefon yapılandırma XML dosyasına (cfg.xml) şu biçimde bir dize girerek de yapılandırabilirsiniz:
|
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 |
'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:
|
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>
Örnek Bu parametreyi, yapılandırma dosyasında (cfg.xml) da yapılandırabilirsiniz. Dizeyi aşağıdaki biçimde girin:
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 |
'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>
Örnek Bu parametreyi, yapılandırma dosyasında (cfg.xml) da yapılandırabilirsiniz. Dizeyi aşağıdaki biçimde girin:
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
Makro Adı | Makro Genişletme |
---|---|
$ | $$ biçimi tek karakterli $ biçimine genişletilir. |
A through P | GPP_A ila GPP_P genel amaçlı parametreleriyle değiştirilir. |
SA through SD | GPP_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. |
MA | Küçük harf onaltılık basamaklar kullanılan MAC adresi (000e08aabbcc). |
MAU | Büyük harf onaltılık basamaklar kullanılan MAC adresi (000E08AABBCC). |
MAC | Onaltı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 |
SN | Seri Numarası dizesi; örneğin, 88012BA01234. |
CCERT | SSL İstemci Sertifikası durumu; yüklendi veya yüklenmedi. |
IP | Telefonun yerel alt ağı içerisindeki IP adresi; örneğin, 192.168.1.100. |
EXTIP | Telefonun 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. |
DISPLAYNAMEn | Hat N Görünen Ad yapılandırma parametresinin içerikleri. |
AUTHIDn | Hat N Kimlik Doğrulama Kimliği yapılandırma parametresinin içerikleri. |