IBM OpenPages with Watson を IBM App Connect Enterprise で使用する場合

IBM® OpenPages® with Watson は、統合されたガバナンス、リスク、コンプライアンス（GRC）プラットフォームであり、企業が企業全体のリスクと規制上の課題を管理することを可能にします。 IBM App Connect Enterprise IBM OpenPages with Watson Input および IBM OpenPages with Watson Request ノードを提供しており、これらを使用して IBM OpenPages with Watson とやり取りすることができます。

以下の手順は、 IBM OpenPages with Watson アカウントに接続し、コネクター・ディスカバリーを使用して IBM OpenPages with Watson Request ノードを構成する方法を示しています。 IBM OpenPages with Watson をモニターするために、 IBM OpenPages with Watson Input ノードを含むフローを作成し、コネクター・ディスカバリーを介してそれを構成することにより、類似の手順に従って IBM OpenPages with Watson Input ノードを構成することができます。

1. IBM App Connect Enterprise ツールキットで、 IBM の OpenPages with Watson リクエストノードを含むフローを作成します。
2. フロー内の IBM OpenPages with Watson Request ノードを選択して、エディターにノード・プロパティーを表示します。
3. 「基本」 タブで、 「コネクター・ディスカバリーの起動」をクリックします。
   コネクターのディスカバリー中に使用するポリシー・プロジェクトの名前とボールトの詳細を指定するパネルが表示されます。
4. コネクターのディスカバリー中に使用するポリシー・プロジェクトとボールトの詳細を指定します。
   1. 「ポリシー・プロジェクト」 フィールドに、コネクター・ディスカバリー中に作成されるポリシーを保管するために使用されるポリシー・プロジェクトを指定します。
      あるいは、「新規」をクリックし、新規ポリシー・プロジェクトの名前を指定して、新規ポリシー・プロジェクトを作成することもできます。 次に、「完了」をクリックします。
   2. コネクターのディスカバリー中に使用するボールトを指定します。 デフォルトでは、コネクターのディスカバリー中に使用される資格情報は、 外部ディレクトリー・ボールトに保管されます。これは、どの統合サーバーでも使用できる App Connect Enterprise ボールトです。 あるいは、資格情報を統合サーバー・ボールトに保管することもできます。統合サーバー・ボールトは、統合サーバーの作業ディレクトリーに作成され、その特定の統合サーバーでのみ使用できます。
      資格情報の保管に使用するボールトを指定するには、以下のいずれかのトピックの「 コネクター・ディスカバリー・ウィザードの使用 」セクションの手順を実行します。

      • 外部ディレクトリ保管庫の設定
      • 統合サーバー・ボールトの構成
   3. 「ボールト鍵 (Vault key)」 フィールドに、ボールトに保管されている資格情報にアクセスするために使用するボールト鍵を入力します。 ボールト鍵の長さは 8 文字以上でなければなりません。
   4. オプション: デフォルトでは、指定されたボールト・ロケーションとボールト・キーが Toolkit の設定として保存されるため、コネクター・ディスカバリーの起動時に値が事前設定されます。 設定を保存しない場合は、ボールト設定に保存 を選択解除します。
