機械翻訳について
  1. Oracle Integration 3でのSalesforceアダプタの使用
  2. 統合へのSalesforceアダプタ接続の追加
  3. Apex操作の起動ページ

Apex操作の起動ページ

Salesforce起動の「APEX操作」ページで、次の値を指定します。

アクション・ページで「Apex Webサービスの起動」を選択した場合は、次のオプションが表示されます。 Salesforce.comアプリケーションで実行する操作を選択します:

Apex SOAP

Apex SOAPは、Apexを介して「Salesforceアダプタ」で公開されるSOAPエンドポイントの消費をサポートします。

要素 説明
Apex WSDLの選択 「ファイルを選ぶ」をクリックして、使用するApex WSDLを選択します。

アップロードされたWSDLの操作

アップロードされたApex WSDLに含まれている操作のリストが表示されます。 Salesforce Cloudアプリケーションで実行する操作を選択します。

新規Apex WSDLの選択 「ファイルを選ぶ」をクリックして、使用するApex WSDLを選択します。 この選択により、以前にアップロードされたWSDLファイルが置き換えられます。 新しいWSDLを選択してから、「Operations in Uploaded WSDL」リストに戻り、使用する新しい操作を選択します。

force.comに記述され、SOAP webサービスとして公開されるApexクラスを含むApex WSDLを使用できます。 「ApexメソッドのSOAP Webサービスとしての公開」を参照してください。

Apex REST

Apex RESTは、Apexを介して「Salesforceアダプタ」で公開されるRESTエンドポイントの消費をサポートします。

ノート:

Apex REST操作を使用する必要がある場合は、「Salesforceアダプタ」接続のOAuthベースのセキュリティ・ポリシーを構成します。 これは、「Salesforceアダプタ」接続のユーザー名パスワード・セキュリティ・ポリシーを構成する場合、Apex REST操作がサポートされていないためです。
要素 説明

What is the endpoint’s relative resource URI?

 リソースに関連付けられた相対パスを指定します。 このパスには、テンプレート・パラメータを中カッコで囲んで指定できます(たとえば、{order-id})。 対処できる特定の情報のソースをリソースとして指定できます。 リソース・パスの形式は、接頭辞付きURLの後に指定の相対パスを付加したものです。 デフォルトではURLの接頭辞は次のパスです。 
https://yourInstance.salesforce.com/services/apexrest/

エンドポイントでどのアクションを実行しますか。

 エンドポイントで実行する1つのHTTPアクション(メソッド)を選択します。
  • GET: 情報を取得(読取り)します(たとえば、問合せの実行)。 このオプションを選択した場合、このエンドポイントのリクエスト・ペイロードを構成できません。
  • PUT: 情報を更新します。
  • POST: 情報を作成します。
  • DELETE: 情報を削除します。 このオプションを選択した場合、このエンドポイントのリクエスト・ペイロードを構成できません。
  • PATCH: 既存のリソースを部分的に更新します(たとえば、リソースの1つの属性のみを更新する必要がある場合)。

構成するオプションを選択してください 選択内容に基づいて、パラメータを追加したり、このエンドポイントのリクエストやレスポンスを構成できます。
  • Add and review parameters for this endpoint: クリックして、問合せパラメータを指定し、このエンドポイントのリソースURIに含めて作成したテンプレート・リクエスト・パラメータを確認します。 このオプションを選択すると、問合せおよび「テンプレート・パラメータ」ページが表示されます。
  • このエンドポイントのリクエスト・ペイロードの構成: JSONサンプルのロケーションの指定など、このエンドポイントのリクエスト・ペイロードを構成する場合にクリックします。 このオプションを選択すると、「サンプル・リクエスト・ペイロード」ページが表示されます。

    ノート: この(このエンドポイントのリクエスト・ペイロードの構成)オプションがサポートされているのは、PUTおよびPOSTアクションのみです。 したがって、PUTまたはPOSTアクションを選択すると、このオプションが表示されます。

  • レスポンスを受信するようにこのエンドポイントを構成: JSONサンプルのロケーションの指定など、このエンドポイントのレスポンス・ペイロードを構成する場合にクリックします。 このオプションを選択すると、「サンプル・レスポンス・ペイロード」ページが表示されます。

問合せおよびテンプレート・パラメータ・ページ

Apex Operationsページで「このエンドポイント・オプションのパラメータを追加および確認」を選択すると、次のオプションが表示されます。

