トレーニング
モジュール
Introduction to Graph connectors - Training
Understand how Graph connectors can be used to extend Microsoft 365.
認定資格
Dynamics 365 Marketing における Customer Insights やその他のマーケティング機能に関する知識を示します。
このブラウザーはサポートされなくなりました。
Microsoft Edge にアップグレードすると、最新の機能、セキュリティ更新プログラム、およびテクニカル サポートを利用できます。
Atlassian Jira Cloud Microsoft Graph コネクタを使用すると、organizationで Jira の問題のインデックスを作成できます。 Jira サイトからコネクタとインデックス コンテンツを構成した後、エンド ユーザーは Microsoft Search と Microsoft 365 Copilotでそれらのアイテムを検索できます。
この記事は、Microsoft 365 管理者、または Jira クラウド Graph コネクタを構成、実行、監視するユーザーを対象とします。
重要
Atlassian Jira Cloud Microsoft Graph コネクタでは、Jira クラウドでホストされるインスタンスのみがサポートされています。 このコネクタでは、Jira Server と Jira Data Center のバージョンはサポートされていません。
organizationの Microsoft 365 テナントの検索管理者である必要があります。
Jira クラウド インスタンス URL: Jira データに接続するには、organizationの Jira インスタンス URL が必要です。 通常、organizationの Jira インスタンス URL はhttps://<your-organization-domain>.atlassian.net
のようになります。 インスタンスがまだない場合は、 ページ を参照してテスト インスタンスを作成します。
サービス アカウント: Jira に接続し、Microsoft Graph Connector で問題を定期的に更新できるようにするには、次のアクセス許可が付与されたサービス アカウントが必要です。
アクセス許可名 | アクセス許可の種類 | に必要です |
---|---|---|
プロジェクトを参照する | プロジェクトのアクセス許可 | クロールの Jira の問題。 このアクセス許可は、インデックスを作成する必要があるプロジェクトに 必須 です。 |
問題レベルのセキュリティアクセス許可 | 問題レベルのセキュリティ | さまざまな問題の種類をクロールする。 このアクセス許可は 省略可能です。 |
ユーザーとグループを参照する | グローバル アクセス許可 | 検索結果のアクセス許可に基づくセキュリティ トリミング。 このアクセス許可は 省略可能 であり、以下の手順 4 でオプション Only people with access to this data source 選択する必要があります。 |
Jira を管理する | グローバル アクセス許可 | 検索結果のアクセス許可に基づくセキュリティ トリミング。 このアクセス許可は 省略可能 であり、以下の手順 4 でオプション Only people with access to this data source 選択する必要があります。 |
表示名は、Copilot の各引用文献を識別するために使用され、ユーザーが関連付けられているファイルまたは項目を簡単に認識するのに役立ちます。 表示名は、信頼されたコンテンツも示します。 表示名は、 コンテンツ ソース フィルターとしても使用されます。 このフィールドには既定値が存在しますが、organizationのユーザーが認識する名前にカスタマイズできます。
Jira クラウド データに接続するには、organizationの Jira インスタンス URL が必要です。 通常、organizationの Jira インスタンス URL はhttps://<your-organization-domain>.atlassian.net
のようになります。
Jira から問題を認証して同期するには、サポートされている 2 つの方法のいずれかを 選択します。
a. [ 基本認証]
基本的な認証を使用して認証するアカウントのユーザー名 (通常はメール ID) と API トークンを入力します。API トークンの生成の詳細については、 Atlassian アカウントの API トークンを管理 する方法に関する Atlassian のドキュメントを参照してください。
b.
Atlassian Jira OAuth 2.0 (推奨)
認証に Jira OAuth を使用するには、次の手順に従います。
Atlassian Jira にアプリを登録して、Microsoft Search アプリとMicrosoft 365 Copilotがインスタンスにアクセスできるようにします。 詳細については、 OAuth 2.0 を有効にする方法に関する Atlassian サポート ドキュメントを参照してください。
次の手順では、アプリを登録する方法に関するガイダンスを提供します。
Atlassian Jira 管理者アカウントで Atlassian Developer コンソール にサインインします。
[ Create
] を選択し、[ OAuth 2.0 integration
] を選択します。
アプリケーションに適切な名前を指定し、新しいアプリを作成します。
左側のナビゲーション ウィンドウから Permissions
に移動します。
Jira API
のAdd
を選択し、[Configure
] をクリックします。 [詳細なアクセス許可] ヘッダーの下に、次のスコープを追加します。
# | スコープ名 | コード |
---|---|---|
1 | フィールドの表示 | read:field:jira |
2 | アバターを表示する | read:avatar:jira |
3 | プロジェクト カテゴリを表示する | read:project-category:jira |
4 | プロジェクトを表示する | read:project:jira |
5 | フィールド構成の読み取り | read:field-configuration:jira |
6 | 問題の種類を表示する | read:issue-type:jira |
7 | プロジェクトのプロパティを表示する | read:project.property:jira |
8 | ユーザーの表示 | read:user:jira |
9 | アプリケーション ロールを表示する | read:application-role:jira |
10 | グループの表示 | read:group:jira |
11 | 問題の種類の階層を読み取る | read:issue-type-hierarchy:jira |
12 | プロジェクトのバージョンを表示する | read:project-version:jira |
13 | プロジェクト コンポーネントを表示する | read:project.component:jira |
14 | 問題の詳細を表示する | read:issue-details:jira |
15 | 監査ログを表示する | read:audit-log:jira |
16 | 問題のメタを表示する | read:issue-meta:jira |
17 | プロジェクト ロールを表示する | read:project-role:jira |
18 | 問題のセキュリティ レベルを表示する | read:issue-security-level:jira |
19 | 問題のセキュリティ スキームを表示する | read:issue-security-scheme:jira |
20 | アクセス許可スキームを表示する | read:permission-scheme:jira |
21 | アクセス許可の表示 | read:permission:jira |
左側のナビゲーション ウィンドウから Authorization
に移動します。
M365 Enterprise: https://gcs.office.com/v1.0/admin/oauth/callback
、M365 Government: https://gcsgcc.office.com/v1.0/admin/oauth/callback
のコールバック URL を追加し、変更を保存します。
左側のナビゲーション ウィンドウから Settings
に移動して、このページから Client ID
と Secret
を取得します。
[クライアント ID] と [シークレット] を使用して、接続設定の手順を完了します。
注意
ロールアウトを広範な対象ユーザーに展開する前に、Copilot やその他の Search サーフェスで検証する場合は、制限付きユーザー ベースにこの接続をデプロイします。 制限付きロールアウトの詳細については、「 段階的なロールアウト」を参照してください。
この時点で、Jira クラウドの接続を作成する準備ができました。 [ 作成 ] をクリックして、接続とインデックスの問題を Jira アカウントから発行できます。
アクセス許可、データ包含ルール、スキーマ、クロール頻度などの他の設定については、Jira データで最適に動作するものに基づいて既定値が設定されています。 既定値は次のとおりです。
ユーザー | 説明 |
---|---|
アクセス許可 | データ ソース内のコンテンツにアクセスできるユーザーのみ。 |
ID のマップ | Microsoft Entra ID を使用してマップされたデータ ソース ID。 |
コンテンツ | 説明 |
---|---|
サイト プロジェクト | すべてのプロジェクトにインデックスが作成されます。 |
データをフィルター処理する | すべての問題にインデックスが作成されます。 時間フィルターまたは JQL 条件は適用されません。 |
プロパティの管理 | 既定のプロパティとそのスキーマをチェックするには、コンテンツに関するページを参照してください |
同期 | 説明 |
---|---|
増分クロール | 頻度: 15 分ごと |
フル クロール | 頻度: 毎日 |
これらの値のいずれかを編集する場合は、"カスタム セットアップ" オプションを選択する必要があります。
カスタム セットアップは、上記の表に示した設定の既定値を編集する管理者向けです。 [カスタム セットアップ] オプションをクリックすると、[ユーザー]、[コンテンツ]、[同期] の 3 つのタブが表示されます。
アクセス許可
Atlassian Jira コネクタでは、このデータ ソースへのアクセス権を持つすべてのユーザーまたは唯一のユーザーに表示される検索アクセス許可がサポートされています。 [ すべてのユーザー] を選択すると、すべてのユーザーの検索結果にインデックス付きデータが表示されます。 [このデータ ソースへのアクセス権を持つユーザーのみ] を選択すると、インデックス付きデータが検索結果に表示され、アクセス権を持つユーザーが表示されます。 Atlassian Jira では、サイト レベルのグループとプロジェクト ロールを含むプロジェクト権限スキームを使用してセキュリティアクセス許可が定義されます。 問題レベルのセキュリティは、問題レベルのアクセス許可スキームを使用して定義することもできます。
重要
Jira クラウド Microsoft Graph コネクタは、Jira でユーザーの電子メール ID を読み取り、Microsoft Search とMicrosoft 365 Copilotでセキュリティアクセス許可を適切に割り当てることができる必要があります。 これには、次のいずれかを確認する必要があります。
- マネージド アカウントの一部であるすべてのユーザーは、プロファイルの可視性設定でマネージド アカウント設定を選択する必要があります。
- マネージド アカウント (クロール アカウントと同じ) に属していないユーザーは、プロファイルの可視性設定で [すべてのユーザー] を選択する必要があります。
- 接続構成中に使用されるクロール アカウントには、マネージド アカウント ドメインが必要です。
マッピング ID
データ ソース ID を Microsoft Entra ID とマッピングするための既定の方法は、Jira ユーザーのEmail ID が、Microsoft Entraのユーザーの UserPrincipalName (UPN) または Mail と同じかどうかを確認することです。 既定のマッピングがorganizationに対して機能しないと思われる場合は、カスタム マッピング式を指定できます。 非Microsoft Entra ID ID のマッピングの詳細については、「Azure AD 以外の ID をマップする」を参照してください。
organizationに適したオプションを特定するには:
注意
アクセス許可を管理するグループへのUpdatesは、フル クロールでのみ同期されます。 増分クロールでは、アクセス許可に対する更新の処理はサポートされていません。
プロジェクトの選択とデータのフィルター処理
サイト プロジェクト
接続のインデックスを作成するには、Jira サイト全体または特定のプロジェクトのみを選択できます。
Jira サイト全体のインデックスを作成する場合、サイト内のすべてのプロジェクトの Jira の問題にインデックスが作成されます。 新しいプロジェクトと問題は、作成後の次のクロール中にインデックスが作成されます。
個々のプロジェクトを選択すると、選択したプロジェクトの Jira Issue のみがインデックス付けされます。
注意
プロジェクトの参照アクセス許可を Jira プロジェクト に付与すると、プロジェクトの選択に一覧表示され、クロールできます。 プロジェクトが見つからない場合は、アカウントのアクセス許可をチェックします。
データをフィルター処理する
さらに、インデックスが作成された Jira の問題を 2 つの方法でフィルター処理することもできます。
ヒント
JQL フィルターを使用して、"issueType in (バグ,改善)" を使用して、特定の Jira イシューの種類にのみインデックスを作成できます
プロパティの管理
ここでは、使用可能なプロパティを Jira データ ソースに追加または削除し、プロパティにスキーマを割り当てます (プロパティが検索可能、クエリ可能、取得可能、または絞り込み可能かどうかを定義する)、セマンティック ラベルを変更し、プロパティにエイリアスを追加できます。 既定で選択されているプロパティを次に示します。
Source プロパティ | Label | 説明 | Schema |
---|---|---|---|
ブロック | ブロック | データ ソース内のアイテムに参加/共同作業を行ったすべてのユーザーに名前を付けます | 取り戻す |
作成済み | 作成日時 | データ ソースでアイテムが作成されたデータと時刻 | クエリ、取得 |
IssueDescription | コンテンツ | 問題の説明 | 検索 |
IssueIconURL | IconUrl | 問題の種類を表すアイコン URL。 | 取り戻す |
IssueId | |||
IssueKey | |||
IssueLink | url | データソース内のアイテムのターゲット URL | クエリ、取得 |
IssueStatus | クエリ | ||
IssueSummary | |||
ProjectName | クエリ | ||
ReporterEmailId | 作成者 | 取り戻す | |
ReporterName | クエリ、取得 | ||
タイトル | タイトル | Copilot やその他の検索エクスペリエンスに表示するアイテムのタイトル | 検索、クエリ、取得 |
更新あり | 最終更新日時 | データ ソースでアイテムが最後に変更された日時。 | クエリ、取得 |
注意
ここで選択するプロパティの一覧は、Copilot for Microsoft 365 で結果をフィルター処理、検索、表示する方法に影響する可能性があります。
データのプレビュー
プレビュー結果ボタンを使用して、選択したプロパティとクエリ フィルターのサンプル値を確認します。
更新間隔によって、データ ソースと Graph コネクタ インデックスの間でデータが同期される頻度が決まります。 更新間隔には、フル クロールと増分クロールの 2 種類があります。 詳細については、「 更新設定」を参照してください。
必要に応じて、ここから更新間隔の既定値を変更できます。
接続を作成したら、垂直方向と結果の種類を使用して検索結果ページをカスタマイズする必要があります。 検索結果のカスタマイズについては、垂直方向と結果の種類を管理する方法に関するページを参照してください。 また、Jira コネクタの サンプル結果レイアウト を使用することもできます。 サンプル レイアウトに必要なスキーマを使用して接続のスキーマを確認した後で開始するには、結果レイアウト JSON をコピーして貼り付けます。
接続を公開したら、管理センターの [データ ソース] タブの状態を確認できます。 更新と削除を行う方法については、「接続を監視する」をご覧ください。 一般的に見られる問題のトラブルシューティング手順については、「 Atlassian Jira Cloud Microsoft Graph コネクタのトラブルシューティング ガイド」を参照してください。
その他の問題がある場合、またはフィードバックを提供したい場合は、 Microsoft Graph サポートにお問い合わせください。
トレーニング
モジュール
Introduction to Graph connectors - Training
Understand how Graph connectors can be used to extend Microsoft 365.
認定資格
Dynamics 365 Marketing における Customer Insights やその他のマーケティング機能に関する知識を示します。