- ホーム
- /
- 投稿記事
9800と8875の電話機用のXMLアプリケーション構成(ブロードワークス)
このヘルプ記事は、Cisco BroadWorksに登録されているシスコデスクフォン9800シリーズとシスコビデオフォン8875に適用されます。サポートされているXMLオブジェクト、URI、および電話のWebページでXSIサービスを設定する手順については、この記事を読んでください。
概要
XMLサービスインターフェイス(XSI)は、 アプリケーションと電話システム間の通信を可能にするプロトコルです。 サポートされているXMLオブジェクトとURIを使用して、独自のXSIサービスを携帯電話に追加できます。
電話をサービスに登録すると、ユーザーは 。 Cisco XMLサービスはデフォルトの名前です。 名前を変更することもできます。 ユーザーが簡単にアクセスできるように、XMLアプリケーションをソフトキーまたはラインキーに追加できます。
サポートされている機能は次のとおりです。
- メッセージ(画像とテキスト)
- ページング
サポートされている XML オブジェクト
-
シスコの IP 電話メニュー
-
シスコIPフォンのテキスト
-
シスコの IP 電話入力
-
シスコの IP 電話ディレクトリ
-
シスコIPフォンの画像
-
シスコ IP フォンのイメージファイル
-
Cisco IPフォンのアイコンメニュー
-
Cisco IPフォンのアイコンファイルメニュー
-
シスコIPフォンのステータス(9811と9841を除く)
-
シスコ IP 電話ステータスファイル(9811と9841を除く)
-
シスコ IP フォンエグゼキュート
サポートされている URI
-
デバイス
-
ダイヤル
-
エディットデイル
-
初期化
-
キー
-
再生 (着信音のみ)
-
ソフトキー
XSIサービス構成の詳細については、Cisco Unified IP電話サービスアプリケーション開発ノートを参照してください。
XMLサービスに接続するように電話を設定してください
| 1 |
電話管理ウェブページにアクセスしてください。 |
| 2 |
。 |
| 3 |
XMLサービスセクションで、XMLサービスのパラメータで定義されているXMLアプリケーションサービス名とXMLアプリケーションサービスのURLパラメータを設定します。 |
| 4 |
(オプション)アプリケーションサービスにアクセスするための認証を追加するには、「XMLユーザー名」、「XMLパスワード」、「CISCO XML EXE Enable」、および「CISCO XML EXE 認証モード」の各フィールドを設定します。 |
| 5 |
[すべての変更を保存] をクリックします。 |
XML サービスのパラメーター
次の表は、電話Webインターフェイスの「」タブにあるXMLサービスセクションのXMLアプリケーションパラメータの機能と使用方法を定義しています。 また、パラメータを設定するためにXMLコードを使用して電話設定ファイル(cfg.xml)に追加される文字列の構文も定義します。
|
パラメーター |
デフォルトとオプション |
説明 |
|---|---|---|
|
XML アプリケーションサービス名 |
デフォルト:空です |
XMLアプリケーションの名前。 名前はウェブアプリケーションの選択肢として電話に表示されます。 次の形式の文字列を入力して、電話設定のXMLファイル(cfg.xml)にこのパラメータを設定することもできます。
|
|
XMLアプリケーションサービスのURL |
デフォルト:空です |
XMLアプリケーションが置かれているURL。 次の形式の文字列を入力して、電話設定のXMLファイル(cfg.xml)にこのパラメータを設定することもできます。
マクロ変数はXML URLでサポートされています。 有効なマクロ変数については、XML URLでサポートされているマクロ変数を参照してください。 URLでは、HTTPまたはHTTPSプロトコルのみがサポートされています。 |
|
XML ユーザー名 |
デフォルト:空です |
認証用のXMLサービスのユーザー名。 次の形式の文字列を入力して、電話設定のXMLファイル(cfg.xml)にこのパラメータを設定することもできます。
|
|
XML パスワード |
デフォルト:空です |
指定されたXMLユーザー名のXMLサービスパスワード。 このフィールドに入力したパスワードは、設定ファイル(cfg.xml)に次のように表示されます。
|
|
シスコ XML EXE イネーブル |
デフォルト:いいえ オプション:はい、いいえ |
XMLアプリケーションサーバーへのアクセスに認証が必要かどうかを指定します。 次の形式の文字列を入力して、電話設定のXMLファイル(cfg.xml)にこのパラメータを設定することもできます。
|
|
シスコ XML EXE 認証モード |
デフォルト:ローカル認証情報 オプション:信頼できる、ローカル認証情報、リモート認証情報 |
Cisco XML EXE の認証モードを指定します。
次の形式の文字列を入力して、電話設定のXMLファイル(cfg.xml)にこのパラメータを設定することもできます。
|
XMLアプリケーションをソフトキーに追加してください
ユーザーがサービスに簡単にアクセスできるように、頻繁に使用するアプリケーションをソフトキーに追加します。
始める前に
XMLアプリケーションサービスは正しく構成されています。
| 1 |
電話管理ウェブページにアクセスしてください。 |
| 2 |
。 |
| 3 |
「プログラマブルソフトキー」セクションで、「 プログラマブルソフトキーを有効にする」を「はい」に設定します。 このパラメータは、設定ファイル(cfg.xml)で設定することもできます。 この形式で文字列を入力してください:
|
| 4 |
プログラマブルソフトキーセクションで、PSK1からPSK16までの使用可能なフィールドを次の形式で編集します。 fnc=xml;url=<xml_app_path>;nme=<app_name>
ここで、
例fnc=xml このパラメータは、設定ファイル(cfg.xml)で設定することもできます。 この形式で文字列を入力してください:
ここで、nはソフトキー番号です。 |
| 5 |
[すべての変更を保存] をクリックします。 |
ラインキーにXMLアプリケーションを追加します
ユーザーがサービスに簡単にアクセスできるように、頻繁に使用するアプリケーションをラインキーに追加します。
始める前に
XMLアプリケーションサービスは正しく構成されています。
| 1 |
電話管理ウェブページにアクセスしてください。 |
| 2 |
。 |
| 3 |
ラインキーを選択してください。 |
| 4 |
拡張機能を無効にするには、拡張パラメータを無効に設定してください。 ダイレクトPLK設定機能が無効になっている場合は、ラインキーに拡張機能を追加するために拡張機能を無効にする必要があります。 この機能が有効になっている場合は、この手順をスキップできます。 詳細については、「ダイレクト PLK 構成を有効にする」を参照してください。 |
| 5 |
「拡張機能」パラメータに、次の形式の文字列を入力します。 fnc=xml;url=<xml_app_path>;nme=<app_name>
ここで、
例fnc=xml このパラメータは、設定ファイル(cfg.xml)で設定することもできます。 この形式で文字列を入力してください:
ここで、nは内線番号です。 |
| 6 |
[すべての変更を保存] をクリックします。 |
XML URLでサポートされているマクロ変数
XML URLではマクロ変数を使用できます。 次のマクロ変数がサポートされています。
-
ユーザーID — UID1、UID2からUIDNへ
-
表示名—表示名1、表示名2から表示名へ
-
認証ID—認証ID1、認証番号2から認証IDN
-
プロキシ — プロキシ1、プロキシ2からプロキシNへ
-
小文字の16進数を使用したMACアドレス — MA
-
商品名—PN
-
製品シリーズ番号—PSN
-
シリアル番号—シリアル番号
| マクロ名 | マクロ拡張 |
|---|---|
| $ | $$という形式は、単一の $ 文字に展開されます。 |
| AからPまで | GPP_AからGPP_Pまでの汎用パラメータに置き換えられました。 |
| SA から SD まで | GPP_SAからGPP_SDまでの特殊用途パラメータに置き換えられました。 これらのパラメータには、
プロビジョニングに使用されるキーまたはパスワードが格納されます。 $SAから$SDは、 オプションの再同期URL修飾子--keyの引数として認識されます。 |
| MA | 小文字の16進数字 (000e08aabbcc)を使用したMACアドレス。 |
| MAU | 大文字の16進数を使用したMACアドレス(000E08AABBCC)。 |
| MAC | 小文字の16進数でコロンを使用して16進数のペアを区切るMACアドレス(00:0 e: 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が失敗しました。 |
|
PRVTMR |
最後に再同期を試みてからの秒数。 |
|
UPGTMR |
前回アップグレードを試みてからの秒数。 |
|
REGTMR1 |
ライン1がSIPサーバーへの登録を失ってからの秒数。 |
|
REGTMR2 |
2行目がSIPサーバーへの登録を失ってからの秒数。 |
|
UPGCOND |
レガシーマクロ名。 |
|
SCHEME |
再同期またはアップグレードURLを解析した後に取得された、TFTP、HTTP、またはHTTPSのいずれかのファイルアクセススキーム。 |
|
SERV |
再同期またはアップグレードURLを解析した後に取得された、ターゲットサーバーのホスト名をリクエストしてください。 |
|
SERVIP |
再同期またはアップグレードURLを解析した後、場合によってはDNSルックアップ後に取得された、ターゲットサーバーのIPアドレスをリクエストしてください。 |
|
PORT |
再同期またはアップグレードURLを解析した後に取得した、ターゲットのUDP/TCPポートをリクエストしてください。 |
|
PATH |
再同期またはアップグレードURLを解析した後に取得された、ターゲットファイルのパスをリクエストしてください。 |
|
ERR |
再同期またはアップグレードの試行の結果メッセージ。 結果のsyslogメッセージを生成する場合にのみ役に立ちます。 アップグレードを試みた場合、値はUPGERR変数に保存されます。 |
|
UIDN |
Line n userId設定パラメータの内容。 |
| ISCUST |
ユニットがカスタマイズされている場合はvalue=1、そうでない場合は0です。 カスタマイズのステータスは、Web UIの情報ページで見ることができます。 |
| INCOMINGNAME | 初めて接続した通話、呼び出し中の通話、または着信時の名前。 |
| REMOTENUMBER |
最初に接続したときの電話番号、呼び出し中の電話番号、または着信時の電話番号。 複数の通話がある場合は、最初に見つかった通話に関連するデータが提供されます。 |
| ディスプレイネーム | N行目の表示名設定パラメータの内容。 |
| 認証情報 | Line Nの認証ID設定パラメータの内容。 |