Asana Microsoft 365 Copilot コネクタは、Asana タスクを Microsoft 365 に統合し、Copilot、Copilot Search、Microsoft Search を使用して、Microsoft Teams、Outlook、SharePoint などのアプリ内で関連するタスク情報を直接表示できるようにします。 この記事では、Asana コネクタをデプロイしてカスタマイズする手順について説明します。
前提条件
コネクタをデプロイする前に、次の前提条件を満たしていることを確認してください。
- Microsoft 365 管理者である必要があります。
- 接続する Asana ワークスペースにアクセスできる必要があります。
- API アクセスを許可するように Asana 環境を構成する必要があります。
- Asana ユーザーのメールがユーザー プリンシパル名 (UPN) と異なる場合は、ID マッピングMicrosoft Entra ID構成する必要があります。
コネクタをデプロイする
organizationの Asana コネクタを追加するには:
- Microsoft 365 管理センターの左側のウィンドウで、[Copilot>Connectors] を選択します。
- [ ギャラリー ] タブを選択します。
- 使用可能なコネクタの一覧から [ Asana] を選択します。
表示名を設定する
表示名は、関連付けられたファイルまたはアイテムをユーザーが認識するのに役立つ Copilot 応答の参照を識別するために使用されます。 表示名は信頼されたコンテンツも示し、コンテンツ ソース フィルターとして使用されます。
既定の Asana 表示名をそのまま使用することも、値をカスタマイズして、organizationのユーザーが認識する表示名を使用することもできます。
コネクタの表示名と説明の詳細については、「 コネクタ コンテンツの Copilot 検出を強化する」を参照してください。
インスタンス URL の設定
接続する Asana ワークスペースの URL を入力します。 一般的な構造は次のとおりです。
https://app.asana.com/
認証の種類を選択する
Asana コネクタでは、次の認証の種類がサポートされています。
- OAuth 2.0 (推奨): Asana の OAuth フローを使用したセキュリティで保護されたスケーラブルな認証。
認証に Asana OAuth を使用するには、Asana 管理者が Asana 開発者コンソールでアプリを作成する必要があります。
OAuth クライアント作成フォームを完了するには、次の表の情報を使用します。
| フィールド | 説明 | おすすめの値 |
|---|---|---|
| アプリ名 | OAuth アクセスが必要なアプリケーションを識別する一意の値。 | Microsoft Search |
| アプリが何を行うかを最も適切に説明するものはどれですか? | アプリの目的について説明します。 | Asana からデータを取得してレポートを作成します。 |
| リダイレクト URL | 承認サーバーがリダイレクトする必要なコールバック URL。 |
Microsoft 365 Enterpriseの場合: https://gcs.office.com/v1.0/admin/oauth/callbackFor Microsoft 365 Government: https://gcsgcc.office.com/v1.0/admin/oauth/callback |
| アクセス許可のスコープ | スコープは、アプリがアクセスできる内容と、アプリが実行できる要求の種類を定義します。 | [ Full permissions] を選択します。 |
| 配布の管理 | 配布するワークスペースを選択します。 | コネクタがアクセスできる特定のワークスペースを追加するか、[ 任意のワークスペース] を選択します。 |
Asana アプリの [OAuth] タブからクライアント ID とクライアント シークレットをコピーし、[ クライアント ID ] フィールドと [ クライアント シークレット ] フィールドに貼り付けます。 [ 承認] を選択し、同じ Asana 管理者アカウントの資格情報を使用してクロールのアクセス許可を認証します。
注:
ポップアップ ウィンドウで Asana アプリへのアクセスを承認する必要があります。 ポップアップ ウィンドウがブロックされている場合は、ブラウザーでポップアップ ウィンドウが許可されているか、アクセス権が付与されていることを確認します。
ロールアウト
制限付き対象ユーザーにロールアウトするには、[制限対象ユーザー へのロールアウト] の横にあるトグルを選択し、コネクタをロールアウトするユーザーとグループを指定します。
[ 作成] を 選択して接続をデプロイします。 Asana Copilot コネクタは、コンテンツのインデックス作成をすぐに開始します。
次の表に、設定される既定値を示します。
| カテゴリ | Setting | 既定値 |
|---|---|---|
| ユーザー | アクセス許可 | データ ソース内のコンテンツにアクセスできるユーザーのみ。 |
| ユーザー | ID のマッピング | Microsoft Entra ID を使用してマップされたデータ ソース ID。 |
| コンテンツ | プロパティの管理 | 既定のプロパティとそのスキーマの詳細については、「 コンテンツ設定のカスタマイズ」を参照してください。 |
| 同期 | 増分クロール | 15 分ごとに実行されます。 |
| 同期 | フル クロール | 毎日実行されます。 |
これらの値をカスタマイズするには、[ カスタム セットアップ] を選択します。 詳細については、「設定の カスタマイズ」を参照してください。
接続を作成したら、Microsoft 365 管理センターの [コネクタ] セクションで状態を確認できます。
設定のカスタマイズ (省略可能)
Asana コネクタ設定の既定値をカスタマイズできます。 設定をカスタマイズするには、管理センターのコネクタ ページで [ カスタム セットアップ] を選択します。
ユーザー設定をカスタマイズする
アクセス許可
Asana コネクタでは、次のユーザー アクセス許可がサポートされています。
- すべてのユーザー
- このデータ ソースへのアクセス権を持つユーザーのみ (既定)
[ すべてのユーザー] を選択すると、すべてのユーザーの検索結果にインデックス付きデータが表示されます。 [このデータ ソースへのアクセス権を持つユーザーのみ] を選択すると、インデックス付きデータが検索結果に表示され、アクセス権を持つユーザーが表示されます。
Atlassian Asana では、セキュリティアクセス許可は、サイトレベルのグループとプロジェクトロールを含むプロジェクト権限スキームを介して定義されます。 タスク レベルのセキュリティは、タスク レベルのアクセス許可スキームを使用して定義することもできます。
ID のマッピング
データ ソース ID を Microsoft Entra ID にマップする既定の方法は、Asana ユーザーのメール ID が、Microsoft Entra IDのユーザーのユーザー プリンシパル名 (UPN) と同じであることを確認することです。 既定のマッピングがorganizationに対して機能しない場合は、カスタム マッピング式を指定できます。 詳細については、「Azure以外の AD ID をマップする」を参照してください。
organizationに最適なオプションを特定するには:
- Asana ユーザーのメール ID が Microsoft Entra ID の UPN と同じである場合は、Microsoft Entra ID オプションを選択します。
- Asana ユーザーのメール ID が、Microsoft Entra IDのユーザーの UPN やメールと異なる場合は、[Microsoft Entra ID以外] オプションを選択します。
コンテンツ設定をカスタマイズする
Asana で使用可能なプロパティを追加または削除するには、スキーマをプロパティに割り当てます (プロパティが検索可能、クエリ可能、取得可能、またはリファイン可能かどうかを定義する)、セマンティック ラベルを変更し、プロパティにエイリアスを追加します。
次の表は、既定でインデックスが作成されるプロパティの一覧です。
| 既定のプロパティ | Label | 説明 |
|---|---|---|
| Assignee | assignedToPeople |
このタスクを完了する必要があるユーザー |
| 完了 | State |
タスクが完了したかどうかを示します |
| CompletedAt | ClosedDate |
タスクが完了した日付と時刻 |
| CompletedBy | closedBy |
タスクを完了したユーザー |
| CreatedAt | createdDateTime |
タスクが作成された日付と時刻 |
| CreateBy | createdBy |
このタスクを作成したユーザー |
| DueOn | DueDate |
このタスクを完了する必要がある場合 |
| Gid | SecondaryId |
このタスクのグローバル ID |
| ModifiedAt | lastModifiedDateTime |
タスクが変更された日付と時刻 |
| 名前 | Title |
タスク名 |
| 備考 | NA |
タスクの説明 (コンテンツ) |
| ProjectIds | NA |
プロジェクト ID |
| ProjectNames | NA |
プロジェクト名 |
| タグ | Tags |
このタスクに割り当てられたタグ |
| TaskUrl | url |
タスクのリンク |
| WorkspaceName | containerName |
ワークスペース名 |
| 優先度 | Priority |
タスクの優先順位 |
| 重要度 | Severity |
タスクの重大度レベル |
| セクション | NA |
このタスクが属するセクション |
| SectionIds | NA |
このタスクが属するセクション ID |
| いいね! | NumReactions |
このタスクのいいねの数 |
同期間隔をカスタマイズする
フル クロールと増分クロールの頻度を構成できます。
- フル クロール: データの完全な更新を確実に行うために、24 時間ごとに推奨されます。
- 増分クロール: 最近の変更をキャプチャするために 15 分ごとに推奨されます。
詳細については、「 同期設定のガイドライン」を参照してください。