電話機は XML 形式の構成を受け入れます。

このドキュメントの例では、XML 形式（XML）シンタックスを含む設定プロファイルを使用します。

電話機の詳細については、使用しているデバイスのアドミニストレーション ガイドを参照してください。 各ガイドでは、管理 Web サーバを使って設定できるパラメータについて説明しています。

設定プロファイルは、電話機のパラメータ値を定義します。

設定プロファイルの XML 形式では、標準の XML 作成ツールを使用してパラメータと値をコンパイルします。

（注）	UTF-8 文字セットのみサポートされます。 エディタでプロファイルを変更する場合は、エンコーディング形式を変更しないでください。変更すると、電話機はファイルを認識できません。

電話機ごとに機能セットが異なるため、パラメータのセットも異なります。

<flat-profile>
<Resync_On_Reset> Yes </Resync_On_Reset>
<Resync_Periodic> 7200 </Resync_Periodic>
<Profile_Rule> tftp://prov.telco.com:6900/cisco/config/CP_xxxx_MPP.cfg</Profile_Rule>
</flat-profile>

オープン設定プロファイルを圧縮してプロビジョニング サーバのネットワーク負荷を軽減できます。 プロファイルを暗号化して機密情報を保護することもできます。 圧縮は必須ではありませんが、暗号化よりも前に実行する必要があります。

XML 構成スクリプトを作成した後、適用するにはそのスクリプトを電話機に渡す必要があります。 構成を適用するには、Webブラウザを使用して TFTP、HTTP、または HTTPS サーバから設定ファイルを電話機にダウンロードするか、cURL コマンド ライン ユーティリティを使用します。

このセクションでは、機能に合わせておおまかに分類されたプロビジョニング パラメータを説明します。

次のタイプのプロビジョニング パラメータがあります。

• 汎用

• 可能

• トリガー

• 設定可能なスケジュール

• プロファイル ルール

• アップグレード ルール

以下のデータ型は、設定プロファイルのパラメータで使用されます。

• {a,b,c,…}：a、b、c… からの選択肢。

• Bool：「yes」または「no」のブール値。

• CadScript：信号のパターン パラメータを指定するミニスクリプト。 最大 127 文字。

  シンタックス：S₁[;S₂]。次の意味があります。

  • S_i=D_i(on_i,1/off_i,1[,on_i,2/off_i,2[,on_i,3/off_i,3[,on_i,4/off_i,4[,on_i,5/off_i,5[,on_i,6/off_i,6]]]]]) で、これはセクションとして知られています。

  • on_i,j および off_i,j は segment の秒単位の on/off 継続時間です。i = 1 または 2、および j = 1 ～ 6 です。

  • D_i は、セクションの合計継続時間（秒単位）です。

  すべての継続時間には、1 ミリ秒単位の精度を実現するため、小数点以下第 3 位まで含めることができます。 ワイルドカード文字 “*” は無期限を意味します。 セクション内のセグメントは順番に実行され、合計時間が実行されるまで繰り返されます。

  例 1：

  
  60(2/4)
  
  Number of Cadence Sections = 1
  Cadence Section 1: Section Length = 60 s
  Number of Segments = 1
  Segment 1: On=2s, Off=4s
  
  Total Ring Length = 60s
  
  

  例 2：特殊呼び出し音（短、短、短、長）

  
  60(.2/.2,.2/.2,.2/.2,1/4)
  
  Number of Cadence Sections = 1
  Cadence Section 1: Section Length = 60s
  Number of Segments = 4
  Segment 1: On=0.2s, Off=0.2s
  Segment 2: On=0.2s, Off=0.2s
  Segment 3: On=0.2s, Off=0.2s
  Segment 4: On=1.0s, Off=4.0s
  
  Total Ring Length = 60s
  
  

• DialPlanScript：回線 1 と回線 2 のダイヤル プランを指定するために使用するスクリプト シンタックス。

• Float<n>：小数点以下第 n 位までを含む浮動小数点値。

