データ オブジェクト アクション

データ オブジェクト アクションを使用して、データを操作するためのデータ オブジェクト変数の値を取得または設定します。

  1. フォーム モデリング バーで、[アクション] をクリックし、[新規] をクリックします。

    [新しいアクション] ダイアログ ボックスが表示されます。

  2. [タイプ] リストで、[データ オブジェクト] を選択します。
  3. デフォルトの [名前] (DataObject1) を意味のある名前に変更します。
  4. この項目は任意です。アクションの [説明] を入力します。
  5. この項目は任意です。[複数言語] を選択して、言語ごとに固有のアクションを個別に構成します。複数言語の設定アクションを参照してください。
  6. [データ オブジェクト変数] リストでデータ オブジェクト変数を選択します。
  7. [操作] リストでいずれかのオプションを選択して、以下を構成します。

    [フィールドの取得]

    データ オブジェクト変数に基づいて、データ モデル構造からフィールドを取得できます。フィールドを取得するには

    1. をクリックします。[新しいターゲット] ダイアログ ボックスが表示されます。

    2. [ソース/値] リストで、値を取得するデータ オブジェクトのフィールドを選択します。

      フィールドを選択すると、Customer.Address.Addressline1 どのフィールド パスが表示されます。

    3. [ターゲット] リストで、フィールド値をマップするターゲット コントロール、ターゲット フォーム、またはグローバル変数を選択します。

      選択したデータ オブジェクト フィールドがリストである場合、ターゲットにはテーブル コントロールのみを使用することができ、テーブル列をリスト列にマップすることができます。

    一度に複数のフィールドを取得するには、上記の手順を繰り返してフィールドを追加します。

    [フィールドの更新]

    更新するデータ オブジェクトから、更新するフィールドを選択できます。フィールドを取得するには

    1. をクリックします。[新しいターゲット] ダイアログ ボックスが表示されます。

    2. [ソース/値] リストで、値を更新するデータ オブジェクトのフィールドを選択します。

      フィールドを選択すると、Customer.Address.Addressline1 どのフィールド パスが表示されます。

    3. [ターゲット] リストで、新しい値をとして使用するソース コントロール、ソース フォーム、グローバル変数、インライン値、または式を選択します。

      選択したデータ オブジェクト フィールドがリストである場合、ソースにはテーブル コントロールのみを使用することができ、テーブル列をリスト列にマップすることができます。

    一度に複数のフィールドを更新するには、上記の手順を繰り返してフィールドを追加します。

  8. [追加] をクリックします。

    新たに作成されたアクションがテーブルに追加されます。

  9. このアクションをトリガーするため、アクションにコントロールを関連付けます。フォーム コントロール イベント用のアクションの構成を参照してください。または、フォーム イベントに対してこのアクションを呼び出すには、アクションをフォームに関連付けます。フォームへのアクションの関連付けを参照してください。

    このアクションがトリガーされると、データ オブジェクト変数の値を取得または更新するようにアクションが構成されているかどうかに応じて、データが操作されます。