- Ana Sayfa
- /
- Makale
9800 ve 8875 telefonlar için XML uygulamaları yapılandırması (BroadWorks)
Bu Yardım makalesi, Cisco BroadWorks'e 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 Arayüzü (XSI), uygulamalar ve telefon sistemi arasında iletişime izin veren bir protokoldür. Desteklenen XML nesnelerini ve URI'leri kullanarak telefonunuza kendi XSI hizmetlerinizi ekleyebilirsiniz.
Telefonu hizmetlere abone olduktan sonra, kullanıcılar erişebilir. Cisco XML hizmetleri varsayılan addır. İsmi de değiştirebilirsiniz. Kullanıcılara kolay erişim sağlamak için XML uygulamalarını yazılım tuşlarına veya satır tuşlarına ekleyebilirsiniz.
Desteklenen özellikler şunlardır:
- Mesajlar (resimler ve metin)
- Çağrı
Desteklenen XML nesneleri
-
CiscoIpPhoneMenu
-
CiscoIPPhoneText
-
CiscoIPPhoneGirişi
-
CiscoIPPhoneDizini
-
CiscoIPPhoneImage
-
CiscoIPPhoneImage Dosyası
-
CiscoIPPhoneIconMenu
-
CiscoIPPhoneIconFileMenu
-
CiscoIPPhoneStatus (9811 ve 9841 hariç)
-
CiscoIPPhoneStatusFile (9811 ve 9841 hariç)
-
CiscoIPPhoneExecute
Desteklenen URI'ler
-
Aygıt
-
Kadran
-
EditDail
-
Başlangıç
-
Anahtar
-
Çal (yalnızca zil sesleri)
-
Yazılım tuşu
XSI hizmet yapılandırması hakkında daha fazla ayrıntı için bkz. Cisco Unified IP Phone Services Uygulama Geliştirme Notları.
Bir telefonu XML hizmetine bağlanacak şekilde yapılandırma
| 1 |
Telefon yönetimi web sayfasına erişin. |
| 2 |
seçin. |
| 3 |
XML Hizmeti bölümünde XML Uygulama Hizmeti Adı ve XML Uygulama Hizmet i URL parametrelerini XML hizmetleri için Parametreler'de tanımlandığı şekilde yapılandırın. |
| 4 |
(İsteğe bağlı) Uygulama hizmetine erişmek 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 Yetkilendirme Modu. |
| 5 |
Tüm Değişiklikleri Kaydet'e tıklayın. |
XML hizmetleri için parametreler
Aşağıdaki tablo, telefon web arayüzündeki sekmesinin altındaki XML Hizmet i bölümünde XML uygulama parametrelerinin işlevini ve kullanımını tanımlar. Ayrıca, bir parametreyi yapılandırmak için telefon yapılandırma dosyasına (cfg.xml) eklenen dizenin sözdizimini XML koduyla tanımlar.
|
Parametre |
Varsayılan ve seçenekler |
Açıklama |
|---|---|---|
|
XML Uygulama Hizmet Adı |
Varsayılan: Boş |
XML uygulamasının adı. Ad telefonda bir web uygulaması seçeneği olarak görüntülenir. Bu parametreyi telefon yapılandırma XML dosyasında (cfg.xml) bu formatta 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ında (cfg.xml) bu formatta 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ında (cfg.xml) bu formatta bir dize girerek de yapılandırabilirsiniz:
|
|
XML Şifre |
Varsayılan: Boş |
Belirtilen XML Kullanıcı Adı için XML hizmet parolası. Bu alana girdiğiniz şifre yapılandırma dosyasında (cfg.xml) aşağıdaki gibi görünür:
|
|
CISCO XML EXE Etkinleştir |
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ında (cfg.xml) bu formatta 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 Bilgisi, Uzak Kimlik Bilgileri |
Cisco XML EXE için kimlik doğrulama modunu belirtir.
Bu parametreyi telefon yapılandırma XML dosyasında (cfg.xml) bu formatta bir dize girerek de yapılandırabilirsiniz:
|
Bir yazılım tuşuna XML uygulaması ekleme
Kullanıcıların servise kolayca erişebilmeleri için sık kullanılan uygulamaları yazılım tuşlarına ekleyin.
Başlamadan önce
XML Uygulama Hizmeti düzgün bir şekilde yapılandırılmıştır.
| 1 |
Telefon yönetimi web sayfasına erişin. |
| 2 |
seçin. |
| 3 |
Programlanabilir Yazılım Tuşları bölümünde Programlanabilir Yazılım Tuşu Etkin leştir'i Evet olarak ayarlayın. Bu parametreyi yapılandırma dosyasında da yapılandırabilirsiniz (cfg.xml). Bu formatta bir dize girin:
|
| 4 |
Programlanabilir Yazılım Tuşları bölümünde, PSK1'in mevcut alanlarını PSK16'ya şu biçimde düzen leyin: fnc=xml;url=<xml_app_path>;nme=<app_name>
burada
Örnek
Bu parametreyi yapılandırma dosyasında da yapılandırabilirsiniz (cfg.xml). Bu formatta bir dize girin:
burada n, yazılım tuşu numarasıdır. |
| 5 |
Tüm Değişiklikleri Kaydet'e tıklayın. |
Satır anahtarına XML uygulaması ekleme
Kullanıcıların hizmetlere kolayca erişebilmesi için sık kullanılan uygulamaları satır tuşlarına ekleyin.
Başlamadan önce
XML Uygulama Hizmeti düzgün bir şekilde yapılandırılmıştır.
| 1 |
Telefon yönetimi web sayfasına erişin. |
| 2 |
seçin. |
| 3 |
Bir satır tuşu seçin. |
| 4 |
Uzantıyı devre dışı bırakmak için Extension parametresini Devre Dışı olarak ayarlayın. Doğrudan PLK Yapılandırması özelliği devre dışı bırakılmışsa, satır 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ı etkin leştirme. |
| 5 |
Gen işletilmiş İşlev parametresinde, şu biçimde bir dize girin: fnc=xml;url=<xml_app_path>;nme=<app_name>
burada
Örnek
Bu parametreyi yapılandırma dosyasında da yapılandırabilirsiniz (cfg.xml). Bu formatta bir dize girin:
burada n uzantı numarasıdı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şkenleri kullanabilirsiniz. Aşağıdaki makro değişkenleri desteklenir:
-
Kullanıcı Kimliği—UID1, UID2'den UIDn'ye
-
Görünen adı—DisplayName1, DISPLAYNAME2 - DisplayNamen
-
Kimlik Doğrulama Kimliği—AUTHID1, AUTHID2 - AuthIDN
-
Proxy—Proxy1, PROXY2'den ProxyN'e
-
Küçük harf altıgen rakamları kullanan MAC Adresi — MA
-
Ürün adı—PN
-
Ürün Serisi Numarası — PSN
-
Seri Numarası—Serial_Number
| Makro Adı | Makro Genişletme |
|---|---|
| $ | $$ formu tek bir $ karakterine genişler. |
| A'dan P'ye | GPP_P üzerinden genel amaçlı parametreler GPP_A ile değiştirilir. |
| SD üzerinden SA | GPP_SD aracılığıyla özel amaçlı parametreler GPP_SA ile değiştirilir. Bu parametreler, provizyonda kullanılan anahtarları veya parolaları
tutar. $SA ile $SD, isteğe bağlı resync URL niteleyicisi --key için bağımsız değişkenler olarak tanınır. |
| MA | Küçük harf altıgen rakamları kullanan MAC adresi (000e08aabbcc). |
| MAU | Büyük harf altıgen basamakları kullanan MAC adresi (000E08AABBCC). |
| MAC | Altıgen basamak çiftlerini ayırmak için çift noktalı küçük altıgen basamakları kullanan MAC adresi (00:0 e:08:aa:bb:cc). |
| PN | Ürün Adı; örneğin, Görüntülü Telefon 8875, Masa Telefonu 9851. |
| PSN | Ürün Seri Numarası; örneğin, 8875, 9841, 9861 |
| SN | Seri Numarası dizesi; örneğin, 88012BA01234. |
| CCERT | SSL İstemci Sertifikası durumu, yüklü veya yüklü değil. |
| IP | Telefonun yerel alt ağı içindeki IP adresi; örneğin, 192.168.1.100. |
| EXTIP | İnternette görüldüğü gibi telefonun harici IP'si; örneğin, 66.43.16.52. |
|
SWVER |
Yazılım sürümü dizesi. Örneğin, PHONEOS.3-2-1-0104-37 |
|
HWVER |
Donanım sürümü dizesi. Örneğin, 2.0.1 |
|
PRVST |
Sağlama Durumu (sayısal bir dize): -1 = açık yeniden senkronizasyon isteği 0 = güç yeniden senkronizasyonu 1 = periyodik yeniden senkronizasyon 2 = yeniden senkronizasyon başarısız oldu, yeniden deneme denemesi |
|
UPGST |
Yükseltme Durumu (sayısal bir dize): 1 = ilk yükseltme denemesi 2 = yükseltme başarısız oldu, yeniden deneme denemesi |
|
UPGERR |
Önceki yükseltme denemesinin sonuç iletisi (ERR); örneğin http_get başarısız oldu. |
|
PRVTMR |
Son yeniden senkronizasyon denemesinden bu yana saniyeler. |
|
UPGTMR |
Son yükseltme denemesinden bu yana saniyeler. |
|
REGTMR1 |
Satır 1'in SIP sunucusuna kaydı kaybetmesinden bu yana saniyeler geçti. |
|
REGTMR2 |
Satır 2'nin SIP sunucusuna kaydı kaybetmesinden bu yana saniyeler geçti. |
|
UPGCOND |
Eski makro adı. |
|
SCHEME |
Yeniden eşzamanlama veya yükseltme URL'sini ayrıştırdıktan sonra elde edilen TFTP, HTTP veya HTTPS'den biri olan dosya erişim şeması. |
|
SERV |
Yeniden senkronizasyon veya yükseltme URL'sini ayrıştırdıktan sonra elde edilen hedef sunucu ana bilgisayar adını isteyin. |
|
SERVIP |
Yeniden eşzamanlama veya yükseltme URL'sini ayrıştırdıktan sonra, muhtemelen DNS aramasını takiben elde edilen hedef sunucu IP adresini isteyin. |
|
PORT |
Yeniden senkronizasyon veya yükseltme URL'sini ayrıştırdıktan sonra elde edilen hedef UDP/TCP bağlantı noktasını isteyin. |
|
PATH |
Yeniden senkronizasyon veya yükseltme URL'sini ayrıştırdıktan sonra elde edilen hedef dosya yolunu isteyin. |
|
ERR |
Yeniden senkronizasyon veya yükseltme girişiminin sonuç mesajı. Yalnızca sonuç syslog mesajlarının oluşturulmasında kullanışlıdır. Yükseltme denemeleri durumunda değer UPGERR değişkeninde korunur. |
|
UIDn |
Line n userID yapılandırma parametresinin içeriği. |
| ISCUST |
Birim özelleştirilmişse, değer=1, aksi takdirde 0. Özelleştirme durumu Web UI Bilgileri sayfasında görüntülenebilir. |
| INCOMINGNAME | İlk bağlanan, çalan veya gelen aramayla ilişkili ad. |
| REMOTENUMBER |
İlk bağlanan, çalan veya gelen aramanın telefon numarası. Birden fazla çağrı varsa, bulunan ilk aramayla ilişkili veriler sağlanır. |
| Görüntü İsimleri | Satır N Görüntü Adı yapılandırma parametresinin içeriği. |
| Kimlik DoğrulamaIDN | Line N auth ID yapılandırma parametresinin içeriği. |