開発者用 SIP 透過性および正規化ガイド

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 コンテンツ本文を作成し、それを受け渡します。

スクリプト

着信メッセージ

発信メッセージ