Bu makalede
dropdown icon
Genel Bakış
    Desteklenen XML nesneleri
    Desteklenen URI'ler
Bir telefonu XML hizmetine bağlanacak şekilde yapılandırma
XML hizmetleri için parametreler
Bir yazılım tuşuna XML uygulaması ekleme
Satır anahtarına XML uygulaması ekleme
XML URL'lerinde desteklenen makro değişkenleri

9800 ve 8875 telefonlar için XML uygulamaları yapılandırması (BroadWorks)

list-menuBu makalede
list-menuGeri Bildirim?

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 Ayar lar> Ağ ve hizmet> Cisco XML hizmetleri'ne giderek telefondaki yapılandırılmış tüm hizmetlere 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

Ses > Telefon 'u 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 Ses > Telefon 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.

Tablo 1. XML hizmetleri için parametreler

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_Application_Service_Name
ua="na">XML APP Name</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ında (cfg.xml) bu formatta 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ında (cfg.xml) bu formatta bir dize girerek de yapılandırabilirsiniz:

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

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:

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

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_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 Bilgisi, Uzak Kimlik Bilgileri

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

  • Güvenilir—Yerel kimlik bilgilerinden bağımsız olarak kimlik doğrulama yapılmaz.

  • Yerel Kimlik Bilgileri—Kimlik doğrulama, ayarlanmışsa yerel kimlik bilgilerini kullanan özet kimlik doğrulamasına dayanır. Yerel kimlik bilgisi ayarlanmamışsa, kimlik doğrulama yapılmaz.

  • Uzak Kimlik Bilgileri—Kimlik Doğrulama, web sayfasındaki XML uygulamasında (bir XML uygulama sunucusuna erişmek için) ayarlanan uzak kimlik bilgilerini kullanan özet kimlik doğrulamasına dayanır.

Bu parametreyi telefon yapılandırma XML dosyasında (cfg.xml) bu formatta bir dize girerek de yapılandırabilirsiniz:

<CISCO_XML_EXE_Auth_Mode ua="na">Local Credential</CISCO_XML_EXE_Auth_Mode>

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

Ses > Telefon 'u 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:

<Programmable_Softkey_Enable ua="na">Yes</Programmable_Softkey_Enable>
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 url, XML uygulamasının depolandığı bağlantıdır; nme, uygulamanın telefon ekranındaki görüntülenen adıdır.

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

Bu parametreyi yapılandırma dosyasında da yapılandırabilirsiniz (cfg.xml). Bu formatta bir dize girin:

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

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

Ses > Telefon 'u 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 url, XML uygulamasının depolandığı bağlantıdır; nme, uygulamanın telefon ekranındaki görüntülenen adıdır.

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

Bu parametreyi yapılandırma dosyasında da yapılandırabilirsiniz (cfg.xml). Bu formatta bir dize girin:

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

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

Tablo 2. Desteklenen Makrolar
Makro AdıMakro Genişletme
$$$ formu tek bir $ karakterine genişler.
A'dan P'yeGPP_P üzerinden genel amaçlı parametreler GPP_A ile değiştirilir.
SD üzerinden SAGPP_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.

MAKüçük harf altıgen rakamları kullanan MAC adresi (000e08aabbcc).
MAUBüyük harf altıgen basamakları kullanan MAC adresi (000E08AABBCC).
MACAltı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
SNSeri Numarası dizesi; örneğin, 88012BA01234.
CCERTSSL İstemci Sertifikası durumu, yüklü veya yüklü değil.
IPTelefonun 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ü İsimleriSatır N Görüntü Adı yapılandırma parametresinin içeriği.
Kimlik DoğrulamaIDNLine N auth ID yapılandırma parametresinin içeriği.
Bu makale yararlı oldu mu?
Bu makale yararlı oldu mu?