データ・プロバイダ・イベントの起動アクションの追加

データに対する変更を反映するために、データ・プロバイダにイベントをディスパッチするデータ・プロバイダ・イベントの起動アクションを追加します。たとえば、特定のサービス・データ・プロバイダ(SDP)を使用するコンポーネントは、SDPによって使用されるエンドポイントに新しいデータが追加されたため、新しいデータを表示する必要がある場合があります。

アクションは、突然変異またはリフレッシュ・イベントでコールできます。リフレッシュ・イベントによってすべてのデータが再フェッチおよび再レンダリングされ、変更イベントを使用して表示する変更が指定されます。

ノート:

dataプロパティを介して公開されるADP変数のデータ配列は変数の割当てアクションを使用して直接更新できるため、このアクションはVB Array Data Provider (ADP)変数には必要ありません。データ配列の割当ては、Visual Builderによって自動的に検出され、この変更がすべてのリスナーに通知されます。 dataプロパティを直接変更する前に、ADPでfireDataProviderEventを使用すると、ユーザーにこの警告が表示されます。

プロパティの詳細など、このアクションに関するAPI情報は、「Oracle Visual Builderページ・モデル参照」の「Fire Data Providerのイベント処理」を参照してください。

データ・プロバイダ・イベントの起動アクションを使用するには:

「組込みアクション」の最後に説明されているように、3つの方法のいずれかでアクションを追加します。

図jsac-fire-data-provider-event-example.jpgの説明
プロパティ・ペインのIDフィールドを更新して、アクションを識別しやすくします。
「イベント・ターゲット」の場合は、プロパティの右端にマウス・ポインタを重ねてをクリックし、関連するServiceDataProviderまたはArrayDataProviderを選択して、イベントのターゲットを設定します。
ディスパッチするイベントのタイプを選択します:
- リフレッシュ: すべての変更を表示するために使用します。
- ミュータ: 表示する変更を指定するために使用します。たとえば、レコードを削除した後、「Mutate」オプションを使用して削除されたレコードを指定し、SDPにバインドされたUIコンポーネントに表示から削除するように求めることができます。
  操作間のID値が交差していないかぎり、突然変異イベントには複数の突然変異操作(追加、更新、削除)を含めることができます。この動作はJETコンポーネントによって強制されます。たとえば、操作の順序が保証されないため、同じイベントでレコードを追加して削除することはできません。
Mutateイベントを選択した場合は、SDP変数のkeyAttributesプロパティが設定されていることを確認します。追加、削除および更新されたレコードを表示するパラメータは、add、removeおよびupdateセクションの下にあります。 mutateイベントが最適に実行するために、各セクションに必要な内容を次に示します:
1. addセクション: dataパラメータを使用して、追加操作の戻り結果から追加されたレコードを渡します。 SDP変数を使用している場合、データの構造は、SDP変数の定義のitemsPathパラメータで指定された構造と一致する必要があります:
  
  図jsac-sdp-items-path.jpgの説明
  
  keysパラメータを使用して、追加されたレコードのキー値をSet<*>フォーマットで渡します。最後に、metadataパラメータを使用して、追加されたレコードのキー値をArray.<ItemMetadata.<KeyValue>>の書式で渡します。
  例:
```
data: {items: [callRestCreateEmployeeResult.body],},
keys: [callRestCreateEmployeeResult.body.id],
metadata: [{key: callRestCreateEmployeeResult.body.id,}],
```
1. removeセクション: keysパラメータを使用して、削除されたレコードのキー値をSet<*>形式で渡します
1. updateセクション: addセクションと同じです。