コールRESTの追加アクション
コールRESTアクションをアクション・チェーンに追加する場合、エンドポイント・リクエストの入力パラメータを指定するか、ページ・コンポーネントにバインドできるエンドポイント・レスポンスの変数を作成する必要がある場合があります。
RESTのコール・アクションをアクション・チェーンに追加する場合、選択するエンドポイントは使用可能な関数によって異なります。 関数によっては、入力パラメータやアクションの結果など、アクションのパラメータにマップするための変数を作成する必要もあります。 たとえば、エンドポイントでレコードを識別するIDが必要な場合があります。 この場合、IDを格納するページ変数を作成し、その変数をアクションの入力パラメータにマップする必要があります。 アクション・チェーンを作成する前に変数を作成していない場合は、アクション・チェーンの作成プロセス中に変数を作成できます。また、必要な変数を作成した後でアクション・チェーンを編集することもできます。
レコードの作成、更新、削除などの一般的な機能を実行するアクション・チェーン、およびページにレコードの詳細を表示する場合はいつでも、RESTエンドポイントのコール・アクションを使用します。 クイック開始を使用して、これらの関数のアクション・チェーンおよび変数を作成できます。
| エンドポイントのタイプ | 典型的な要件 |
|---|---|
| POST |
POSTエンドポイントをコールする場合、通常、次のものが必要です:
|
| GET |
GETエンドポイントをコールする場合、通常、次のものが必要です:
コレクションを取得するためのリクエストをGETエンドポイントに送信する場合、通常は、タイプServiceDataProviderのページ変数を使用します。 |
| DELETE |
DELETEエンドポイントをコールする場合、通常、次のものが必要です:
|
| PATCH |
PATCHエンドポイントをコールする場合、通常、次が必要です:
|
コールRESTエンドポイントをアクション・チェーンに追加するには:
- 「RESTのコール」をアクション・パレットからアクション・チェーンにドラッグします。
アクション・チェーン内のAddアイコン(
)、またはチェーン内の既存アクション間にアクションをドラッグできます。 Call RESTエンドポイント・アクションをアクション・チェーンに追加すると、プロパティ・ペインが開きます。
「図action-chain-editor-selectendpoint.pngの説明」 - プロパティ・ペインのEndpointプロパティの横にある「選択」をクリックします。
エンドポイントの選択ウィンドウに、アプリケーションで使用可能なエンドポイントのリストが表示されます。 各ビジネス・オブジェクトおよびサービスは、通常、複数のエンドポイントを公開します。 選択するエンドポイントは、アクション・チェーンの機能に依存します。 選択したエンドポイントでは、アクションに指定する必要のあるプロパティ(入力パラメータなど)も決定されます。
「図action-chain-editor-selectendpoint-dialog.pngの説明」 - プロパティ・ペインでアクション・プロパティを編集します。
キャンバスでアクションを選択すると、プロパティ・ペインが表示されます。
「図action-chain-properties-callrest.pngの説明」 - オプショナル: RESTコールに入力パラメータが必要な場合は、入力パラメータの横にある割り当てをクリックして、入力パラメータの変数をアクション・パラメータにマップします。 「保存」をクリックします。
入力パラメータの割当ウィンドウのパラメータに変数をマップするには、ソース・ペインの変数をターゲット・ペインのパラメータにドラッグします。 場合によっては、複数のマッピングを作成する必要があります。 変数をパラメータにマッピングする行を削除するには、その行にカーソルを置き、右クリックして削除オプションを開きます。 パラメータ名を選択すると、マップされた変数の式を表示できます。
「図action-chain-map-inputparameters.pngの説明」
適切な変数が存在しない場合は、関連するノード(アクション・チェーン、ページなど)の横にある+アイコンを使用して、新しい変数を作成します。