SNIPPET

スクリプトにカスタムコードを追加できるようにします。

依存関係

• このアクションで使用されるコードは、Snippet用に開発された社内スクリプト言語であるCXone Mpowerで記述する必要があります。 スニペットのスクリプトの詳細については、Studioテクニカルリファレンスガイドを参照してください。
• 動的データオブジェクトの属性に__type （アンダースコア2つ）という名前を付けることはできません。 この単語は、ダイナミックオブジェクトからJSONを解析する時に使用するために用意されています。
• Snippetアクションを使用してAPI通話を行うことができます。 最大応答サイズは32 KBです。 これは、REST APIアクションの応答サイズ制限と一致しています。  この制限は、クラスターの不安定や停止を防ぐために厳密に適用されます。 可能であれば、代わりにREST APIアクションを使用してください。 制限は同じですが、より高い負荷を処理できます。 どうしてもSNIPPETアクションを使う必要がある場合、以下のヒントに従って、返されるデータのサイズを小さくします。

  • API応答のデータをフィルタリングします。 例えば、NICEレポーティングAPIを使用してコンタクトを取得している場合、コンタクトのstartDateとendDateにより結果をフィルタリングできます。 このAPIコールでは、アイテムのトップカウントを返したり制限したりすることもできます。 どのようなフィルタリングを使用できるかを決めるには、スクリプト統合に付属のAPIのドキュメントを参照してください。

  • 必要なデータのみを返すようにAPIリクエストを更新します。 例えば、NICEレポーティングAPIを使用してコンタクトを取得する場合、contactIdまたはagentIdのフィールドを使用して、関連するデータのみを返すことができます。 スクリプト統合に付属のAPIのドキュメントを参照して、使用できるデータ上限を決定します。

  • 上記のオプションのどちらも行うことができない場合は、ミドルウェアを構築します。

• Studioの配列の最大サイズは、6,300万要素です。 この配列サイズを超えると、スクリプトトレースの変数で次のこの__errエラーが発生します：配列インデックスが範囲外です。 現在の配列インデックス（[インデックス]）は、最大許可インデックス（63000000）を超えています。配列サイズを超えると、スクリプトはSNIPPETアクションのError分岐を実行します。 Error分岐が接続されていない場合、スクリプトは実行を続けますが、配列情報はありません。 EMAILアクションをSNIPPETアクションのError分岐に追加することで、配列の最大サイズを超えたときに通知するようにスクリプトを設定できます。 最後に、Error分岐にロジックを追加して、スクリプトに進みます。 配列情報なしで続行されることに注意してください。

サポートされているスクリプトタイプ

一般	Eメール	チャット	電話	ボイスメール	ワークアイテム	SMS	デジタル

入力プロパティ

これらのプロパティは、アクションが実行時に使用するデータを定義します。

プロパティ	説明
Add Caption	スクリプト内でこのアクションを一意に識別できる、短いフレーズを入力します。 アクションアイコンにカーソルを合わせるとキャプションが表示されます。
Data	Snippet editorウィンドウで追加されたカスタムコードが含まれています。 これには、複数のASSIGNおよびDYNAMICコマンド、各種フロー制御ステートメント、組み込みおよびユーザー定義の関数が含まれます。
Max String Size	Dataプロパティに、すべてのコマンドの最大文字列サイズを設定します。 オプションは、Limit2K、Limit4K、Limit8K、Limit16K、Limit32Kです。 この制限は、REST APIやSOAPとの統合レスポンスに適用されます。

結果分岐条件

結果の分岐条件を使用すると、アクションが実行されたときにさまざまな結果を処理できるように、スクリプトにブランチを作成できます。

条件	説明
Default	スクリプトが他のブランチのいずれかを取る必要がある条件を満たさない限り、パスが取られます。 他のブランチが未定義の場合にも使用されます。
Error	アクションが正しく実行されなかったときにとられるパス。 これは例えば、接続不良、構文エラーなど予期しない問題が発生した場合などです。 _ERR変数に1つのアンダースコア文字がある場合、問題の簡潔な説明を入力する必要があります。

ヒントとコツ

• Snippet アクションでasjson()関数を使用し、結果のJSONを文字列変数に格納します。 JSONデータを渡す必要がある場合は、他のStudioアクションのプロパティで文字列変数を使用します。 この方法により、スクリプトを保存する際に検証エラーが発生する可能性を回避できます。
• ASR コンタクトが録音された音声プロンプトに対して、話す、電話のキーを押す、またはその両方の組み合わせで応答できる機能。対応のIVR 音声コマンド、キー入力、またはその両方を使用して発信者が情報を取得したり、着信音声通話をルーティングしたり、またはその両方を行うことができる自動電話メニュー。システムをチューニングしている場合、スニペットで使用できるパラメーターのセットがあります。
• Snippet言語には、変数やオブジェクトの宣言、ループや反復文の作成などを可能にするキーワードコマンドが用意されています。
• Studioには、スクリプトで使用できる関数が組み込まれています。
• スニペットで使用するカスタム関数を独自に作成できます。
• Snippet editor ウィンドウで、スニペットコードのテストとデバッグを行えます。

Snippet Editor ウィンドウ

Snippetアクションを選択し、アクションプロパティで[エディターを開く]をクリックすると、Snippet editorウィンドウが開きます。

スクリプトの例

この簡単な例では、Snippet内のコードを使用して、サードパーティーシステムの情報を基に見込み客を作成できるかどうかをテストします。

このスクリプトをダウンロードします。