機械翻訳について
  1. Oracle Integration Generation 2のOracle Visual Builderでのアプリケーションの開発
  2. アプリケーション開発
  3. JavaScriptアクション・チェーンの操作
  4. 組込みアクション
  5. コールRESTの追加アクション

コールRESTの追加アクション

RESTコール・アクションは、REST APIエンドポイントをコールしてレコードを作成、更新、削除または表示するために使用されます。

エラー処理とその戻りオブジェクトの詳細など、このアクションに関するAPI情報は、「Oracle Visual Builderページ・モデル参照」の「RESTのコール」を参照してください。

コールRESTアクションを追加した後、リクエストのエンドポイントを指定する必要があります。 エンドポイントによっては、レコードを識別するためのIDなどの入力パラメータを指定する必要がある場合もあります。

この表は、エンドポイントのタイプごとに、通常コールRESTアクションに指定する必要があるパラメータを示しています。 各エンドポイント・タイプへのコールのコード例は、「Oracle Visual Builderページ・モデル参照」の「RESTのコール」を参照してください。 アクションが返した結果については、結果の保存先プロパティの自動生成された変数セットに割り当てられます。

エンドポイントのタイプ 使用 典型的な要件
POST 新規レコードを追加します。

  • 新しいレコードを指定: プロパティ・ペインのパラメータ・セクションで、データを含む変数をbodyプロパティに割り当てます。

  • エンドポイントの入力パラメータ(ある場合)を指定: エンドポイントで入力パラメータが必要な場合は、プロパティ・ペインの「入力パラメータ」セクションを使用して、必要な入力パラメータを指定します。 必須の入力パラメータはアスタリスクでマークされています。

GET 1つまたは複数のレコードを取得します。

単一レコードを取得するには、レコードのIDを指定: プロパティ・ペインの「入力パラメータ」セクションで、レコードのIDの入力パラメータを使用してレコードのIDを指定します。
DELETE レコードの削除

  • レコードのIDを指定: プロパティ・ペインの「入力パラメータ」セクションで、レコードのIDの入力パラメータを使用してレコードのIDを指定します。
PATCH レコードを更新します。

  • 更新されたデータの提供: プロパティ・ペインのパラメータ・セクションで、更新されたデータを含む変数をbodyプロパティに割り当てます。

  • レコードのIDを指定: プロパティ・ペインの「入力パラメータ」セクションで、レコードのIDの入力パラメータを使用してレコードのIDを指定します。

コールRESTエンドポイントを使用するには:

  1. 「組込みアクション」の最後に説明されているように、3つの方法のいずれかでアクションを追加します。
    jsac-call-rest-action-example-blank.jpgの説明は以下のとおりです
    図jsac-call-rest-action-example-blank.jpgの説明

  2. 「プロパティ」ペインで、「エンドポイント」の横にある「選択」をクリックします。

    エンドポイントの選択ウィンドウに、アプリケーションで使用可能なエンドポイントのリストが表示されます。 通常、各ビジネス・オブジェクトとサービスは、それぞれ異なる目的で複数のエンドポイントを公開します。 たとえば、複数のレコードを取得するためのエンドポイント、単一レコードを取得するためのもの、レコードを更新するためのもの、レコードを削除するためのものなどを設定できます。 各エンドポイントには、指定する必要がある様々なプロパティがあります。 たとえば、単一レコードを取得するエンドポイントの場合、レコードのIDを指定する必要があります。
    action-chain-editor-selectendpoint-dialog.pngの説明は以下のとおりです
    「図action-chain-editor-selectendpoint-dialog.pngの説明」

  3. リストからエンドポイントを選択し、「選択」をクリックします。
    RESTコールのプロパティはプロパティ・ペインに表示され、必須プロパティにはアスタリスク(*)が付いています:
    jsac-call-rest-action-parameters.jpgの説明は以下のとおりです
    図jsac-call-rest-action-parameters.jpgの説明

  4. RESTコールでヘッダーまたは入力パラメータが必要な場合は、関連する「割り当て」または「未マップ」リンクをクリックし、割当てウィンドウを使用してプロパティの値を指定します。 「保存」をクリックします。

    割当てウィンドウのパラメータに変数をマップするには、「ソース」ペインの変数を「ターゲット」ペインのパラメータにドラッグします。 場合によっては、複数のマッピングを作成する必要があります。 変数をパラメータにマップする行を削除するには、行を右クリックして「削除」を選択します。 ターゲット・ペインでパラメータを選択して、下部のペインでその割当ての式を表示および編集することもできます。
    action-chain-map-inputparameters.pngの説明は以下のとおりです
    「図action-chain-map-inputparameters.pngの説明」

    適切な変数が存在しない場合は、関連するノード(アクション・チェーン、ページなど)の横にある+アイコンを使用して、新しい変数を作成します。

  5. RESTコールに必要なその他のプロパティを指定します。
  6. RESTコール・エラーを処理するには、キャンバス上のCall RESTカードの下部に表示されるエラー処理の作成領域に、エラーが発生した場合に実行する最初のアクションをドラッグします:
    jsac-call-rest-create-error-handler.pngの説明は以下のとおりです
    図jsac-call-rest-create-error-handler.pngの説明

    削除されたアクションは、RESTコール中にエラーが発生したかどうかをチェックするIf条件で追加されます。     プロパティ・ペインでアクションを構成し、他の必要なアクションを条件に追加します。
    jsac-call-rest-create-error-handler-done.pngの説明は以下のとおりです
    図jsac-call-rest-create-error-handler-done.pngの説明

Call RESTアクションによって返されるオブジェクトは、Store Result Inプロパティによって自動的に名前が付けられ、表示されます。

基礎となるREST APIリクエストがステータス・コードを返す場合、エラーを自分で処理するためのエラー・オブジェクトが返されます。それ以外の場合は、自動生成されたエラー通知が表示されます。

サービス定義

パス、メソッドなど、サービス接続エンドポイントの詳細を変更するには(例: GET、PUT、HEAD)またはリクエストまたはレスポンスのスキーマについては、「サービス接続の編集」を参照してください。

変換関数

RESTリクエストのデータおよびパラメータのフォーマットを変更し、RESTレスポンスからのデータのフォーマットを変更するJavaScriptファンクションの作成の詳細は、「変換の追加」を参照してください。