• FQDN：完全修飾ドメイン名 加入者 ID には最大 63 文字を指定できます。 例は次のとおりです。

  • sip.Cisco.com:5060 または 109.12.14.12:12345

  • sip.Cisco.com または 109.12.14.12

• FreqScript：トーンの周波数とレベル パラメータを指定するミニスクリプト。 最大 127 文字です。

  シンタックス：F₁@L₁[,F₂@L₂[,F₃@L₃[,F₄@L₄[,F₅@L₅[,F₆@L₆]]]]]。次の意味があります。

  • F₁ ～ F₆ は Hz 単位の周波数（符号なし整数のみ）です。

  • L₁ ～ L₆ は、dBm 単位の対応レベル（小数点以下第 1 位までを含む）です。

  コンマの前後に空白は使用できますが、推奨されません。

  例 1：コール ウェイティング トーン

  
  440@-10
  
  Number of Frequencies = 1
  Frequency 1 = 440 Hz at –10 dBm
  
  

  例 2：ダイヤル トーン

  
  350@-19,440@-19
  
  Number of Frequencies = 2
  Frequency 1 = 350 Hz at –19 dBm
  Frequency 2 = 440 Hz at –19 dBm
  

• IP： x.x.x.x 形式の有効な IPv4 アドレス。x は 0 ～ 255 です。例：10.1.2.100。

• UserID：URL に表示されるユーザー ID。最大 63 文字です。

• 電話：14081234567、*69、*72、345678 などの電話番号文字列。または 1234@10.10.10.100:5068 や jsmith@Cisco.com などの一般的な URL。 文字列には最大 39 文字を含めることができます。

• PhTmplt：電話番号テンプレート。 各テンプレートには、コンマ（,）で区切られた 1 つ以上のパターンを含めることができます。 各パターンの先頭の空白は無視されます。 「?」と「*」はワイルドカード文字を表します。 文字どおり表すには、%xx を使用します。 たとえば、%2a は * を表します。 テンプレートには最大 39 文字を含めることができます。 例：“1408*、1510*”、“1408123????, 555?1.”。

• Port：TCP/UDP ポート番号（0 ～ 65535）。 これは 10 進数または 16 進数形式で指定できます。

• ProvisioningRuleSyntax：設定の再同期とファームウェア アップグレード ルールを定義するために使用するスクリプト シンタックス。

• PwrLevel：–小数点以下第 1 位を含む、dBm 単位で表されるパワー レベル。13.5 や 1.5（dBm）など。

• RscTmplt：SIP 応答ステータス コードのテンプレート。“404, 5*”、“61?”、“407、408、487、481”。 加入者 ID には最大 39 文字を指定できます。

• Sig<n>：署名付き n ビット値。 これは 10 進数または 16 進数形式で指定できます。 「-」符号を負の値の前に付ける必要があります。 正の値の前の「+」符号はオプションです。

• Star Codes：* 69 などの補足サービス用アクティベーション コード。 コードには最大 7 文字を含めることができます。

• Str<n>：最大 n 文字の非予約文字。

• Time<n>：小数点以下第 n 位までを含む秒単位の継続時間。 追加で指定した小数点以下の桁は無視されます。

