自己設定アプリ用のマニフェストファイルの作成およびダウンロード

  • リリースバージョン: Yokohama
  • 更新日 2025年01月30日
  • 所要時間：6分

    • ServiceNow for Microsoft Teams マニフェストファイルをインスタンスから作成してダウンロードし、Microsoft Teams が ServiceNow for Teams アプリを使用できるようにします。

    始める前に

    必要なロール：external_app_install_admin

    このタスクについて

    複数の ServiceNow インスタンスを 1 つの Microsoft Teams テナントに接続できます。詳細については、「Integrating multiple ServiceNow instances with a single Microsoft Teams tenant」を参照してください。

    自己設定アプリ環境ごとに個別の Azure アプリを作成できるため、複数の自己設定アプリ環境を Microsoft Teams テナントに接続できます。

    このプロセスは、アプリケーションが Microsoft Teams でどのように動作するかを指示する Microsoft Teams マニフェストファイルを構成するためのものです。ITSM/HR によって提供されるマニフェストの生成については、利用可能な構成の詳細が記載されている「Auto-generate the manifest file for uploading on Microsoft Teams」を参照してください。

    注:
    Microsoft Teams テナントには、1 つの事前公開済みアプリセットアップのみを接続できます。事前公開済みアプリのマニフェストファイルを作成する方法の詳細については、「事前公開済みアプリ用のマニフェストファイルの作成およびダウンロード」を参照してください。

    手順

    1. 次のように移動する。 All (すべて) > ServiceNow の Microsoft Teams > アプリケーションマニフェスト > ServiceNow for Teams.
    2. [New (新規)] を選択します。
      [一般情報] セクションが開きます。
    3. [一般情報] セクションのフィールドに入力します。
      表 : 1. 一般情報フォーム
      フィールド 説明
      短い名前 マニフェストファイルの短い名前。
      フルネーム マニフェストファイルのフルネーム。
      バージョン マニフェストファイルのバージョン。例えば、1.0.0。
      リンクを展開 Microsoft Teams でリンクを展開するオプション。

      リンク展開は、サポートされているリンクが Microsoft Teams のユーザーとの会話で共有された場合に、コンテンツリッチなプレビュー (アダプティブカード) を生成します。リンク展開の詳細については、「Microsoft Teams チャットでの Web リンクの展開」を参照してください。
      簡単な説明 マニフェストファイルに関する簡単な説明。
      説明 マニフェストファイルに関する詳細な説明。
      アクセントカラー 会社のブランディングに従って、Microsoft Teams の会話のカスタムカラーを選択するオプション。アクセントカラーは HTML カラーコード形式である必要があります。
      デフォルト画像を使用 ブランディングにデフォルト画像を使用するオプション。
      注:
      会社のブランディングをカスタマイズする場合は、[デフォルト画像を使用] オプションをオフにしてからアイコンをアップロードします。アイコンのサイズの詳細については、「アプリアイコン」および「マニフェストスキーマアイコン (manifest schema icons)」を参照してください。
    4. [送信] を選択します。
    5. [次へ] を選択します。

      [一般情報] タブの [次へ] オプション
      [仮想エージェントの構成 (Configure Virtual Agent)] セクションが開きます。
    6. [仮想エージェントの構成 (Configure Virtual Agent)] セクションで、次のいずれかのオプションを実行します。
      • 1 つの ServiceNow インスタンスを Microsoft Teams テナントに接続する場合は、[単一の ServiceNow インスタンスを Microsoft Teams テナントに接続 (Connect a single ServiceNow instance to your Microsoft Teams Tenant)] を選択します。このオプションを選択すると、仮想エージェントボット ID が自動的に入力されます。これは、事前公開済みのアプリに適用されます。詳細については、「事前公開済みアプリ用のマニフェストファイルの作成およびダウンロード」を参照してください。
      • 複数の ServiceNow インスタンスを 1 つの Microsoft Teams テナントに接続する場合は、[複数の ServiceNow インスタンスを Microsoft Teams テナントに接続 (Connect multiple ServiceNow instances to your Microsoft Teams tenant)] を選択します。

      [仮想エージェントの構成] タブ

      インスタンスで仮想エージェントを構成するには、[仮想エージェントの構成] を選択します。詳細については、「Microsoft Teams との対話型統合」を参照してください。

      独自のボットを構成してと仮想エージェントと Microsoft Teams を統合するには、「自己設定ボットを使用した仮想エージェントと Microsoft Teams の統合」を参照してください。

    7. [タブを構成 (Configur Tab)] セクションで、フィールドに入力します。
      表 : 2. [タブを構成 (Configur Tab)] フォーム
      フィールド 説明
      [タブの有効化 (Enable tabs)] Microsoft Teams アプリケーションにタブを追加するオプション。このオプションがデフォルトで選択されています。
      タブ名 Microsoft Teams アプリケーションに表示されるサービスポータルタブの名前。
      アクティビティフィードを有効化 Microsoft Teams でキャンペーン通知を受信するためにアクティビティフィードを有効にするオプション。このオプションがデフォルトで選択されています。
      アプリケーション (クライアント) ID Azure アプリのクライアント ID。
      ディレクトリー (テナント) ID Azure アプリのテナント ID。

      自己設定アプリの場合は、[タブを構成] セクションにアプリケーション (クライアント) ID とディレクトリ (テナント) ID を入力する必要があります。テナント ID とクライアント ID (アプリ ID) は Azure ポータルから取得できます。


      自己設定アプリのオプション
    8. [次へ] を選択します。
      [準備完了] セクションが開きます。
    9. キャンペーンの通知を受信するため、[準備完了] セクションで [アクティビティフィードを有効化] オプションを選択します。
    10. アプリケーションレジストリレコードに移動し、OIDC プロバイダー構成情報レコードを表示します。
      • ページ上部の情報メッセージにあるリンクを選択します。
      • 次のように移動する。 システム OAuth > アプリケーションレジストリー をクリックし、 [Azure AD - <Tenant-ID>] を選択します。
      ユーザー要求は、Microsoft Entra ID (Entra ID) からフェッチされる id_token の一部です。ユーザー [sys_user] テーブルからフェッチされた値が [ユーザー要求] の値と一致するように、 [ユーザーフィールド] を設定する必要があります。
      注:
      設定したフィールドのいずれも [ユーザー要求] の値と一致しない場合は、カスタムフィールドを作成して必要な値を入力できます。
    11. 表示される詳細を確認して [マニフェストをダウンロード] を選択します。

      マニフェストファイル
      マニフェストファイルが zip 形式でダウンロードされ、アプリケーションレジストリが作成されます。

    次のタスク

    Microsoft Teams でのマニフェストファイルをアップロードする必要があります。詳細については、「Microsoft Teams でのマニフェストファイルのアップロード」を参照してください。