機械翻訳について

接続の作成

統合を構築する前に、データを共有するアプリケーションへの接続を作成する必要があります。

Oracle Integrationで接続を作成するには:

1. 左側のナビゲーション・ペインで、「ホーム」→「統合」→「接続」をクリックします。

2. 「作成」をクリックします。

   ノート:

   また、以下の統合キャンバスで接続を作成することもできます:

   • オーケストレートされた統合(「インバウンド・トリガーおよびアウトバウンド起動の定義」を参照)。

   • 基本的なルーティング統合(「トリガー(ソース)接続の追加」を参照)

3. 接続の作成 - 「アダプタの選択」ダイアログ。この接続に使用するアダプタを選択します。 アダプタを検索するには、リストをスクロールするか、「検索」フィールドに名前の一部または全部を入力して「検索」をクリックします。

4. 「接続の作成」ダイアログで、この接続を説明する情報を入力します。

   1. 他のユーザーが自分で統合の作成を始める場合にこの接続を見つけやすいように、わかりやすい名前を入力します。 入力した名前は、自動的に大文字で「識別子」フィールドに追加されます。 識別子名を変更する場合は、空白を含めないでください(例: SALES OPPORTUNITY)。
   2. オプションのキーワード(タグ)を入力します。 接続ページで接続キーワードを検索できます。
   3. この接続を使用するロール(方向)を選択します(トリガー、呼出し、または両方)。 アダプタでサポートされるロールのみが選択のために表示されます。 ロールを選択すると、そのロールに適切な接続プロパティおよびセキュリティ・ポリシーのみが「接続」ページに表示されます。 起動とトリガーの両方がサポートされるアダプタを選択し、いずれかのロールのみを選択した場合、選択しなかったセクションにアダプタをドラッグしようとするとエラーが発生します。 たとえば、invokeのみとして「Oracle Service Cloud (RightNow)アダプタ」の接続を構成するとします。 統合でアダプタをtriggerセクションにドラッグすると、エラーが発生します。
   4. 接続の説明を入力します(オプション)。

5. 「作成」をクリックします。

   接続が作成されました。 接続プロパティ、セキュリティ・ポリシー、接続ログイン資格証明、(特定の接続の場合)エージェント・グループなどの接続詳細を構成する準備ができました。

接続プロパティの構成

アプリケーションがリクエストを処理するための接続情報を入力します。

1. 「接続プロパティ」セクションに移動します。
   表示されるフィールドは、インスタンスのバージョンによって異なります。
