Runsub

サブスクリプトが実行されると、ReturnValueアクションのReturnプロパティに値が格納され、その値がメインスクリプトのReturnVariableアクションのRunsubプロパティに渡されます。 このアクションは、小さなスクリプトに分割したい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番目のスクリプトを開始します。 スポーンされたスクリプトにSIGNALactionを含めない限り、スポーンされたスクリプトは最初のスクリプトにデータを戻すことができません。

入力プロパティ

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

プロパティ	説明
Caption	スクリプト内でこのアクションを一意に識別できる、短いフレーズを入力します。 アクションアイコンにカーソルを合わせるとキャプションが表示されます。 The default is the action name.
ScriptName	生成するスクリプト。 アクションのプロパティボックスの上部にあるChoose Scriptリンクをクリックすると、ビジネスユニットからスクリプトを選択できます。
ReturnVariable	メインスクリプトに返される値は、このプロパティに格納されます。 複数の値を渡すには、変数として配列を使用します。
Parameters	スポーンされたスクリプトまたは子スクリプトに送信するパラメーターの値を保持するデフォルト変数の名前を変更できます。 デフォルトの変数は p1 p9 ですが、このプロパティで名前を指定すると、パラメーター値が渡されるデフォルトの変数名がそれらの名前に置き換わります。名前を変更しない場合、変数はデフォルトのpX名のままになります。 To change the names, click the ellipsis icon in the field and add variable names for each parameter you want to send to the spawned or child script. Enter up to nine names, one per line in the editor window. 名前を変更するには、スポーンされたスクリプトまたは子スクリプトに送信する各パラメーターに新しい名前を追加します。 変数名を1行に1つずつ、最大9つまで入力します。 変数名は、生成されたスクリプトで使用される対応する変数の名前と一致する必要はありませんが、意味のあるものにする必要があります。 これらの値はparameter variablesパラメーター変数p1～p9として渡されます。 スクリプトに渡されたパラメーターは、そのスクリプトのトレース出力のBeginアクションに表示されます。

結果分岐条件

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

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

スクリプトの例

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

メインスクリプト

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

サブスクリプト

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

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