機械翻訳について

接続の作成

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

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

1. ナビゲーション・ペインで、「設計」、「接続」の順にクリックします。

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

   ノート:

   統合キャンバスで接続を作成することもできます。 「インバウンド・トリガーおよびアウトバウンド起動の定義」を参照してください。

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

4. この接続について説明する情報を入力します。

   要素	説明
   名前	他のユーザーが自分で統合の作成を始める場合にこの接続を見つけやすいように、わかりやすい名前を入力します。
   Identifier	名前は、「名前」フィールドに入力した大文字で自動的に表示されます。 識別子名を変更する場合は、空白を含めないでください(例: SALES OPPORTUNITY)。
   ロール	この接続を使用するロール(命令)を選択します(トリガー、呼出し、または両方)。 アダプタでサポートされるロールのみが選択のために表示されます。 ロールを選択すると、そのロールに適切な接続プロパティおよびセキュリティ・ポリシーのみが「Connections」ページに表示されます。 起動とトリガーの両方がサポートされるアダプタを選択し、いずれかのロールのみを選択した場合、選択しなかったセクションにアダプタをドラッグしようとするとエラーが発生します。 たとえば、「Oracle Service Cloud (RightNow)アダプタ」の接続をinvokeのみとして構成するとします。 統合でアダプタをtriggerセクションにドラッグすると、エラーが発生します。
   キーワード	オプションのキーワード(タグ)を入力します。 接続ページで接続キーワードを検索できます。
   説明	接続の説明を入力します(オプション)。
   他のプロジェクトと共有	ノート: このフィールドは、プロジェクトで接続を作成している場合にのみ表示されます。 この接続を他のプロジェクトで公開する場合に選択します。 接続共有により、異なるプロジェクトで個別の接続を作成および維持する必要がなくなります。 別のプロジェクトでアダプタ接続を構成すると、「接続」ページの上部に「共有接続の使用」フィールドが表示されます。 構成している接続が、パブリックに使用可能な接続と同じタイプおよびロールと一致する場合は、その接続を選択してそのリソースを参照(継承)できます。 「プロジェクト間での接続の追加および共有」を参照してください。

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

   接続が作成されました。 これで、接続プロパティ、セキュリティ・ポリシーおよび(一部の接続に対して)アクセス・タイプを構成する準備ができました。

接続プロパティの構成

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

1. 「プロパティ」セクションに移動します。
2. 「Zendeskホスト」フィールドに、Zendeskインスタンスのホスト名を入力します。 たとえば:

   your_subdomain.zendesk.com

接続セキュリティの構成

Zendeskアダプタ接続のセキュリティを構成します。

1. 「セキュリティ」セクションに移動します。
2. 「クライアントID」フィールドで、前提条件セクションのステップを実行した後に取得したクライアントIDを入力します。 「OAuthクライアントの作成」を参照してください。
3. 「クライアント・シークレット」フィールドに、前提条件セクションでステップを実行した後に取得したクライアント・シークレットを入力します。 「OAuthクライアントの作成」を参照してください。
4. (オプション)「スコープ」フィールドにwriteと入力して作成または更新操作を実行します。 特定のモジュールに対して作成または更新操作を実行するには、module_name:write (たとえば、users:write、tickets:writeおよびorganizations:write)を入力します。 複数のモジュールの場合、このフィールドにスペース区切りまたはコンマ区切りのスコープを指定する必要があります。 たとえば、次のように入力します。
   • module_name1:write module_name2:write

     または

   • module_name1:write,module_name2:write

   スコープに値を指定しない場合、デフォルトでreadが追加されます。 デフォルトのスコープはreadで、次のようなメタデータAPIにアクセスする必要があります:

   • GET /api/v2/ticket_fields
   • GET /api/v2/user_fields
   • GET /api/v2/organization_fields
5. 「承諾の指定」をクリックして接続プロパティを確認し、アクセス・トークンを取得します。

   Zendeskアプリケーションのログイン・ページが表示されます。

6. Zendeskログイン資格証明を入力します。
7. アクセス許可のメッセージが表示されたら、接続をテストできます。

エンドポイント・アクセス・タイプの構成

エンドポイントへのアクセスを構成します。 構成しているアダプタの機能によっては、パブリック・インターネット、プライベート・エンドポイント、またはファイアウォールでホストされているオンプレミス・サービスへのアクセスの構成オプションが表示される場合があります。

• エンドポイント・アクセス・タイプの選択
• プライベート・エンドポイント構成が成功したことの確認

エンドポイント・アクセス・タイプの選択

エンドポイントにアクセスするためのオプションを選択します。

オプション	アダプタがサポートしている場合、このオプションが表示されます...
パブリック・ゲートウェイ	パブリック・インターネットを使用したエンドポイントへの接続。
プライベート・エンドポイント	プライベート仮想クラウド・ネットワーク(VCN)を使用したエンドポイントへの接続。 ノート: プライベート・エンドポイントに接続するには、Oracle Cloud Infrastructureコンソールで前提条件タスクを完了する必要があります。 そうしないと、接続のテスト時にエラーが発生します。 「Oracle Integration 3のプロビジョニングと管理」の「プライベート・リソースへの接続」および「Oracle Integration 3での統合の使用」の「プライベート・エンドポイントのトラブルシューティング」を参照してください。

プライベート・エンドポイント構成が成功したことの確認

• プライベート・エンドポイントに接続するには、Oracle Cloud Infrastructureコンソールで前提条件タスクを完了する必要があります。 そうしないと、接続のテスト時にエラーが発生します。 「Oracle Integration 3のプロビジョニングと管理」の「プライベート・リソースへの接続」を参照してください。
• プライベート・ネットワークを使用してエンドポイントに接続するように接続ページでアダプタを構成する場合は、IPアドレスではなく、完全修飾ドメイン名(FQDN)を指定します。 IPアドレスを入力すると、「テスト」をクリックすると検証が失敗します。
• IPSecトンネリングおよびFastConnectは、プライベート・エンドポイントでの使用はサポートされていません。

接続のテスト

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

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

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

2. 接続テストの結果に関するメッセージを待機します。
   • テストに成功した場合、接続は適切に構成されています。
   • テストが失敗した場合は、入力した構成詳細を編集します。 入力ミスを確認し、URLおよび資格証明を確認してください。 接続が成功するまでテストを続けます。
3. 完了したら「保存」をクリックします。