事前公開済みアプリ用のマニフェストファイルの作成およびダウンロード

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

    • 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」を参照してください。

    1 つの事前公開済みアプリセットアップのみを Microsoft Teams テナントに接続できます。

    注:
    自己設定アプリ環境ごとに個別の Azure アプリを作成できるため、複数の自己設定アプリ環境を Microsoft Teams テナントに接続できます。自己設定アプリのマニフェストファイルを作成する方法の詳細については、「自己設定アプリ用のマニフェストファイルの作成およびダウンロード」を参照してください。

    手順

    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)] を選択します。これは、自己設定アプリに適用されます。詳細については、「自己設定アプリ用のマニフェストファイルの作成およびダウンロード」を参照してください。

      [仮想エージェントの構成 (Configure Virtual Agent)] タブ
    7. インスタンスで仮想エージェントを構成します。
      詳細については、「Microsoft Teams との対話型統合」を参照してください。
    8. [タブを構成 (Configur Tab)] セクションで、フィールドに入力します。
      表 : 2. [タブを構成 (Configur Tab)] フォーム
      フィールド 説明
      [タブの有効化 (Enable tabs)] Microsoft Teams アプリケーションにタブを追加するオプション。このオプションがデフォルトで選択されています。
      タブ名 Microsoft Teams アプリケーションに表示されるサービスポータルタブの名前。
      アクティビティフィードを有効化 Microsoft Teams でキャンペーン通知を受信するためにアクティビティフィードを有効にするオプション。このオプションがデフォルトで選択されています。

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


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

      マニフェストファイル
      マニフェストファイルは zip 形式でダウンロードされます。

    次のタスク

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