5. IBM OpenPages with Watson コネクターの「コネクター・ディスカバリー」ウィザードを開始するには、 「ディスカバリーの起動」 をクリックします。
   「コネクター・ディスカバリー」 ウィンドウが表示されます。 既存の IBM OpenPages with Watson 接続 (アカウント) が使用可能な場合は、それらの接続のリストが表示されます。 既存の接続がない場合、 IBM OpenPages with Watson コネクターの状況は Not connectedと表示されます。
   • 1 つ以上の IBM OpenPages with Watson 接続 (アカウント) が使用可能な場合は、以下の手順を実行します。
     1. 接続 (アカウント) をクリックして、使用する接続を選択します。
     2. 必要なオブジェクト・タイプをクリックし、オブジェクトに対して実行するアクションを選択します。 例えば、 IBM OpenPages with Watsonからアクション項目を取得するには、 「アクション項目」 をクリックし、 「アクション項目の取得」をクリックします。
   • 既存の接続 (アカウント) がない場合は、以下のステップを実行します。
     1. 必要なオブジェクト・タイプをクリックし、そのオブジェクトに対して実行するアクションを選択します。 例えば、 IBM OpenPages with Watsonからアクション項目を取得するには、 「アクション項目」 をクリックし、 「アクション項目の取得」をクリックします。
     2. 「接続」 をクリックします。
     3. 選択したアプリケーション・タイプを選択してください:
        • OpenPagesの場合 IBM Cloud Pak for Dataの場合をクリックし、続けるをクリックします。
        • OpenPages (クラウド・ホストまたはオンプレミス)をクリックし、ドロップダウン・リストから以下のいずれかのオプションをクリックして、 IBM OpenPages with Watsonへの接続に使用する許可方式を選択します。
          1. 使用する App Connect の資格情報の提供 (BASIC)
          2. App Connect が使用する認証情報を指定してください（ SSL ）

          「続行」をクリックします。

     4. IBM OpenPages with Watsonへの接続に使用する資格情報を指定します。 必要な資格情報は、選択したアプリケーション・タイプと許可方式によって異なります。

        表 1. 選択した許可方式またはアプリケーション・タイプの接続フィールド

        使用する App Connect の資格情報の提供 (BASIC)	App Connect が使用する認証情報を指定してください（ SSL ）	OpenPages オン IBM Cloud Pak for Data
        エンドポイント URL	エンドポイント URL	エンドポイント URL
        Username	証明書	Username
        パスワード	キー	パスワード
        		インスタンス名
        		ネットワーク名 (オプション)

        以下の表に、接続フィールドの説明を示します。

        表 2. IBM OpenPages with Watson の接続の詳細

        「接続」フィールド	説明
        エンドポイント URL	インスタンスの URL は IBM OpenPages with Watsonhttps://<hostname> という形式です。 エンドポイント URL がグローバルネットワークからアクセス可能なパブリック URL でない場合は、 IBM Secure Gateway を使用してパブリックネットワーク上でアクセスすることができます。 IBM Secure Gateway に関する詳細は、 IBM Cloud ドキュメントの 「 Secure Gateway の使い方」 をご覧ください。
        Username	IBM OpenPages with Watson アカウントにログインするためのユーザー名。
        パスワード	指定されたユーザー名のパスワード。
        インスタンス名	IBM OpenPages with Watson インスタンスの固有の名前です。 インスタンス名について詳しくは、 OpenPages API 資料の「 OpenPages GRC REST API リファレンス・ガイド 」の「 Addressable space/URI design 」セクションを参照してください。
        証明書	Base64-encoded （ PEM ）形式のクライアント証明書の内容。 この証明書と鍵は、 IBM OpenPages with Watson のアカウント作成時に取得した個人用証明書から生成されます。 クライアント証明書について詳しくは、 OpenPages API 資料の「 OpenPages GRC REST API リファレンス・ガイド 」の「 セキュリティー 」セクションを参照してください。
        キー	Base64-encoded （ PEM ）形式のクライアント証明書キー。 この証明書と鍵は、 IBM OpenPages with Watson のアカウント作成時に取得した個人用証明書から生成されます。 クライアント証明書鍵について詳しくは、 OpenPages API 資料の「 OpenPages GRC REST API リファレンス・ガイド 」の「 セキュリティー 」セクションを参照してください。
        ネットワーク名 (オプション)	IBM App Connect Enterprise がシステムにアクセスする際に使用するネットワーク名を指定します。 このプロパティーは、プライベート・ネットワーク内のシステムに接続する場合にのみ必要です。 IBM App Connect Enterprise ですでにプライベートネットワークへのアクセス権を持つネットワークを設定している場合は、そのネットワークを選択できます。 それ以外の場合は、プライベートネットワークで使用するために、ネットワークを設定する必要があります（ Secure Gateway をダウンロードして設定します）。 詳細については、 『 IBM 』のドキュメント（ App Connect ）にある 「 IBM 用のプライベートネットワークの設定（ App Connect ）」 を参照してください。 重要: Secure Gateway クライアントが開始されていることを確認してください。 必要に応じて、「 IBM App Connect 資料」の「 Configuring a private network for IBM App Connect 」の説明に従って、 Secure Gateway クライアントを開始することができます。

     5. 「接続」 をクリックします。

        これらの接続情報の取得方法の詳細については、 IBM App Connect in containers の「Continuous Delivery (CD)」ドキュメントにある「 IBM OpenPages with Watson での IBM App Connect の使用方法」を参照してください。

6. ウィザードで必要なコネクター・プロパティーを設定します。
   データを取得するための条件を追加するには、 「条件の追加」 をクリックし、フィルターに掛けるプロパティーを選択します。 例えば、指定したリソース ID を持つアクション項目を取得できます。 取得するレコードの最大数と、その制限を超えた場合に実行するアクションを指定するプロパティーを設定することもできます。
7. 「コネクター・ディスカバリー」ウィザードでプロパティーを指定し終えたら、 「保存」をクリックします。
   IBM OpenPages with Watson への接続に使用される資格情報はボールトに保管され、その他の接続の詳細は IBM OpenPages with Watson ポリシーに保存されます。 ウィザードで設定したプロパティの値は、 IBM App Connect Enterprise Toolkit の 「 IBM 」 OpenPages with Watson リクエストノードに返されます。
