Microsoft Teams と IBM App Connect Enterprise の併用

Microsoft Teams これは、リモートチームが情報を共有し、協働するための共通プラットフォームを提供するチャットベースのツールです。 Microsoft Teams Microsoft 365 と連携します。 IBM® App Connect Enterprise Microsoft Teams 入力ノードと Microsoft Teams リクエストノードを提供しており、これらを使用して Microsoft Teams とやり取りすることができます。

以下の手順では、コネクタ検出機能を使用して Microsoft Teams アカウントに接続し、 Microsoft Teams リクエストノードを設定する方法について説明します。 同様の手順で、` Microsoft Teams ` Input ノードを含むフローを作成し、コネクタ検出を通じて設定を行うことで、` Microsoft Teams ` Inputノードを構成し、` Microsoft Teams `上の新規または更新されたオブジェクトを監視するように設定できます。

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

      • 外部ディレクトリ保管庫の設定
      • 統合サーバー・ボールトの構成
   3. 「ボールト鍵 (Vault key)」 フィールドに、ボールトに保管されている資格情報にアクセスするために使用するボールト鍵を入力します。 ボールト鍵の長さは 8 文字以上でなければなりません。
   4. オプション: デフォルトでは、指定されたボールト・ロケーションとボールト・キーが Toolkit の設定として保存されるため、コネクター・ディスカバリーの起動時に値が事前設定されます。 設定を保存しない場合は、ボールト設定に保存 を選択解除します。
5. 「ディスカバリーを開始」 をクリックして、 Microsoft Teams コネクタのコネクタディスカバリーウィザードを起動します。
   「コネクター・ディスカバリー」 ウィンドウが表示されます。 既存の Microsoft Teams 接続（アカウント）がある場合、それらの接続の一覧が表示されます。 既存の接続がない場合、 Microsoft Teams コネクタのステータスは として表示されます Not connected。
   • 1つ以上の Microsoft Teams 接続（アカウント）が利用可能な場合は、以下の手順を実行してください：
     1. 接続 (アカウント) をクリックして、使用する接続を選択します。
     2. 必要なオブジェクト・タイプをクリックし、オブジェクトに対して実行するアクションを選択します。 たとえば、 Microsoft Teams からチャンネルを取得するには、 「チャンネル」 をクリックし、次に 「チャンネルを取得」 をクリックします。
   • 既存の接続 (アカウント) がない場合は、以下のステップを実行します。
     1. 必要なオブジェクト・タイプをクリックし、そのオブジェクトに対して実行するアクションを選択します。 たとえば、 Microsoft Teams からチャンネルを取得するには、 「チャンネル」 をクリックし、次に 「チャンネルを取得」 をクリックします。
     2. 「接続」 をクリックして、アカウントの詳細を入力するウィンドウを表示します。
        1. アクセス・トークン: Microsoft ID プラットフォーム・エンドポイントに POST 要求を送信することによって要求されたアクセス・トークン。 通常は、 Microsoft Azure アプリ登録ポータルで登録された App Connect アプリのクライアント ID、テナント ID、クライアント・シークレット、スコープ、付与タイプ、ユーザー名、およびパスワードの値を使用して生成されます。
        2. リフレッシュ・トークン: Microsoft ID プラットフォーム・エンドポイントへの POST 要求に対して返されたリフレッシュ・トークン。
        3. クライアント ID: Microsoft Azure アプリケーション登録ポータルに登録され、登録済みアプリケーションの概要ページに表示された App Connect アプリケーション用に生成されたアプリケーション (クライアント) ID 値。
        4. クライアント秘密鍵: Microsoft Azure アプリ登録ポータルで登録された App Connect アプリ用に生成されたクライアント秘密鍵。 クライアント・シークレットは、登録済みアプリの「証明書とシークレット」の下に生成されます。
        5. プロキシ名： 必要に応じて、 IBM App Connect Enterprise がコネクタへの呼び出しを転送するために使用するプロキシの名前を入力してください。
     3. 「接続」 をクリックします。

     これらの接続情報の特定に関する詳細については、『 IBM 』 の「継続的デリバリー（CD） 」ドキュメントにある「 Microsoft Teams での IBM の使用方法」（ App Connect ）を参照してください（ App Connect in containers ）。

6. ウィザードで必要なコネクター・プロパティーを設定します。
   データを取得するための条件を追加するには、 「条件の追加」 をクリックし、フィルターに掛けるプロパティーを選択します。 例えば、 「チャネル」 を選択してから 「チャネルの取得」を選択した場合、 「表示名」 を選択して、 equals フィールドに表示名を指定できます。 取得するレコードの最大数と、その制限を超えた場合に実行するアクションを指定するプロパティーを設定することもできます。
7. 「コネクター・ディスカバリー」ウィザードでプロパティーを指定し終えたら、 「保存」をクリックします。
   Microsoft Teams への接続に使用される認証情報はボールトに保存され、その他の接続情報は「 Microsoft Teams 」ポリシーに保存されます。 ウィザードで設定したプロパティの値は、 IBM App Connect Enterprise Toolkit の 「 Microsoft Teams Request 」ノードに返されます。
8. ディスカバリーを終了してプロパティー値を保存したら、ウィンドウの右上隅にある X をクリックするか、 Alt+F4を押して、「コネクター・ディスカバリー」ウィザードを終了します。
9. 「 IBM App Connect Enterprise 」ツールキット内の 「 Microsoft Teams 」リクエストノードの編集画面に戻る。
   「コネクタ検出ウィザード」（手順 6 ）で設定されたコネクタのプロパティが、プロパティエディタの 「 Microsoft Teams Request 」ノードに表示されるようになりました。 「基本」 タブには、ウィザードで設定した 「アクション」 プロパティーと 「オブジェクト」 プロパティーの値が表示されます。 例えば、ウィザードでChannels > Retrieve channelsを選択した場合、ノードのBasicタブに以下のプロパティが表示されます：

   • 処置 - RETRIEVEALL
   • オブジェクト - Channel

   処置 プロパティーおよび オブジェクト プロパティーの値は、読み取り専用形式で表示されます。 これらの値を変更するには、「コネクター・ディスカバリーの起動」を再度クリックし、「コネクター・ディスカバリー」ウィザードで新しい値を設定します。

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

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

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

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

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

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

    プロパティの値は、テキスト値、または Microsoft Teams リクエストノードの実行時に、そのノードに渡されるメッセージの内容から解決されるESQLまたはXPATH式とすることができます。

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