• ToneScript：コールプログレストーンの周波数、レベル、パターン パラメータを指定するミニスクリプト。 スクリプトには最大 127 文字を指定できます。

  シンタックス：FreqScript;Z₁[;Z₂]。

  セクション Z₁ は CadScript の S₁ セクションと似ていますが、各 on/off セグメントの後に周波数コンポーネント パラメータが続く点が異なります。Z₁ = D₁(on_i,1/off_i,1/f_i,1[,on_i,2/off_i,2/f_i,2 [,on_i,3/off_i,3/f_i,3 [,on_i,4/off_i,4/f_i,4 [,on_i,5/off_i,5/f_i,5 [,on_i,6/off_i,6/f_i,6]]]]])。次の意味があります。

  • f_i,j = n₁[+n₂]+n₃[+n₄[+n₅[+n₆]]]]]。

  • 1 < n_k < 6 は、そのセグメントで使用される FreqScript 内の周波数コンポーネントを指定します。

  1 つのセグメントで複数の周波数コンポーネントが使用されている場合、コンポーネントは合計されます。

  例 1：ダイヤル トーン：

  
  350@-19,440@-19;10(*/0/1+2)
  
  Number of Frequencies = 2
  Frequency 1 = 350 Hz at –19 dBm
  Frequency 2 = 440 Hz at –19 dBm
  Number of Cadence Sections = 1
  Cadence Section 1: Section Length = 10 s
  Number of Segments = 1
  Segment 1: On=forever, with Frequencies 1 and 2
  
  Total Tone Length = 10s
  
  

  例 2：断絶トーン：

  
  350@-19,440@-19;2(.1/.1/1+2);10(*/0/1+2)
  
  Number of Frequencies = 2
  Frequency 1 = 350 Hz at –19 dBm
  Frequency 2 = 440 Hz at –19 dBm
  Number of Cadence Sections = 2
  Cadence Section 1: Section Length = 2s
  Number of Segments = 1
  Segment 1: On=0.1s, Off=0.1s with Frequencies 1 and 2
  Cadence Section 2: Section Length = 10s
  Number of Segments = 1
  Segment 1: On=forever, with Frequencies 1 and 2
  
  Total Tone Length = 12s
  
  

• Uns<n>：符号なし n ビット値。n は 8、16、または 32 です。値は、n ビットにフィットする限り、12 または 0x18 のように 10 進数または 16 進数形式で指定できます。

（注）

次の点に注意してください。 <Par Name> は設定パラメータ名を表します。 プロファイルでは、対応するタグが、Par_Name のようにスペースをアンダースコア「_」に置き換えて作成されます。 空のデフォルト値フィールドは空の文字列 < “” > を意味します。 電話機は特定のプロファイルに存在しないタグに最後に設定された値を引き続き使用します。 テンプレートは、所定の順序で比較されます。 最初の最も近くない一致が選択されます。 パラメータ名は完全に一致する必要があります。 プロファイルで 1 つのパラメータに複数の定義が指定されている場合、ファイル内の該当する最後の定義が電話機で有効な定義になります。 パラメータに空のパラメータ値を指定すると、パラメータは強制的にそのデフォルト値に戻ります。 代わりに空の文字列を指定するには、空文字列 "" をパラメータ値として使用します。

電話機は、セキュアなリモート プロビジョニング（設定）とファームウェア アップグレードをサポートします。 プロビジョニングされていない電話機は、そのデバイスを対象とする暗号化されたプロファイルを受信できます。 SSL 機能を使用するセキュアな初回のプロビジョニング メカニズムにより、電話機には明示的なキーは不要です。

プロファイル更新、ファームウェア アップグレード、または古いリリースから将来のアップグレード状態にするための中間アップグレードが要求される場合、開始または完了いずれにもユーザの介入は不要です。 プロファイルの再同期は、再同期がソフトウェアのリブートをトリガーし、コールが切断される場合があるため、電話機がアイドル状態の場合にのみ試行されます。

汎用パラメータは、プロビジョニング プロセスを管理します。 各電話機は、通常のプロビジョニング サーバ（NPS）に定期的に接続するよう設定できます。 更新されたプロファイルは共有秘密キーによって暗号化されるため、NPS との通信ではセキュアなプロトコルを使用する必要はありません。 NPS には、クライアント証明書を使用する標準の TFTP、HTTP、または HTTPS サーバを使用できます。

管理者は、電話機の Web ユーザ インターフェイスを使用して電話機のアップグレード、リブート、再起動または再同期を実行できます。 管理者はこれらのタスクを SIP 通知メッセージを使用して実行することもできます。

設定プロファイルは、サービス プロバイダーのプロビジョニング システムに統合されている共通のオープン ソース ツールを使用して生成されます。