この記事の内容
dropdown icon
概要
    サポートされている XML オブジェクト
    サポートされている URI
XMLサービスに接続するように電話を設定してください
XML サービスのパラメーター
XMLアプリケーションをソフトキーに追加してください
ラインキーにXMLアプリケーションを追加します
XML URLでサポートされているマクロ変数

9800と8875の電話機用のXMLアプリケーション構成(ブロードワークス)

list-menuこの記事の内容
list-menuフィードバックがある場合

このヘルプ記事は、Cisco BroadWorksに登録されているシスコデスクフォン9800シリーズとシスコビデオフォン8875に適用されます。サポートされているXMLオブジェクト、URI、および電話のWebページでXSIサービスを設定する手順については、この記事を読んでください。

概要

XMLサービスインターフェイス(XSI)は、 アプリケーションと電話システム間の通信を可能にするプロトコルです。 サポートされているXMLオブジェクトとURIを使用して、独自のXSIサービスを携帯電話に追加できます。

電話をサービスに登録すると、ユーザーは [設定] > [ネットワークとサービス] > [Cisco XMLサービス] に移動して、電話に設定されているすべてのサービスにアクセスできます。 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)に追加される文字列の構文も定義します。

テーブル 1.XML サービスのパラメーター

パラメーター

デフォルトとオプション

説明

XML アプリケーションサービス名

デフォルト:空です

XMLアプリケーションの名前。 名前はウェブアプリケーションの選択肢として電話に表示されます。

次の形式の文字列を入力して、電話設定のXMLファイル(cfg.xml)にこのパラメータを設定することもできます。

<XML_Application_Service_Name
ua="na">XML APP Name</XML_Application_Service_Name>

XMLアプリケーションサービスのURL

デフォルト:空です

XMLアプリケーションが置かれているURL。

次の形式の文字列を入力して、電話設定のXMLファイル(cfg.xml)にこのパラメータを設定することもできます。

<XML_Application_Service_URL
ua="na">https://server.com/path/app.xml</XML_Application_Service_URL>

マクロ変数はXML URLでサポートされています。 有効なマクロ変数については、XML URLでサポートされているマクロ変数を参照してください。

URLでは、HTTPまたはHTTPSプロトコルのみがサポートされています。

XML ユーザー名

デフォルト:空です

認証用のXMLサービスのユーザー名。

次の形式の文字列を入力して、電話設定のXMLファイル(cfg.xml)にこのパラメータを設定することもできます。

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

XML パスワード

デフォルト:空です

指定されたXMLユーザー名のXMLサービスパスワード。

このフィールドに入力したパスワードは、設定ファイル(cfg.xml)に次のように表示されます。

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

シスコ XML EXE イネーブル

デフォルト:いいえ

オプション:はい、いいえ

XMLアプリケーションサーバーへのアクセスに認証が必要かどうかを指定します。

次の形式の文字列を入力して、電話設定のXMLファイル(cfg.xml)にこのパラメータを設定することもできます。

<CISCO_XML_EXE_Enable ua="na">Yes</CISCO_XML_EXE_Enable>

シスコ XML EXE 認証モード

デフォルト:ローカル認証情報

オプション:信頼できる、ローカル認証情報、リモート認証情報

Cisco XML EXE の認証モードを指定します。

  • 信頼できます。ローカルの資格情報に関係なく、認証は行われません。

  • ローカル資格情報-認証は、ローカル資格情報を使用したダイジェスト認証に基づいています(設定されている場合)。 ローカル資格情報が設定されていない場合、認証は実行されません。

  • リモート認証情報-認証は、WebページのXMLアプリケーション(XMLアプリケーションサーバーにアクセスするため)に設定されているリモート資格情報を使用したダイジェスト認証に基づいています。

次の形式の文字列を入力して、電話設定のXMLファイル(cfg.xml)にこのパラメータを設定することもできます。

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

XMLアプリケーションをソフトキーに追加してください

ユーザーがサービスに簡単にアクセスできるように、頻繁に使用するアプリケーションをソフトキーに追加します。

始める前に

XMLアプリケーションサービスは正しく構成されています。

1

電話管理ウェブページにアクセスしてください。

2

音声 > 電話を選択します。

3

「プログラマブルソフトキー」セクションで、「 プログラマブルソフトキーを有効にする」を「はい」に設定します。

このパラメータは、設定ファイル(cfg.xml)で設定することもできます。 この形式で文字列を入力してください:

<Programmable_Softkey_Enable ua="na">Yes</Programmable_Softkey_Enable>
4

プログラマブルソフトキーセクションで、PSK1からPSK16までの使用可能なフィールドを次の形式で編集します。

fnc=xml;url=<xml_app_path>;nme=<app_name>

ここで、urlはXMLアプリケーションが保存されているリンク、nmeは電話画面上のアプリケーションの表示名です。

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

このパラメータは、設定ファイル(cfg.xml)で設定することもできます。 この形式で文字列を入力してください:

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

ここで、nはソフトキー番号です。

5

[すべての変更を保存] をクリックします。

ラインキーにXMLアプリケーションを追加します

ユーザーがサービスに簡単にアクセスできるように、頻繁に使用するアプリケーションをラインキーに追加します。

始める前に

XMLアプリケーションサービスは正しく構成されています。

1

電話管理ウェブページにアクセスしてください。

2

音声 > 電話を選択します。

3

ラインキーを選択してください。

4

拡張機能を無効にするには、拡張パラメータを無効に設定してください。

ダイレクトPLK設定機能が無効になっている場合は、ラインキーに拡張機能を追加するために拡張機能を無効にする必要があります。 この機能が有効になっている場合は、この手順をスキップできます。 詳細については、「ダイレクト PLK 構成を有効にする」を参照してください。
5

「拡張機能」パラメータに、次の形式の文字列を入力します。

fnc=xml;url=<xml_app_path>;nme=<app_name>

ここで、urlはXMLアプリケーションが保存されているリンク、nmeは電話画面上のアプリケーションの表示名です。

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

このパラメータは、設定ファイル(cfg.xml)で設定することもできます。 この形式で文字列を入力してください:

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

ここで、nは内線番号です。

6

[すべての変更を保存] をクリックします。

XML URLでサポートされているマクロ変数

XML URLではマクロ変数を使用できます。 次のマクロ変数がサポートされています。

  • ユーザーID — UID1、UID2からUIDNへ

  • 表示名—表示名1、表示名2から表示名へ

  • 認証ID—認証ID1、認証番号2から認証IDN

  • プロキシ — プロキシ1、プロキシ2からプロキシNへ

  • 小文字の16進数を使用したMACアドレス — MA

  • 商品名—PN

  • 製品シリーズ番号—PSN

  • シリアル番号—シリアル番号

テーブル 2.サポートされているマクロ
マクロ名マクロ拡張
$$$という形式は、単一の $ 文字に展開されます。
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です。
CCERTSSLクライアント証明書のステータス、インストール済みまたは未インストール。
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設定パラメータの内容。
この投稿記事は役に立ちましたか?
この投稿記事は役に立ちましたか?