8. ディスカバリーを終了してプロパティー値を保存したら、ウィンドウの右上隅にある X をクリックするか、 Alt+F4を押して、「コネクター・ディスカバリー」ウィザードを終了します。
9. 「 IBM App Connect Enterprise Toolkit 」内の 「 IBM OpenPages with Watson Request 」ノードの編集画面に戻る。
   「コネクター・ディスカバリー」ウィザード (ステップ 6) で設定したコネクター・プロパティーが、プロパティー・エディターの IBM OpenPages with Watson Request ノードに表示されるようになりました。 「基本」 タブには、ウィザードで設定した 「アクション」 プロパティーと 「オブジェクト」 プロパティーの値が読み取り専用形式で表示されます。 これらの値を変更するには、「コネクター・ディスカバリーの起動」を再度クリックし、「コネクター・ディスカバリー」ウィザードで新しい値を設定します。

   「スキーマ・ベース名」 プロパティーは、 IBM OpenPages with Watson コネクターとの間で送受信される要求メッセージと応答メッセージの形式を記述するスキーマ・ファイルのベース名を指定します。 スキーマ・ベース名は、ノードのディスカバリーの初回実行時に自動的に設定され、現在のフロー名とノード名に基づいています。 ディスカバリーを初めて実行する前にこのプロパティーを手動で設定した場合は、設定した値が使用されます。 ディスカバリー後にスキーマの名前を変更する場合は、プロジェクト内の名前変更されたスキーマによって使用されるスキーマ・ベース名と一致するように、このプロパティーを編集する必要があります。 ディスカバリー後にこのプロパティーを変更した場合は、一致するようにスキーマ名を変更するか、再度ディスカバリーを実行する必要があります。

   「コネクター・ディスカバリー」ウィザードは、ディスカバリー中に選択されたアクションに応じて、要求スキーマと応答スキーマ、または応答スキーマのみのいずれかを生成します。 要求スキーマは、選択したアクションおよびオブジェクトが要求メッセージを必要とする場合にのみ生成されます。 生成された要求スキーマは、要求メッセージの妥当性検査に使用されます。 アクションが RETRIEVE または DELETEであった場合は、応答スキーマのみがコネクターによって返されます。

   生成されたスキーマ・ファイルはプロジェクトに追加され、入力データまたは出力データを変換するために Mapping ノードで使用できます。 スキーマの完全なファイル名は、 response.schema.json または request.schema.jsonの接尾部が付いたスキーマ・ベース名 ( gen/MyMessageFlow.IBM_OpenPages_with_Watson_Requestなど) から派生します。 「要求スキーマを開く」 または 「応答スキーマを開く」をクリックして、スキーマを開くことができます。

10. IBM OpenPages with Watson Request ノードのプロパティー設定が正しいことを確認し、メッセージ・フローを保存します。
11. IBM OpenPages with Watson Request ノードの 「接続」 タブで、 「ポリシー」 プロパティーに、接続に使用されるセキュリティー ID の詳細を含むポリシーの名前が表示されます。 ポリシーのタイプは IBM OpenPages with Watsonです。 詳しくは、 IBM OpenPages with Watson ポリシーを参照してください。
12. オプション: 「接続」 タブの 「タイムアウト」 プロパティーを設定して、ノードが IBM OpenPages with Watson による操作の処理を待機する時間 (秒単位) を指定します。
13. IBM OpenPages with Watson Request ノードの 「フィルター」 タブには、メッセージ・フローがデータを選択する方法を制御するプロパティーが含まれています。 これらのプロパティーの初期値は、「コネクター・ディスカバリー」ウィザードで IBM OpenPages with Watson コネクター用に設定されたプロパティー値から取得されます。これには、フィルター・オプション・プロパティーおよび指定された条件 (ステップ 6で説明) が含まれます。 その後「コネクター・ディスカバリー」ウィザードに戻り、プロパティーの値を変更すると (例えば、新しい条件を追加することによって)、それらの更新はノード上のプロパティー・セットに反映されます。

    「フィルター・オプション」 プロパティーは、 IBM OpenPages with Watson Request ノードの実行時に操作するオブジェクトを制御します。 「フィルター制限」 プロパティーは、取得する項目の最大数と、制限を超えた場合に実行するアクションを制御します。

    値を変更するには、 「フィルター・オプション」 セクションで変更する値の横にある 「編集」 をクリックし、 「フィルター制限」 セクションで設定したプロパティー値を変更します。

    プロパティー値は、テキスト値か、実行時に IBM OpenPages with Watson Request ノードに渡されるメッセージの内容から解決される ESQL または XPATH 式のいずれかです。

14. 「要求」 タブで、 「データの場所」 プロパティーを設定して、 IBM OpenPages with Watsonで作成されるオブジェクト・データを含む着信メッセージ・ツリー内の場所を指定します。 このデータは、 IBM OpenPages with Watson Request ノードから IBM OpenPages with Watson システムに送信される要求を形成します。
15. 「結果」 タブで、 「出力データの場所」 プロパティーを設定して、 IBM OpenPages with Watsonで作成されたレコードのデータが含まれる出力メッセージ・ツリー内の場所を指定します。
16. デフォルトでは、要求メッセージは、コネクター・ディスカバリー中に生成された要求スキーマに照らして検証されます。 IBM OpenPages with Watson Request ノードの 「検証」 プロパティーを使用して、要求の検証をオフにしたり、検証設定を変更したりすることができます。
17. メッセージ・フローを保存 します。