要素 説明

Specify Query Parameters

 RESTエンドポイントの問合せパラメータを指定します。

「Add」アイコンをクリックすると、パラメータ名を入力してデータ型を選択するための行が表示されます。 たとえば、stateを指定し、データ型stringを選択します。

「Delete」アイコンをクリックすると、選択した行が削除されます。

テンプレート・パラメータ

 相対リソースURIのテンプレート・パラメータが表示されます。 テンプレート・パラメータは、Basic Infoページに指定した詳細情報に基づいています。編集することはできません。

テンプレート・パラメータは、パスの一部として中カッコで囲んで定義する必要があります。 たとえば、URL default/customers/{cust-id}/{ship-id}には、cust-idおよびship-idテンプレート・パラメータがあります。

パラメータのデータ型は変更できます。

サンプルのリクエスト・ペイロードの起動ページ

「APEX操作」ページで「このエンドポイントのリクエスト・ペイロードの構成」を選択すると、次のオプションが表示されます。

ノート:

「このエンドポイントのリクエスト・ペイロードの構成」オプションは、「APEX操作」ページでPUTまたはPOSTアクションが選択されている場合にのみ表示されます。
要素 説明
リクエスト・ペイロード書式を選択 使用するリクエスト・ペイロード形式を選択します。
  • JSON: サンプルのリクエスト・ペイロードを含むJSONファイルをアップロードするか、JSONペイロードをコピーしてテキスト・フィールドに貼り付けます。
  • バイナリ: 非構造化およびインラインのペイロード(application/octet-streamなど)で使用します。 このオプションではファイルの内容が保持されますが、レシーバがファイル・タイプを決定する必要があります(たとえば、ファイル名拡張子から)。 任意のバイト・ストリームのインターネット・メディア・タイプはapplication/octet-streamです。 よく使用されるタイプのリストがドロップダウン・リストに表示されます。 このリストからタイプを選択するか、「その他のメディア・タイプ」を選択してテキスト・フィールドにタイプを入力することで、リストされていないタイプを指定できます。

ノート: サンプルJSONが、エンドポイントと交換される実際のランタイム・メッセージの代表であることを確認します。 ランタイム・メッセージの構造またはタイプが一致しないと、エラーが発生する可能性があります。

サンプル・ペイロードのロケーション 次のいずれかの方法で、サンプルJSONリクエスト・ペイロード・ファイルを指定します:
  • 「ファイルを選ぶ」をクリックして、使用するサンプルJSONリクエスト・ペイロードを選択します。
  • <<inline>>をクリックして、JSONペイロードをコピーして貼り付けます。 完了後に「要素の生成」をクリックします。
要素 ペイロードの構造を定義する要素を選択します。 このフィールドは、リクエスト・ペイロード・ファイルをインポートした後で表示されます。
エンドポイントで送信に使用するペイロードのタイプを選択

(「バイナリ」ペイロード形式が選択されている場合。)

ドロップダウン・メニューに表示される一般的に使用されるタイプのリストから選択します。 「その他のメディア・タイプ」を選択して、ドロップダウン・リストに表示されないタイプ(video/mp4など)を指定することもできます。

サンプルのレスポンス・ペイロードの起動ページ

「APEX操作」ページで「レスポンスを受信するようにこのエンドポイントを構成」を選択すると、次のオプションが表示されます。

要素 説明

レスポンス・ペイロード書式を選択

 レスポンス・ペイロードはJSONにのみできます。
  • サンプル・レスポンス・ペイロードを含むJSONファイルをアップロードします。
  • JSONペイロードをコピーして貼り付けます。

ノート: サンプルJSONが、エンドポイントと交換される実際のランタイム・メッセージの代表であることを確認します。 ランタイム・メッセージの構造またはタイプが一致しないと、エラーが発生する可能性があります。

サンプル・ペイロードのロケーション

 次のいずれかの方法で、サンプルJSONレスポンス・ペイロード・ファイルを指定します:
  • 「ファイルを選ぶ」をクリックして、使用するサンプルJSONレスポンス・ペイロードを選択します。
  • <<inline>>をクリックして、JSONペイロードをコピーして貼り付けます。 完了後に「要素の生成」をクリックします。
要素 ペイロードの構造を定義する要素を選択します。 このフィールドは、レスポンス・ペイロード・ファイルをインポートした後で表示されます。