新しいデータ項目の作成

開始または承認アクティビティの［データ項目マッピング］タブに後動作ターゲット式を指定することにより、フローデータオブジェクトに新しいデータ項目を作成できます。［ターゲット式］列に新しいデータ項目の名前を指定すると、変数が自動的に作成されます。その結果、このアクティビティの後に実行したアクティビティが新しいデータ項目にアクセスできるようになります。

たとえば、［reason］というフォームフィールドをターゲット式flowdata.myReasonにマップするとします。このとき変数myReasonは、ワークフロー内で後に実行されるすべてのアクティビティが使用できる新しいデータ項目になります。

データ項目の変更

開始または承認アクティビティの［データ項目マッピング］タブに前動作の式を指定することにより、データ項目を変更できます。たとえば、ドル記号を価格にプリペンドするために、次のソース式を［Price］というターゲットフォームフィールドにマップします。

"$" + flowdata.get(’cost’)

フォームが表示されると、Priceデータが次のように示されます:

$xx.xx

別の例として、基本コストに税金を加えて総コストを計算します。そのためには、次のソース式を［TotalCost］というターゲットフォームフィールドにマップします:

Number(flowdata.get('cost')) + Number(flowdata.get('tax')) 

複雑なデータ項目マッピングの処理

フローデータオブジェクト内のすべてのデータはXML形式で保持されるため、データ項目を階層的に作成することもできます。たとえば、ユーザが買掛金勘定と売掛金勘定の2つの内部システムへのアクセスを要求できるワークフローフォームがあるとします。このフォームには、他のフィールドとともに［Acct_Pay］と［Acct_Rec］という名前の2つのYes/Noフィールドがあります。後動作のデータ項目マッピングで、次のように2つのマッピングを作成できます。

その結果、SystemAccessという名前のXML要素と、AcctPayおよびAcctRecという名前の2つの子要素が作成されます。このようにしてデータを構造化する1つの理由は、多くのフォームとデータ項目が含まれている複雑なワークフローで、データの編成と管理をよりわかりやすくすることにあります。この階層データからデータを取得するには、次の構文を使用します:

flowdata.get(’SystemAccess/AcctPay’).

ECMAScript式の作成の詳細については、「セクション 10.0, ECMA式の使用」を参照してください。

フォームコントロールデータのフローデータへの移動

作成したフォームコントロール（DNの表示以外）はすべて自動的に、フォームを使用するアクティビティの［データ項目マッピング］」タブの前動作、後動作の式で使用可能になります。たとえば、AACTIVITYのフォームAFORM上にあるコントロールACONTROLのユーザ入力データを後続のアクティビティで利用できるようにするとします。そのためには、ワークフローでAACTIVITYを選択し、［データ項目マッピング］タブを選択し、［後動作マッピング］ラジオボタンをクリックします。それから、ソースフォームフィールドACONTROLの横に、次の形式でターゲット式を入力します:

flowdata.my_ACONTROL

ワークフロー内の後続のすべてのアクティビティは、次のような前動作ソース式を使用して、このデータにアクセスできるようになります:

flowdata.get(’my_ACONTROL’)

flowdata.getObject(’my_ACONTROL’)

フローデータのフォームコントロールへの移動

フローデータ値をフォームコントロールに移動することもできます。最もシンプルなケースは、単一のテキスト値をフォームコントロールに移動する場合です。前に示した例で、ACONTROLが1つのテキスト入力フィールドであるとします。この場合、このフィールドをZACTIVITYというアクティビティの別のテキスト入力フィールドに移動するには、ワークフローでZACTIVITYを選択し、［データ項目マッピング］タブを選択し、［前動作マッピング］ラジオボタンをクリックします。それから、ターゲットフォームフィールドの横に、次のソース式を入力します:

flowdata.my_ACONTROL

より複雑なフォームコントロールデータ（複数値DNコントロールなど）を別のフォームコントロールに移動するには、getObject（）式構文を使用できます。たとえば、ACONTROLがMultiValue DNコントロールであれば、次のソース式を使用することができます:

flowdata.getObject(’my_ACONTROL’)

データをフォームコントロールに移動する場合には、タイプの制約に注意する必要があります。たとえば、テキストベースのデータを数値コントロールに移動しようとしたり、ブール値をDNコントロールに移動しようとしたりすべきではありません。