開発者用 SIP 透過性および正規化ガイド Cisco Unified Communications Manager Release 9.1(1)
偏向のない言語
この製品のマニュアルセットは、偏向のない言語を使用するように配慮されています。このマニュアルセットでの偏向のない言語とは、年齢、障害、性別、人種的アイデンティティ、民族的アイデンティティ、性的指向、社会経済的地位、およびインターセクショナリティに基づく差別を意味しない言語として定義されています。製品ソフトウェアのユーザーインターフェイスにハードコードされている言語、RFP のドキュメントに基づいて使用されている言語、または参照されているサードパーティ製品で使用されている言語によりドキュメントに例外が存在する場合があります。シスコのインクルーシブランゲージに対する取り組みの詳細は、こちらをご覧ください。
翻訳について
このドキュメントは、米国シスコ発行ドキュメントの参考和訳です。リンク情報につきましては、日本語版掲載時点で、英語版にアップデートがあり、リンク先のページが移動/変更されている場合がありますことをご了承ください。あくまでも参考和訳となりますので、正式な内容については米国サイトのドキュメントを参照ください。
- Updated:
- 2017年5月29日
章のタイトル： SIP パススルー API
SIP パススルー API
Cisco Unified CM は、SIP コール処理の点ではビジネス ツー ビジネス ユーザ アプリケーション（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 コンテンツ本文を作成し、それを受け渡します。
フィードバック