- Ana Sayfa
- /
- Makale
BroadWorks'te telefonlar için XML uygulamaları yapılandırması
Bu Yardım makalesi, Cisco BroadWorks'e kayıtlı Cisco Masa Telefonu 9800 Serisi ve Cisco Video Telefonu 8875 için geçerlidir. Desteklenen XML nesneleri, URI'ler ve telefon web sayfasında XSI hizmetlerini yapılandırma adımları hakkında bu makaleyi okuyun.
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
'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 |
'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 > 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.
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 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:
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 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:
|
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 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 |
'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:
|
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
Bu parametreyi, yapılandırma dosyasında (cfg.xml) da yapılandırabilirsiniz. Şu biçime sahip bir dize girin:
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 |
'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
Bu parametreyi, yapılandırma dosyasında (cfg.xml) da yapılandırabilirsiniz. Şu biçime sahip bir dize girin:
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
Makro Adı | Makro Genişletme |
---|---|
$ | $$ biçimi tek $ karakterine genişletilir. |
A'dan P'ye | GPP_A ila GPP_P genel amaçlı parametrelerle değiştirilir. |
SA'dan SD'ye | GPP_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. |
ama | 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). |
yağmurluk | Onaltı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. |
ccert | SSL Istemci Sertifikası durumu, yüklendi veya yüklenmedi. |
IP | Telefonun yerel alt ağı içindeki IP adresi; örneğin, 192.168.1.100. |
extip | Telefonun 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. |
gelenName | Ilk 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. |
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. |