2. インスタンスのバージョンに基づいて詳細を指定します。

   ノート:

   Oracle Integrationリリース21.2.1.0.0 (211110.1100.42360)以降で「Salesforceアダプタ」接続を作成または編集する場合は、「APIバージョン」フィールドにAPIバージョン47以降を指定するか、APIバージョン47以降のエンタープライズWSDLをアップロードする必要があります。

   既存の接続を編集または新規接続を作成するには...	説明
   Oracle Integrationのリリース20.2.2.0.0 ( 200524.0200.35760)以降	「Salesforce.comインスタンス・タイプの選択」リストから、インスタンス・タイプを選択します: 本番 サンドボックス 政府関連: Salesforce Government Cloudに接続する場合に選択します。 ノート: インスタンス・タイプの詳細は、Salesforce組織のインスタンス・タイプの識別を参照してください。 「カスタム・ドメイン」フィールドに、カスタム・ドメイン名を入力します。 たとえば、カスタム・ドメイン名がsfcustomdomain.my.salesforce.comの場合は、sfcustomdomainと入力します。 「カスタム・ドメイン名の取得」を参照してください。 ノート: 「政府関連」インスタンス・タイプ・オプションおよび「カスタム・ドメイン」フィールドは、Oracle Integrationのリリース20.3.3以降で作成された接続に対して表示されます。 「カスタム・ドメイン」フィールドはオプションです。 ただし、Salesforce Government Cloudまたはカスタム・ドメインを使用してSalesforceアカウントにログインする場合は、カスタム・ドメイン名が必要です。 「Salesforceアダプタ」では、カスタム・ドメイン名としてSalesforceインスタンス値を使用しないことをお薦めします(たとえば、URL https://ap1.salesforce.comでは、salesforce.comより前の値がSalesforceインスタンス値です)。 test、login、sfcustomdomain.my、sfcustomdomain.my.salesforce.comなどの一般的な単語をカスタム・ドメイン名として使用しないでください。 「APIバージョン」フィールドに、使用するAPIバージョンを入力します。 「現在のSalesforce APIバージョンの検索」を参照してください。 ノート: リリース20.2.2.0.0 ( 200524.0200.35760)以降Oracle Integrationで作成された既存の接続を編集すると、インスタンス・タイプおよびAPIバージョン・フィールドが表示されます。
   Oracle Integration 20.2.2.0.0 ( 200524.0200.35760)より前のリリース	「ファイルのアップロード」チェック・ボックスを選択し、「アップロード」をクリックして、この統合で使用するエンタープライズWSDLを選択します。 エンタープライズWSDLは必須であり、カスタムWSDLやアウトバウンド・メッセージングWSDLを同時に使用するかどうかに関係なく指定する必要があります。 「SalesforceエンタープライズWSDLの生成」を参照してください。 ノート: Oracle Integrationのリリース20.2.2.0.0 (200524.0200.35760)の前に作成された既存の接続を編集すると、エンタープライズWSDLをアップロードするフィールドが表示されます。

接続セキュリティの構成

セキュリティ・ポリシーを選択して、「Salesforceアダプタ」接続のセキュリティを構成します。

1. 「セキュリティ」セクションに移動します。
2. 「セキュリティ・ポリシー」リストから、セキュリティ・ポリシーを選択します。
   • Salesforceのユーザー名のパスワード・ポリシー
   • 「認可コード資格証明」 (Salesforce OAuth 3-legged)
   • リソース所有者のパスワード資格証明
3. 「Salesforceのユーザー名のパスワード・ポリシー」を選択した場合。
   1. 「ユーザー名」フィールドに、ユーザー名を入力します。
   2. 「パスワード」フィールドで、パスワード(パスワードとセキュリティ・トークンの組合せ)を入力します。
      セキュリティ・トークンは、パスワードの最後に追加する必要があります。 Salesforce.com APIは、パスワードのリセット時にセキュリティ・トークンを生成します。 たとえば、Salesforce.comによって生成されたセキュリティ・トークンがSSSSSSSSSSSで、パスワードがpasswordである場合、passwordSSSSSSSSSSSを入力してログインする必要があります。 パスワードを変更するか、Salesforce.comユーザー・インタフェースを介してセキュリティ・トークンをリセットして、セキュリティ・トークンを取得します。 セキュリティ・トークンは、Salesforce.comに登録された電子メール・アドレスで受信されます。 このトークンは、各アカウントのセキュリティ・トークンをリセットするか、パスワードを変更するまで有効です。
   3. 「パスワードの確認」フィールドに、確認のためもう一度パスワードを再入力します。
4. 「認可コード資格証明」を選択した場合。
   1. 「クライアントID」フィールドで、接続されたアプリケーションの作成時に取得したコンシューマ・キー/クライアントIDを入力します。 「Salesforce OAuth 3-Legged (認可コード資格証明)またはリソース所有者のパスワード資格証明のセキュリティ・ポリシーを使用するための前提条件」を参照してください。
   2. の「クライアント・シークレット」フィールドに、接続アプリケーションの作成時に取得したクライアントのシークレット・キーを入力します。 「Salesforce OAuth 3-Legged (認可コード資格証明)またはリソース所有者のパスワード資格証明のセキュリティ・ポリシーを使用するための前提条件」を参照してください。
   3. 「クライアント・シークレットの確認」フィールドに、クライアントのシークレットを再入力して確認を受けます。
   4. 「スコープ」フィールドに、id api refresh_tokenと入力します。 これは、接続を構成するために必要な最小スコープです。 接続しているアプリケーションに、これらのスコープが構成されていることを確認します。 「Salesforce OAuth 3-Legged (認可コード資格証明)またはリソース所有者のパスワード資格証明のセキュリティ・ポリシーを使用するための前提条件」を参照してください。

      ノート:

      「スコープ」フィールドには、アスタリスク(*)は付いていません。 これが誤っている場合、このフィールドは必須ではありません。 このフィールドは必須です。
   5. 「Provide Consent」をクリックします。 Salesforceのログイン・ページにリダイレクトされます。
   6. が、資格証明を使用してSalesforceアカウントにログインします。 正常にログインすると、次のメッセージが表示されます:

      Access Allowed! Please switch back to connection page to proceed with 
      testing and saving connection configuration.

5. 「リソース所有者のパスワード資格証明」を選択した場合。
   1. 「クライアントID」フィールドで、接続されたアプリケーションの作成時に取得したコンシューマ・キー/クライアントIDを入力します。 「Salesforce OAuth 3-Legged (認可コード資格証明)またはリソース所有者のパスワード資格証明のセキュリティ・ポリシーを使用するための前提条件」を参照してください。
   2. の「クライアント・シークレット」フィールドに、接続アプリケーションの作成時に取得したクライアントのシークレット・キーを入力します。 「Salesforce OAuth 3-Legged (認可コード資格証明)またはリソース所有者のパスワード資格証明のセキュリティ・ポリシーを使用するための前提条件」を参照してください。
   3. 「クライアント・シークレットの確認」フィールドに、クライアントのシークレットを再入力して確認を受けます。
   4. 「ユーザー名」フィールドに、ユーザー名を入力します。
   5. 「パスワード」フィールドで、パスワード(パスワードとセキュリティ・トークンの組合せ)を入力します。
      セキュリティ・トークンは、パスワードの最後に追加する必要があります。 Salesforce.com APIは、パスワードのリセット時にセキュリティ・トークンを生成します。 たとえば、Salesforce.comによって生成されたセキュリティ・トークンがSSSSSSSSSSSで、パスワードがpasswordである場合、passwordSSSSSSSSSSSを入力してログインする必要があります。 パスワードを変更するか、Salesforce.comユーザー・インタフェースを介してセキュリティ・トークンをリセットして、セキュリティ・トークンを取得します。 セキュリティ・トークンは、Salesforce.comに登録された電子メール・アドレスで受信されます。 このトークンは、各アカウントのセキュリティ・トークンをリセットするか、パスワードを変更するまで有効です。
   6. 「パスワードの確認」フィールドに、確認のためもう一度パスワードを再入力します。

   ノート:

   あるSalesforce環境から別の環境に接続を切り替えたり、セキュリティ・ポリシーを切り替える場合は、正しい環境を指すように統合を再アクティブ化する必要があります。

接続のテスト

接続をテストして、接続が正常に構成されていることを確認します。

1. ページ・タイトル・バーで、「テスト」をクリックします。 次に何が起こるかは、接続でWeb Services Description Language (WSDL)ファイルを使用しているかどうかによって異なります。

   接続の場合...	結果
   WSDLを使用しない	テストが自動的に開始され、接続に指定した入力が検証されます。
   WSDLの使用	実行する接続テストのタイプを選択するダイアログが表示されます: 検証とテスト: インポートされたスキーマおよびWSDLの処理など、WSDLの完全な検証を実行します。 インポートされたスキーマおよびWSDLの数によっては、完全な検証に数分かかる場合があります。 WSDLで公開されている操作に送信されたリクエストはありません。 テスト: WSDL URLに接続し、WSDLに対して構文チェックを実行します。 WSDLで公開されている操作に送信されたリクエストはありません。

2. 接続テストの結果に関するメッセージを待機します。
   • テストに成功した場合、接続は適切に構成されています。
   • テストが失敗した場合は、入力した構成詳細を編集します。 入力ミスがないかチェックし、URLと資格証明を検証して、診断ログで追加の詳細をダウンロードします。 接続が成功するまでテストを続けます。
3. 完了したら「保存」をクリックします。