エージェント・グループの作成

接続性エージェントをインストールする前に、Oracle Integrationにエージェント・グループを作成する必要があります。単一のOracle Integrationインスタンスの場合、最大5つのエージェント・グループを作成できます。 1つのエージェント・グループに最大2つの接続エージェントを関連付けることができます。

エージェント・グループを作成すると、アイデンティティ・ドメイン環境のOAuthクライアント・アプリケーションなど、メッセージ交換に必要なアーティファクトも作成されます。 OAuthクライアント・アプリケーションを使用すると、接続エージェントは、Oracle Integrationエンドポイントの起動時にOAuth 2.0トークン・ベース認証を使用できます。接続名は作成後に編集できます。

作成するエージェント・グループの数および各グループ内のエージェントの数など、接続エージェントの設定を計画します。

「接続エージェント設定の計画」を参照してください。
ナビゲーション・ペインで、「設計」、「エージェント」の順にクリックします。
「作成」をクリックします。

エージェント・グループの作成パネルが開きます。

次の情報を入力し、「Create」をクリックします。

フィールド	説明
名前	他のユーザーがエージェント名を理解できるように意味のある名前を入力します。名前は、システム内のすべてのエージェント名の間で一意である必要があります。名前には、次を含めることができます。文字(A-Z、a-z) 数字(0-9) 空白( ) 特殊文字( _ - ) 名前は、先頭または末尾にスペースを使用することはできず、50文字を超えることもできません。
識別子	必要に応じて、デフォルトの識別子値のままにするか、変更します。識別子は最初、指定したエージェント・グループ名と同じですが、ただし、大文字です。エージェントをインストールすると、識別子値が`InstallerProfile.cfg`ファイルに自動的に含まれます。ノート: エージェント・グループを作成した後、エージェント・グループ識別子を編集することはできません。代わりに、別のエージェント・グループを削除して再作成し、別のエージェント・グループ識別子に関連付ける必要があります。
説明	他のユーザーがエージェント・グループの処理内容を理解できるように意味のある説明を入力します。
一度に1つのエージェントを使用	2つの接続エージェントをエージェント・グループに関連付ける場合は、oneエージェントと「両方」エージェントのどちらをいつでもアクティブにするかを指定する必要があります。本番サービス・インスタンスの優先設定は、2つのエージェントをエージェント・グループに関連付け、この設定を「無効」のままにすることです。ただし、特定のアダプタを使用する場合は、この設定が必要な場合や有効にする必要がある場合があります。後でこの設定を変更できないため、設定の計画に数分かかります。 (ただし、エージェント・グループを削除して再度作成できます。) エージェントの設定に関する一般的なガイダンスは、「接続エージェント設定の計画」を参照してください。この設定の具体的なガイダンスについては、「アクティブ接続エージェントの数」を参照してください。ノート: 「一度に1つのエージェントのみを使用」を選択してから、エージェント・グループに接続エージェントを1つのみ関連付けると、エージェント・グループは、オプションを選択したことがないかのように機能します。アクティブ/パッシブ・エージェント機能を実現するには、2番目のエージェントをそのエージェント・グループに関連付ける必要があります。エージェント・グループの作成後に「一度に1つのエージェントのみを使用」設定を変更することはできません。ただし、エージェント・グループを削除して新しいエージェント・グループを作成できます。

このアクションにより、アイデンティティ・ドメインにOAuthクライアント・アプリケーションが自動的に作成されます。アプリケーション名の形式は次のとおりです:

agent_group_name-instance_identity_provider_name

これにより、接続エージェントは、エンドポイントの起動時にOAuth 2.0トークン・ベースの認証を使用できます。 Oracle Integration 3では、各エージェント・グループに独自のOAuthクライアント・アプリケーションがあります。

「一度に1つのエージェントのみを使用」を有効にすると、ラベル「シングルトン」がエージェント・グループ名の横に表示されます。