- ホーム
- /
- 投稿記事
XML アプリケーション設定 (BroadWorks 環境の電話用)
このヘルプ記事は、Cisco BroadWorks に登録されている Cisco Desk Phone 9800 シリーズおよび Cisco Video Phone 8875 を対象にしています。 この記事で、サポートされている XML オブジェクト、URI、電話のウェブページでの XSI サービスの設定手順を確認してください。
概要
XML サービス インターフェイス (XSI) は、アプリケーションと電話システム間の通信を可能にするプロトコルです。 サポートされている XML オブジェクト と URI を使用して、電話に独自の XSI サービスを追加できます。
電話をサービスに登録した後、ユーザは次の場所に移動して、電話で設定されたすべてのサービスにアクセスできます。
。 Cisco XML サービス が既定の名前です。名前は変更することもできます。ユーザが簡単にアクセスできるようにするために、XML アプリケーションをソフトキーまたは回線キーに追加できます。サポートされている機能は次のとおりです。
- メッセージ (画像およびテキスト)
- ページング
サポートされている XML オブジェクト
-
CiscoIPPhoneMenu
-
CiscoIPPhoneText
-
CiscoIPPhoneInput
-
CiscoIPPhoneDirectory
-
CiscoIPPhoneImage
-
CiscoIPPhoneImageFile
-
CiscoIPPhoneIconMenu
-
CiscoIPPhoneIconFile メニュー
-
CiscoIPPhoneStatus (9841 を除く)
-
CiscoIPPhoneStatusFile (9841 を除く)
-
CiscoIPPhoneExecute
サポートされている URI
-
Device
-
ダイヤル
-
EditDail
-
Init
-
キー
-
再生 (着信音のみ)
-
ソフトキー
XSI サービス設定の詳細については、次を参照してください。 Cisco Unified IP Phone サービス アプリケーション開発メモ。
XML サービスに接続するための電話の設定
1 |
電話管理のウェブページにアクセスします。 |
2 |
を選択します。 |
3 |
[ XML サービス セクションで、 XML アプリケーションサービス名 および XML アプリケーション サービスの URL パラメータの定義を次に示します。 XML サービスのパラメータ。 |
4 |
(オプション) アプリケーションサービスへのアクセスに認証を追加するには、これらのフィールドを設定します: XML ユーザ名、 XML パスワード、 CISCO XML EXE の有効化、および CISCO XML EXE 認証モード。 |
5 |
クリック すべての変更を保存。 |
XML サービスのパラメータ
以下の表では、 XML サービス セクション タブを選択します。 また、パラメータを設定するために、XML コードを含む電話設定ファイルに追加される文字列のシンタックスも定義します。
パラメータ |
デフォルトおよびオプション |
説明 |
---|---|---|
XML アプリケーション サービス名(XML Application Service Name) |
デフォルト:空 |
XML アプリケーションの名前。 ウェブアプリケーションの選択肢として電話機に名前が表示されます。 次の形式で文字列を入力することによって、設定ファイル (cfg.xml) でこのパラメータを設定することができます。
|
XMLアプリケーションサービスURL(XML Application Service URL) |
デフォルト:空 |
XML アプリケーションが配置されているURL 次の形式で文字列を入力することによって、設定ファイル (cfg.xml) でこのパラメータを設定することができます。
マクロ変数は XML URL でサポートされています。 有効なマクロ変数については、次を参照してください。 XML URL でサポートされているマクロ変数。 HTTP または HTTPS プロトコルのみが URL でサポートされています。 |
XMLユーザー名(XML User Name) |
デフォルト:空 |
認証を目的としたXMLサービスのユーザ名。 次の形式で文字列を入力することによって、設定ファイル (cfg.xml) でこのパラメータを設定することができます。
|
XMLパスワード(XML Password) |
デフォルト:空 |
指定された XML ユーザ名の XML サービスパスワード。 このフィールドに入力したパスワードは、構成ファイル (cfg.xml) に次のように表示されます:
|
CISCO XML EXE 有効 |
デフォルト:[いいえ(No)] オプション:はい、いいえ |
XML アプリケーションサーバにアクセスするために認証が必要かどうかを指定します。 次の形式で文字列を入力することによって、設定ファイル (cfg.xml) でこのパラメータを設定することができます。
|
CISCO XML EXE 認証モード |
デフォルト: ローカル資格情報 オプション: 信頼済み、ローカル資格情報、リモート資格情報 |
Cisco XML EXE の認証モードを指定します。
次の形式で文字列を入力することによって、設定ファイル (cfg.xml) でこのパラメータを設定することができます。
|
XML アプリケーションをソフトキーに追加する
頻繁に使用するアプリケーションをソフトキーに追加して、ユーザが簡単にサービスにアクセスできるようにします。
はじめる前に
XML アプリケーション サービスが適切に設定されました。
1 |
電話管理のウェブページにアクセスします。 |
2 |
を選択します。 |
3 |
[プログラム可能なソフトキー(Programmable Softkeys)] セクションで、[プログラム可能なソフトキー有効(Programmable Softkey Enable)] を [はい(Yes)] に設定します。 このパラメータは、設定ファイル(cfg.xml)でも設定できます。 次の形式で文字列を入力します。
|
4 |
[ プログラム可能なソフトキー セクションで利用可能なフィールドを編集します PSK1 に PSK16 この形式: fnc=xml;url=<xml_app_path> ;nme=<app_name>
ここで
例 このパラメータは、設定ファイル(cfg.xml)でも設定できます。 次の形式で文字列を入力します。
ここで n はソフトキーの番号です。 |
5 |
クリック すべての変更を保存。 |
XML アプリケーションを回線キーに追加する
頻繁に使用するアプリケーションを回線キーに追加して、ユーザがサービスに簡単にアクセスできるようにします。
はじめる前に
XML アプリケーション サービスが適切に設定されました。
1 |
電話管理のウェブページにアクセスします。 |
2 |
を選択します。 |
3 |
ライン キーを選択します。 |
4 |
[内線(Extension)] パラメータを [無効(Disabled)] に設定して、内線を無効にします。 直接 PLK 設定機能を無効にした場合、ラインキーに拡張機能を追加するために内線を無効にする必要があります。 機能が有効な場合は、この手順をスキップできます。 詳細については、次を参照してください。 直接 PLK 構成を有効にする。 |
5 |
[拡張機能(Extended Function)] パラメータに、次の形式で文字列を入力します。 fnc=xml;url=<xml_app_path> ;nme=<app_name>
ここで
例 このパラメータは、設定ファイル(cfg.xml)でも設定できます。 次の形式で文字列を入力します。
nは内線番号です。 |
6 |
クリック すべての変更を保存。 |
XML URL でサポートされているマクロ変数
XML URL でマクロ変数を使用することができます。 次のマクロ変数がサポートされています。
-
ユーザー ID:UID1、UID2 ~ UIDn
-
表示名:DISPLAYNAME1、DISPLAYNAME2 ~ DISPLAYNAMEn
-
認証 ID:AUTHID1、AUTHID2 ~ AUTHIDn
-
プロキシ:PROXY1、PROXY2 ~ PROXYn
-
小文字の 16 進数を使用した MAC アドレス:MA
-
製品名:PN
-
製品シリアル番号:PSN
-
シリアル番号:SERIAL_NUMBER
マクロ名 | マクロ展開 |
---|---|
$ | $$ 形式は、単一の $ 文字に展開されます。 |
A ~ P | 汎用パラメータ GPP_A ~ GPP_P で置き換えられます。 |
SA ~ SD | 特殊用途のパラメータ GPP_SA ~ GPP_SD で置き換えられます。 これらのパラメータには、プロビジョニングで使用されるキーまたはパスワードが保持されます。 $SA ~ $SD は、オプションの resync URL 修飾子 --key を引数として認識されます。 |
MA | 小文字の 16 進数を使用した MAC アドレス(000e08aabbcc)。 |
MAU | 大文字の 16 進数を使用した MAC アドレス(000E08AABBCC)。 |
MAC | 小文字の 16 進数を使用し、16 進数ペアがコロンで区切られた MAC アドレス(00:0e:08:aa:bb:cc)。 |
PN | 製品名;たとえば、ビデオ電話 8875、デスク フォン 9851 などです。 |
PSN | 製品シリーズ番号;例: 8875、9841、9861 |
SN | シリアル番号の文字列。88012BA01234 など。 |
CCERT | SSL クライアント証明書のステータス(インストール済みまたは未インストール)。 |
IP | ローカル サブネット内の電話機の IP アドレス。192.168.1.100 など。 |
EXTIP | インターネットで表示される、電話機の外部 IP。66.43.16.52 など。 |
SWVER |
ソフトウェア バージョン文字列。 たとえば、 PHONEOS.3-2-1-0104-37 |
HWVER |
ハードウェアのバージョン文字列 2.0.1 など。 |
PRVST |
プロビジョニングの状態(数値文字列) -1 = 明示的な再同期要求 0 = 電源投入再同期 1 = 定期的な再同期 2 = 再同期の失敗、再試行 |
UPGST |
アップグレードの状態(数値文字列) 1 = 最初のアップグレード試行 2 = アップグレードの失敗、再試行 |
UPGERR |
前回のアップグレード試行の結果メッセージ(ERR)。http_get failed など。 |
PRVTMR |
最後の再同期から経過した秒数。 |
UPGTMR |
最後のアップグレード試行から経過した秒数。 |
REGTMR1 |
SIP サーバで回線 1 が登録解除されてから経過した秒数。 |
REGTMR2 |
SIP サーバで回線 2 が登録解除されてから経過した秒数。 |
UPGCOND |
レガシーのマクロ名。 |
SCHEME |
再同期またはアップグレード URL の解析後に取得される TFTP、HTTP、または HTTPS のいずれかのファイル アクセス スキーム。 |
SERV |
再同期またはアップグレード URL の解析後に取得される、要求ターゲット サーバのホスト名。 |
SERVIP |
おそらく DNS ルックアップの後、再同期またはアップグレード URL の解析後に取得される、要求ターゲット サーバの IP アドレス。 |
PORT |
再同期またはアップグレード URL の解析後に取得される、要求ターゲット UDP/TCP ポート。 |
PATH |
再同期またはアップグレード URL の解析後に取得される、要求ターゲット ファイル パス。 |
ERR |
再同期またはアップグレード試行の結果のメッセージ。 結果の syslog メッセージを生成するときにのみ役立ちます。 アップグレード試行の場合、UPGERR 変数の値は保持されます。 |
UIDn |
回線 n の UserID 設定パラメータの内容。 |
ISCUST |
ユニットがカスタマイズされている場合、値は 1。それ以外の場合は 0。 カスタマイズの状況はウェブ UI 情報ページで確認できます。 |
INCOMINGNAME | 最初の接続、呼び出し、または着信コールに関連付けられた名前。 |
REMOTENUMBER |
最初の接続、呼び出し、または着信コールの電話番号。 複数のコールがある場合は、最初に見つかったコールに関連付けられているデータが渡されます。 |
DISPLAYNAMEn | 回線 N の表示名設定パラメータの内容。 |
AUTHIDn | 回線 N の認証 ID 設定パラメータの内容。 |