Runsub

このヘルプページはCXone Studio用です。この情報は、Desktop Studio用にも提供されています。

実行された後、Returnactionを使用してメインスクリプトに戻り、その実行を継続するサブスクリプトを呼び出します。サブスクリプトが実行されると、ReturnアクションのReturnValueプロパティに値が格納され、メインスクリプトのRunsubアクションのReturnVariableプロパティにその値が返されます。

このアクションは、小さなスクリプトに分割したい1つ以上の大きなスクリプトがある場合に特に役立ちます。

依存関係

メインスクリプトとサブスクリプトは同じフォルダーになければなりません。
たとえば、メインスクリプトが電話スクリプトである場合、サブスクリプトも電話スクリプトである必要があります。たとえば、メインスクリプトが電話スクリプトである場合、サブスクリプトも電話スクリプトである必要があります。
メインスクリプトにRunsubアクションを配置する場合、サブスクリプトにはReturnアクションが必要です。
Runsubはメインスクリプトから下付き文字に複数の変数を渡すことができますが、下付き文字は（ReturnVariableプロパティの）1つの値のみをメインスクリプトに返すことができます。
サブスクリプトで定義された変数は、グローバルとして宣言しない限り、サブスクリプトが終了すると使用できなくなります。SNIPPETアクションでこれを行うには、変数名の前にglobal:を追加します。例えば、 ASSIGN global:varName = value 。サブスクリプト内のデータにアクセスするもう1つの方法として、GET /contacts/{contactId}/custom-dataAPIを使用することができます。
Runsubサブスクリプト内の変数にsavetodb()関数を使用するには、これがグローバル変数でなければなりません。
RunScript 、Spawn、Runsub、または同様のスクリプトによって呼び出されるすべてのスクリプトは、有効でアクティブである必要があります。保存プロセス中に、 Studioはアクションによって呼び出されたすべてのスクリプトを検証します。それらのいずれかが無効または非アクティブである場合、 Studioにはエラーが表示され、保存できなくなります。

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


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

類似アクションの比較

以下のアクションには同様の機能がありますが、いくつかの重要な相違点があります。

Runscript：Runscriptが別のスクリプトをトリガーすると、2番目のスクリプトから最初のスクリプトに戻ることはありません。
Runsub：Runsubがサブスクリプトをトリガーすると、サブスクリプトにReturnアクションがある限り、スクリプトは最初のスクリプトに戻ることができます。Returnアクションは、添え字が終了したときにRunsubアクションに値を返します。
SPAWN：最初のスクリプトと並行して実行される2番目のスクリプトを開始します。スポーンされたスクリプトにSIGNALアクションを含めない限り、スポーンされたスクリプトは最初のスクリプトにデータを戻すことができません。

入力プロパティ

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

プロパティ	説明
キャプションを追加	スクリプト内でこのアクションを一意に識別できる、短いフレーズを入力します。アクションアイコンにカーソルを合わせるとキャプションが表示されます。
Script Name	生成するスクリプト。アクションのプロパティボックスの上部にあるChoose Scriptリンクをクリックすると、ビジネスユニットからスクリプトを選択できます。
Return Variable	メインスクリプトに返される値は、このプロパティに格納されます。複数の値を渡すには、変数として配列を使用します。
Parameters	フィールドの省略記号アイコンをクリックし、渡される生成されたスクリプトに送信する各パラメーター用の変数を追加します。エディターウィンドウに1行につき1つの変数を入力します。意味のある変数名を使用してください。変数名は、生成されたスクリプトで使用されている対応する変数名と一致する必要はありません。スクリプトに渡されたパラメータは、Beginアクションでそのスクリプトのトレース出力に表示されます。

結果ブランチ条件

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

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

スクリプトの例

これは、このアクションをスクリプトでどのように使用できるかを示す例です。完全なスクリプトではありません。追加のスクリプト作成が必要な場合があります。

以下のメインスクリプト（上に表示）で、スクリプトがトリガーされると、Runsubアクションはすぐにサブスクリプト（下に表示）をトリガーします。添え字では、Voiceparamsが音声合成の設定を設定し、Hoursアクションが営業時間、閉店時間、休日のブランチを3つの異なるReturnアクションに設定します。下付き文字が完了すると、ReturnValuesプロパティの値（Returnアクション内）がReturnVariableフィールドに格納されます（メインスクリプトのRunsubアクション）。次に、Caseアクションは、必要に応じて、オープン、クローズおよびホリデーブランチを設定します。

メインスクリプト

矢印で接続されたStudioアクションを示すサンプルスクリプト。各アクションの下には、アクションがスクリプトで何をするかを示すラベルがあります。

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

サブスクリプト

3つのReturnアクションがReturnValueプロパティに値を提供するため、メインスクリプトのCaseアクションは、どのブランチをたどるかを決定できます。

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