|
プロセスのほとんどの操作で入力データを受け入れ、データを処理するか、またはデータに基づいてアクションを実行し、出力として返します。操作のプロパティを設定して、入力データおよび出力データを保存する場所を指定します。通常、プロパティは、「Process Properties」ビューで「Input」プロパティグループと「Output」プロパティグループに整理されます。一部の操作では、他のプロパティグループが使用されます。
この操作によって、プロパティ値に使用する必要があるデータのタイプが決定されます。また、この操作では、さまざまなフォーマットで値を指定できます。
|
形式
|
説明
|
推奨される用途
|
|
リテラル値
|
このプロパティ値はテキストボックスに入力して、または「Process Properties」ビューのドロップダウンリストを使用して指定されます。
|
この値は、プロセス内の 1 つの操作のプロパティのみに使用されます。
値が複数回にわたって使用される場合、変数または XPath 式を使用することによって、同じ値を再入力する時間を節約できます。
|
|
テンプレート
|
このデータは XPath 式が埋め込まれた文字列として指定され、この式は
{$...$}
記号で囲まれます（
テンプレート式の指定
を参照）。
|
この操作のプロパティには文字列値が必要で、その値には静的テキストと、プロセスインスタンスに応じて変わるテキストの両方が含まれます。
例えば、このフォーマットはタスクの説明を入力するときに使用できます（
タスクの手順の指定
を参照）。
|
|
変数
|
このデータは、リストから選択した変数として指定されます。変数で保存される値はプロパティ値として使用されます（
プロセス変数
を参照）。
|
この値は既に変数に保存されています。
|
|
XPath 式
|
この値は XPath 式によって指定されます。XPath 式は「XPath Builder」ダイアログボックスを使用して作成できます(
XPath 式の作成
を参照）。
|
この値はプロセスデータモデルに保存され、変数値全体、または変数データのサブセットを指定できます。
例えば、XPath 式を使用して、送信されたフォームからのデータの特定の項目の値を指定します（
フォームフィールドの値の取得
を参照）。
|
通常、プロパティのリテラル値を指定する方が、変数を使用するよりも簡単です。ただし、次のような状況では、プロパティ値として変数を指定することは推奨されません。
入出力データの設定
「Process Properties」ビューで操作の入出力データを設定します。このセクションの手順は汎用です。指定する値は操作に応じて異なります。
注意：
「Process Properties」ビューでアスタリスク（*）でマークされた値は必須です。
操作の入出力データを設定します。
-
プロセスダイアグラムで操作を選択します。
-
「Process Properties」ビューを開きます。
-
「Input」カテゴリが存在する場合は、これを展開し、データタイプを指定して、入力データの値およびプロパティを入力します。
-
「Output」カテゴリが存在する場合は、これを展開し、データタイプを指定して、出力データの値およびプロパティを入力します。
-
他のカテゴリに入出力データが含まれる場合、それらのカテゴリを展開し、データの値およびプロパティを入力します。
データ強制
操作に特定のデータタイプのデータが必要な場合、別のデータタイプのデータが指定されると、自動データ強制によってデータタイプの不一致が処理される可能性があります。AEM forms がデータタイプの不一致を検出した場合、まず、カスタム DSC によって実装されたコンテキストに固有の強制を使用して取得しようと試みます。これに失敗した場合、AEM forms は内部強制ルールテーブルを参照して問題を解決します。これに失敗した場合のみ、強制例外がスローされます。
例えば、操作に
int
型の入力値が必要な際に
string
型が指定されている場合、AEM forms サーバーは
string
から
int
型への変換を強制（試行）します。
string
に文字列
"123"
のような数値が含まれる場合、強制が行われ、操作を続行でき、値を整数
123
として扱います。
注意：
現在のデータタイプが要求されたデータタイプと一致する場合、常に強制が成功します。
次の表に内部強制ルールテーブルを示します。これは、特定のデータタイプの組み合わせの限定的な強制の結果を説明しています。
注意：
この表では、数値がデータタイプ int、short、long、byte、および float を表します。
|
現在のデータタイプ
|
要求されるデータタイプ
|
強制
|
|
あらゆるタイプ
|
string
|
成功
|
|
あらゆるタイプ
|
binary (byte[])
|
成功
|
|
あらゆるタイプ
|
numeric
|
失敗
|
|
あらゆるタイプ
|
org.w3c.dom.Document
|
失敗
|
|
あらゆるタイプ
|
com.adobe.idp.Document
|
失敗
|
|
あらゆるタイプ
|
java.util.List
|
失敗
|
|
あらゆるタイプ
|
java.util.Map
|
失敗
|
|
binary (byte[])
|
com.adobe.idp.Document
|
成功
|
|
binary (byte[])
where byte[] is a list
|
java.util.List
|
成功
|
|
binary (byte[])
where byte[] is a map
|
java.util.Map
|
成功
|
|
Boolean
|
int
|
成功
|
|
Boolean
|
short
|
成功
|
|
Boolean
|
long
|
成功
|
|
Boolean
|
byte
|
成功
|
|
Boolean
|
float
|
成功
|
|
numeric
|
Boolean
|
成功
|
|
numeric
|
numeric
|
成功
|
|
文書
|
org.w3c.dom.Document
|
成功
|
|
java.io.InputStream
|
java.util.List
|
成功
|
|
java.io.InputStream
|
java.util.Map
|
成功
|
|
org.w3c.dom.Document
|
com.adobe.idp.Document
|
成功
|
|
string
|
numeric
|
成功
|
|
string
|
Boolean
|
成功
|
|
string
|
org.w3c.dom.Document
|
成功
|
|
string
|
com.adobe.idp.Document
|
成功
|
その他の場合はすべて強制が試行されますが、結果は実行時まで不明です。AEM forms がコンテキストに固有の強制の検出を試行する場合は、検出に失敗すると、強制に失敗します。
注意：
上記の表で説明したデータの強制は、Service のカスタムエディターではサポートされません。
テンプレート式の指定
テンプレート式
は XPath 式が埋め込まれた文字列で、
{$...$}
記号で囲まれます。この形式は、電子メールメッセージまたはその他の通知メッセージでカスタマイズされた説明が必要な場所に操作の入出力データを指定する場合に使用されます。
テンプレート式を作成する場合：
-
指定された場所に、文字列を入力します。
-
「Insert Expression」をクリックし、「XPath Builder」で XPath 変数を選択します。
-
必要に応じて、手順を繰り返します。
例えば、ユーザーへのメッセージが含まれる出力データの変数が必要で、プロセス変数が指定される場所にデータ値を代入するとします。次の式を使用できます。
Dear {$/process_data/@title$} {$/process_data/@lastname$},
Your order {$/process_data/@order_id$} has been received.
出力時に、テンプレート式によって次のテキストが出力されます。
Dear Mrs. Jones,
Your order 12345 has been received.
|
|
|
