CVP UUI/UUS 16 進数から ASCII への変換

概要

このドキュメントでは、Customer Voice Portal（CVP）包括的コール フロー モデル内のユーザ間情報（UUI）ヘッダーのエンドツーエンド転送を 16 進数（HEX）から米国規格協会情報交換標準コード（ASCII）に変換する方法について説明します。

前提条件

要件

次の項目に関する知識が推奨されます。

• CVP コール サーバ
• Unified Intelligent Contact Management Enterprise（ICME）

このドキュメントの情報は、次のソフトウェアのバージョンに基づくものです。

• CVP サーバ 9.0 以降

本書の情報は、特定のラボ環境にあるデバイスに基づいて作成されたものです。 このドキュメントで使用するすべてのデバイスは、初期（デフォルト）設定の状態から起動しています。 稼働中のネットワークで作業を行う場合、コマンドの影響について十分に理解したうえで作業してください。

Unified ICME ルーティング スクリプトへの SIP 着信 UUI の配信

SIP コールでは、UUI（別名：ユーザ間サービスつまり UUS）などの統合サービス デジタル網（ISDN）コール パラメータを Unified Intelligent Contact Management Enterprise（ICME）スクリプトに渡すことができます。

ISDN コール データは、ゲートウェイを使用する時分割多重（TDM）コールからの SIP コールでのみ転送されます。 ゲートウェイでは、Cisco IOS^® 設定の voice service voip セクションの下の signaling forward unconditional コマンドが必要です。 このメソッドは、SIP INVITE 内のコールの Generic Transparency Descriptor（GTD）データをマルチパート Multipurpose Internet Mail Extensions（MIME）コンテンツ タイプ メディア形式で CVP に転送します。

Unified CVP SIP サービスは、コールの GTD セクションを抽出して、ICM サービスの NEW_CALL メッセージ usertouserinfo のペイロード フィールドで Unified ICME に渡すように設定されたパラメータを解釈します。 GTD ペイロードには ISDN コール パラメータが含まれており、発信 IP コールではこれらを送信できません。 着信コール レッグの GTD セクションは、Unified CVP SIP サービスによって発信コール レッグに配信されます。

注: CVP SIP サービスは UUS データを変更しません。

UUI 配信

この ISDN データがコール内で Unified CVP に送信されることを前提とします。

PRN,isdn*,,ATT5*,
USI,rate,c,s,c,1
USI,lay1,ulaw
TMR,00
CPN,00,,u,5900
CPC,09
FCI,,,,,,,y,
UUS,3,3132333435
GCI,87c0c79d91dd11daa9c4000bfda207f2

デフォルトで、UUS フィールド データは 2 バイトの 16 進数表現から 1 バイトの ASCII に変換されます。 たとえば、2 バイトの 16 進数表現で UUS 値が 303132333530 である場合、1 バイト ASCII では値が 012350 になります。

オペレーション コンソール内の GTD パラメータ転送設定は、新しいコールで Unified ICME に GTD（UUI）データを渡すために使用されます（デフォルトは UUS）。 加えて、GTD 内の他のパラメータを抽出して Unified ICME に送信することもできます。 UUS、プロトコル名（PRN）、および Global Cloud Index（GCI）ではカンマ区切り値が使用されます。 NSS IAM メッセージに含まれる任意のパラメータを抽出できます （『ITU-T ナローバンド シグナリング構文仕様（Q.1980.1）』を参照してください）。 

GTD パラメータ転送を有効にする方法

ステップ 1：  CVP オペレーション コンソールにログインします。

ステップ 2： [Device Management] > [CVP Call Server] > [SIP] に移動します。

ステップ 3：  転送する文字列を使って GTD パラメータ転送のエントリを作成します。 複数のパラメータ名をカンマで区切る必要があります。 たとえば、UUS、PRN、および GCI を ICM スクリプトに渡す場合は、文字列 UUS,PRN,GCI を使って CVP SIP サービスを設定します。 Unified ICM スクリプトは、ルート要求メッセージからコール変数 UsertoUserInfo を取得します。

UUS - HEX から ASCII への変換パラメータ

sip.properties ファイルで SIP.UUSHexToAscii パラメータが true に設定されている場合は、CVP SIP サブシステムが UUS 16 進数を ASCII に変換します。 これはデフォルトの動作です。

SIP.UUSHexToAscii = true

16 進数を変換して復帰（CR）、改行（LF）、NULL などの ASCII 制御文字になる場合は、これらが UUI Intelligent Contact Manager（ICM）変数、エージェント コンソール、および TerminationCallDetail（TCD）レコードに表示されません。

たとえば、「fromHexString: 0c00100044544610 length of string is: 16」などです。 HEX から ASCII に変換すると ASCII 制御文字になります。

CVP ログ ファイルは制御文字を出力しません。 そのため、ICM は完全な UUS データを受信しません。

3657: 172.30.56.17: Oct 05 2014 07:59:52.654 -0400: %CVP_9_0_SIP-7-CALL:
  {Thrd=DATAI.7} fromHexString: 0c00100044544610 length of string is: 16 
3658: 172.30.56.17: Oct 05 2014 07:59:52.654 -0400: %CVP_9_0_SIP-7-CALL:
  {Thrd=DATAI.7} NEW CALL with guid=DDEAE3FA4BBC11E4822500070E457A30
 legid=DE84B2CA-4BBC11E4-8AC5CD75-75E5A39A dn=658215 ani=null uui=UUS, DTF;;
 calldate=Sun Oct 05 07:59:52 EDT 2014 video=false cachecallcontext =
 false is_postcallsurvey = false RouterCallKey = null RouterCallKeyDay =
 null RouterCallKeySequenceNumber = null

HEX の UUI を ICM ユーザ間変数に渡すには、SIP.UUSHexToAscii パラメータを false に変更します。 または、16 進数から ASCII への変換によって印刷可能文字だけが返されるようにしてください。