開発者用 SIP 透過性および正規化ガイド
偏向のない言語
この製品のマニュアルセットは、偏向のない言語を使用するように配慮されています。このマニュアルセットでの偏向のない言語とは、年齢、障害、性別、人種的アイデンティティ、民族的アイデンティティ、性的指向、社会経済的地位、およびインターセクショナリティに基づく差別を意味しない言語として定義されています。製品ソフトウェアのユーザーインターフェイスにハードコードされている言語、RFP のドキュメントに基づいて使用されている言語、または参照されているサードパーティ製品で使用されている言語によりドキュメントに例外が存在する場合があります。シスコのインクルーシブランゲージに対する取り組みの詳細は、こちらをご覧ください。
翻訳について
このドキュメントは、米国シスコ発行ドキュメントの参考和訳です。リンク情報につきましては、日本語版掲載時点で、英語版にアップデートがあり、リンク先のページが移動/変更されている場合がありますことをご了承ください。あくまでも参考和訳となりますので、正式な内容については米国サイトのドキュメントを参照ください。
- Updated:
- 2017年6月14日
章のタイトル： SIP パススルー API
SIP パススルー API
Cisco Unified CM は、SIP コール処理の点では Business to Business User Application（B2BUA; ビジネス ツー ビジネス ユーザ アプリケーション）です。パススルー オブジェクトが、情報のコール レッグからコール レッグへの受け渡しを可能にする一連の API を提供します。
addHeader
このメソッドは、ヘッダーの文字列名と値を受け取り、その情報をトリガーされた発信メッセージに含めるためにパススルー オブジェクトに追加します。
透過性がなければ、Cisco Unified CM は着信 x-nt-corr-id ヘッダーを知らないため、これを無視します。その結果、これは着信 INVITE から削除され、発信 INVITE には含まれなくなります。
このヘッダーのパススルーを有効にするには、このヘッダーをスクリプトの先頭にある allowHeaders テーブルに含める必要があります。さらに、メッセージ処理の中でパススルー オブジェクトに明示的に追加する必要があります。
addHeaderValueParameter
このメソッドは、ヘッダーの名前、パラメータ名、およびパラメータ値を受け取り、その情報をトリガーされた発信メッセージに含めるためにパススルー オブジェクトに追加します。
ヘッダー名とパラメータ名は、必須引数です。parameter-value は、省略可能です。
（注） デフォルトでは、スクリプトのロジックとは関係なく Contact ヘッダー値パラメータが渡されます。ただし、次の場合は例外で、コールレッグ固有と見なされ、Cisco Unified CM で適切に生成されます。
- audio
- video
透過性がなければ、Cisco Unified CM は、 From ヘッダー内の着信 x-tag を知らないため、これを無視します。その結果、これは着信 INVITE から削除され、発信 INVITE には含まれなくなります。
このヘッダー パラメータのパススルーを有効にするには、メッセージ処理の中でこれを明示的にパススルー オブジェクトに追加する必要があります。
addHeaderUriParameter
このメソッドは、ヘッダーの名前、URI パラメータ名、およびパラメータ値を受け取り、その情報をトリガーされた発信メッセージに含めるためにパススルー オブジェクトに追加します。
ヘッダー名とパラメータ名は、必須引数です。パラメータの値は、省略可能です。
透過性がなければ、Cisco Unified CM は、Contact ヘッダー URI 内の着信 cca-id パラメータを知らないため、これを無視します。その結果、これは着信 INVITE から削除され、発信 INVITE には含まれなくなります。
このヘッダー URI パラメータのパススルーを有効にするには、メッセージ処理の中でこれを明示的にパススルー オブジェクトに追加する必要があります。
（注） この例では、パラメータは、発信メッセージ内で異なる名前を取ります（つまり、発信メッセージ内の発信 cca-id と、着信メッセージ内の cca-id ）。
addRequestUriParameter
このメソッドは、URI パラメータ名とパラメータ値を受け取り、その情報をトリガーされた発信メッセージに含めるためにパススルー オブジェクトに追加します。
パラメータ名は、必須引数です。パラメータの値は、省略可能です。
（注） デフォルトでは、スクリプトのロジックとは関係なく初期 INVITE 内の要求 URI パラメータが渡されます。ただし、次の場合は例外で、コールレッグ固有と見なされ、CUCM で適切に生成されます。
- phone-context
- trunk-context
- tgrp
- user
例：着信レッグが、パラメータを生成してから、発信要求 URI 内に格納するために受け渡します。
addContentBody
このメソッドは、content-type、content-body、content-disposition、content-encoding、および content-language を受け取り、その情報をトリガーされた発信メッセージに含めるためにパススルー オブジェクトに追加します。
content-type と content-body は、必須引数です。content-disposition、content-encoding、および content-language は、省略可能なパラメータです。これらの値のいずれかが空または nil に指定された場合、ヘッダーがコンテンツの一部として含められることはなくなります。
透過性がなければ、Cisco Unified CM は着信 INFO メッセージとコンテンツ本文を無視します。透過性を使用した場合、Cisco Unified CM は Nortel PBX によって送信された独自コンテンツ本文を抽出し、コンテンツ本文から DTMF の数字を抽出して、新しい dtmf-relay コンテンツ本文を作成し、それを受け渡します。
フィードバック