外部パラメーターを使用したワークフローのカスタマイズ customizing-a-workflow-with-external-parameters

最終更新日： 2026年5月15日

作成対象：

ワークフローがトリガーされると、パラメーターはイベント変数に取り込まれ、ワークフローのアクティビティのカスタマイズに使用できます。

例えば、Read audience アクティビティで読み取るオーディエンス、Transfer file アクティビティで転送するファイルの名前などを定義するために使用できます（このページを参照）。

イベント変数の使用 using-events-variables

イベント変数は、標準の構文を尊重する必要がある式の中で使用されます。

イベント変数を使用する構文は、以下の形式に従い、External signal アクティビティで定義されたパラメーターの名前を使用する必要があります（外部信号アクティビティでのパラメーターの宣言を参照）。

$(vars/@parameterName)

この構文では、$関数は文字列 データ型を返します。別のタイプのデータを指定する場合は、次の関数を使用します。

アクティビティで変数を使用する場合、インターフェイスはそれを呼び出すためのヘルプを提供します。

：変数と関数を組み合わせた式を編集します（このページを参照）。

このリストには、複雑なフィルタリングを実行できる関数が用意されています。これらの関数について詳しくは、このセクションを参照してください。

さらに、以下の関数を使用できます。この関数は、外部パラメーターを使用してワークフローを呼び出した後にイベント変数を使用できるすべてのアクティビティで使用できます（このセクションを参照）。

table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 7-row-3 8-row-3 9-row-3 10-row-3
名前	説明	構文
EndWith	文字列（1番目のパラメーター）が特定の文字列（2番目のパラメーター）で終わるかどうかを示します。	EndWith （<String>,<String>）
startWith	文字列（1番目のパラメーター）が特定の文字列（2番目のパラメーター）で始まるかどうかを示します。	startWith （<String>,<String>）
Extract	区切り記号を使用して、文字列の最初の文字を返します。	Extract （<String>,<Separator>）
ExtractRight	区切り記号を使用して、文字列の最後の文字を返します。	ExtractRight （<String>,<Separator>）
DateFormat	2番目のパラメーターで指定された形式を使用して日付を書式設定します（例：‘%4Y%2M%2D’）	DateFormat （<Date>,<Format>）
FileName	ファイルパスの名前を返します。	FileName （<String>）
FileExt	ファイルパスの拡張子を返します。	FileExt （<String>）
GetOption	指定した関数の値を返します。	GetOption （<optionName>）
IsNull	文字列または日付がnullかどうかを示します。	IsNull （<String/date>）
UrlUtf8Encode	UTF8でURLをエンコードします。	UrlUtf8Encode （<String>）

イベント変数を使用して、以下の節に示す複数のアクティビティをカスタマイズできます。アクティビティから変数を呼び出す方法について詳しくは、この節を参照してください。

Read audience アクティビティ：イベント変数に基づいて、ターゲットとするオーディエンスを定義します。アクティビティの使用方法について詳しくは、この節を参照してください。

Test アクティビティ：イベント変数に基づいて条件を構築します。アクティビティの使用方法について詳しくは、この節を参照してください。

Transfer file アクティビティ：イベント変数に基づいて転送するファイルをカスタマイズします。アクティビティの使用方法について詳しくは、この節を参照してください。

Query アクティビティ：イベント変数と関数を組み合わせた式を使用して、クエリでパラメーターを参照できます。これを行うには、ルールを追加し、Advanced mode リンクをクリックして式の編集ウィンドウにアクセスします（高度な式の編集を参照）。

アクティビティの使用方法について詳しくは、この節を参照してください。

Channels件のアクティビティ：イベント変数に基づいて配信をパーソナライズします。

NOTE

配信パラメーターの値は、配信が準備されるたびに取得されます。

繰り返し配信の準備は、配信 集計期間 に基づいています。例えば、集計期間が「日別」の場合、配信は1日1回のみ再準備されます。配信パラメーターの値が日中に変更された場合、配信では既に1回準備されているため、更新されません。

ワークフローを1日に複数回呼び出す場合は、No aggregation オプションを使用して、配信パラメーターが毎回更新されるようにします。定期的な配信の設定について詳しくは、この節を参照してください。

イベント変数に基づいて配信をパーソナライズするには、まず、使用する変数を配信アクティビティに宣言する必要があります。

宣言されたイベント変数が、パーソナライゼーションフィールドのリストから使用できるようになりました。配信でそれらを使用して、次のアクションを実行できます。

配信に使用するテンプレートの名前を定義します。

note
NOTE
このアクションは、繰り返し配信でのみ使用できます。

配信のパーソナライズ：パーソナライゼーションフィールドを選択して配信を設定する場合、イベント変数は Workflow parameters 要素で使用できます。パーソナライゼーションフィールドとして使用できます。例えば、配信の件名や送信者などを定義できます。

配信のパーソナライゼーションについて詳しくは、このセクションを参照してください。