Veeva QualityDocs Microsoft 365 Copilot コネクタを使用すると、組織は、Standard運用手順 (SOP)、作業指示、ポリシー、CAPA、バッチ レコードなどの管理された品質ドキュメントを Veeva Vault QualityDocs から Microsoft Graph にインデックスを作成できます。 この統合により、Microsoft 365 Copilotや Microsoft Search など、Microsoft 365 エクスペリエンス全体でアクセスできるようになります。 コネクタは Vault QualityDocs の詳細なアクセス許可モデルを尊重し、承認されたユーザーのみが関連するドキュメントを表示または操作できるようにします。 Microsoft の AI 機能を QualityDocs の単一の信頼できるソース、品質、規制、製造、およびサプライ チェーン チームと組み合わせることにより、コンプライアンスを維持しながら、より効率的に共同作業を行うことができます。
この記事では、Veeva QualityDocs コネクタをデプロイしてカスタマイズする手順について説明します。 Copilot コネクタのデプロイに関する一般的な情報については、Microsoft 365 管理センターでの Copilot コネクタのセットアップに関するページを参照してください。
前提条件
コネクタをデプロイする前に、次の前提条件を満たしていることを確認してください。
- Microsoft 365 管理者である必要があります。
- organizationには、Veeva Vault QualityDocs 環境が構成されている必要があります。
- OAuth 2.0/OpenID Connect 認証用にMicrosoft Entra IDを設定する必要があります。
- Microsoft Entra アプリケーションのクライアント ID とクライアント シークレットが必要です。
- Veeva Vault QualityDocs インスタンス URL が必要です。
- Veeva Vault QualityDocs と Microsoft Entra ID間のユーザー ID マッピングを構成する必要があります。
アプリケーションを登録して OAuth を構成する
次の手順を使用して、Veeva QualityDocs コネクタMicrosoft Entra ID OAuth 2.0/OpenID Connect を構成します。
アプリケーションをMicrosoft Entra IDに登録します。
- [Microsoft Entra 管理センター>アプリの登録>新しい登録] に移動します。
- アプリケーションに名前を付け、[ この組織のディレクトリ内のアカウントのみ] を選択します。
- リダイレクト URI を追加します。
- Microsoft 365 Enterpriseの場合:
https://gcs.office.com/v1.0/admin/oauth/callback - Microsoft 365 Government の場合:
https://gcsgcc.office.com/v1.0/admin/oauth/callback
- Microsoft 365 Enterpriseの場合:
- [証明書] & [シークレット] でクライアント シークレットを生成し、安全に保存します。
Veeva QualityDocs で OAuth を構成します。
- OAuth 2.0/OpenID Connect プロファイル>管理 >設定に移動します。
- 新しいプロファイルを作成し、[状態] を [アクティブ] に設定し、プロバイダーとして [Azure AD] を選択します。
- [ UPLOAD AS metadata>Provide Authorization Server Metadata URL] を選択し、次のリンクを貼り付けます。 {tenant-id} をテナント ID に置き換えます。
https://login.microsoftonline.com/{tenant-id}/v2.0/.well-known/openid-configuration -
[ID は別の要求に
upn] に設定し、[ユーザー ID の種類] で [フェデレーション ID] を選択します。 UPN はフェデレーション ID と同じである必要があります。 - [クライアント アプリケーション>追加] を選択し、アプリケーション クライアント ID と承認サーバー クライアント ID の両方にMicrosoft Entra ID アプリケーションのクライアント ID を使用します。 アプリケーション ラベルを追加します。
注:
[厳密な対象ユーザー制限の検証を実行する] を有効にするには、[対象ユーザー] フィールドにクライアント ID を追加します。
セキュリティ ポリシーを作成し、ユーザーをリンクします。
- [管理 >設定] > [セキュリティ ポリシー>作成>Single のサインオン] に移動します。 名前と説明を指定し、状態を アクティブに設定します。
- 認証の種類として、[ シングル サインオン] を選択し、プロファイルを選択します。 詳細については、「 シングル サインオンの構成」を参照してください。
- eSignature プロファイルで [なし] を選択し、[OAuth 2.0/ OpenID Connect Profile] で、作成した OAuth 2.0 プロファイルを選択します。 その他の設定は既定値のままにします。
- [管理>ユーザー & グループ] に移動し、コンテナーの所有者を選択して、[編集] を選択します。
- [ 詳細>セキュリティ ポリシー] で、値を新しいポリシーに変更し、[ フェデレーション ID] で値をコネクタ管理者アカウントの UPN に変更します。
コネクタをデプロイする
organizationの Veeva QualityDocs コネクタを追加するには:
- Microsoft 365 管理センターの左側のウィンドウで、[Copilot>Connectors] を選択します。
- [ コネクタ ] タブに移動し、左側のウィンドウで [ ギャラリー] を選択します。
- 使用可能なコネクタの一覧から[ Veeva QualityDocs]\(Veeva QualityDocs\) を選択します。
表示名を設定する
表示名は、関連付けられたファイルまたはアイテムをユーザーが認識するのに役立つ Copilot 応答の参照を識別するために使用されます。 表示名は信頼されたコンテンツも示し、コンテンツ ソース フィルターとして使用されます。
既定の Veeva QualityDocs の表示名をそのまま使用することも、organizationのユーザーが認識する表示名を使用するように値をカスタマイズすることもできます。
コネクタの表示名と説明の詳細については、「 コネクタ コンテンツの Copilot 検出を強化する」を参照してください。
インスタンス URL の設定
Veeva QualityDocs インスタンスの URL を入力します。 例: https://<your-vault-domain>.veevavault.com。
認証の種類を選択する
Veeva QualityDocs コネクタを認証するには、[認証の種類] で [Microsoft Entra ID OIDC] を選択し、次の情報を指定します。
- コンテナー セッション ID URL: Veeva QualityDocs で、管理 パネル>Settings>OAuth 2.0/OpenID Connect プロファイルに移動し、この接続用に作成したプロファイルを選択します。 コンテナー セッション ID URL をコピーします。
- クライアント ID: Veeva QualityDocs に登録した Entra アプリケーションのアプリケーション ID。
- クライアント シークレット: Entra アプリケーションに関連付けられているクライアント シークレット。
[承認] を選択して Entra ID アカウントでサインインし、organizationに代わって [同意] を選択し、アクセス許可要求画面で [同意] を選択します。
重要
Microsoft Entra IDと Veeva QualityDocs の両方の管理者設定を構成して、Microsoft Entra ID認証を有効にします。
ロールアウト
制限付き対象ユーザーにロールアウトするには、[制限対象ユーザー へのロールアウト] の横にあるトグルを選択し、コネクタをロールアウトするユーザーとグループを指定します。 詳細については、「 Copilot コネクタの段階的ロールアウト」を参照してください。
[ 作成] を 選択して接続をデプロイします。 Veeva QualityDocs Copilot コネクタは、コンテンツのインデックス作成をすぐに開始します。
次の表に、設定される既定値を示します。
| カテゴリ | 既定値 |
|---|---|
| ユーザー | Veeva QualityDocs のアクセス許可を尊重します。表示可能なドキュメントにのみアクセスできます。 |
| コンテンツ | ドキュメント名、所有者、ライフサイクル ステージなどのキー メタデータにインデックスを付けます。 |
| 同期 | 毎日フル クロール。 |
これらの値をカスタマイズするには、[ カスタム セットアップ] を選択します。 詳細については、「設定の カスタマイズ」を参照してください。
接続を作成したら、Microsoft 365 管理センターの [コネクタ] セクションで状態を確認できます。
設定のカスタマイズ (省略可能)
Veeva QualityDocs コネクタ設定の既定値をカスタマイズできます。 設定をカスタマイズするには、管理センターのコネクタ ページで [ カスタム セットアップ] を選択します。
ユーザー設定をカスタマイズする
アクセス許可
コネクタは、Veeva QualityDocs で定義されているアクセス制御リスト (ACL) に準拠しています。 Microsoft 365 でインデックス付きコンテンツを表示できるのは、Veeva QualityDocs の表示アクセス許可を持つユーザーのみです。 管理者は必要に応じて、すべてのユーザーがすべてのインデックス付きコンテンツへのアクセスを許可できますが、この方法は規制されたリポジトリには推奨されません。
ID のマッピング
コネクタは、Veeva QualityDocs ユーザー ID (フェデレーション ID など) をユーザー アカウントMicrosoft Entra IDマッピングに依存しています。 Microsoft Entra UPN が QualityDocs で使用されるフェデレーション ID と一致していることを確認するか、セキュリティアクセス許可を正しく適用できるようにカスタム ID マッピングを構成します。
Veeva QualityDocs インスタンスのセキュリティ設定を適用する場合は、コンテンツ ソースの ID の種類として [ 非 ME-ID ] を選択します。
ID マッピングに必要な情報を入力します。 たとえば、メール アドレスに基づいて ID をマップする場合は、次のようにします。
- [Microsoft Entra ユーザー] プロパティで、[メール] を選択します。
- [Microsoft Entra以外のユーザー プロパティ] で、[ID プロパティの追加] を選択し、[Email] を選択します。
([^@]+)などの式を使用して、@記号ではない 1 つ以上の文字のシーケンスをキャプチャします。{0}@<your-domain>など、マッピングを完了する数式を作成します。
コンテンツ設定をカスタマイズする
クエリ文字列
クエリ文字列条件を使用して、関連するドキュメントのみを含め、よりターゲットを絞った効率的なインデックス作成を可能にすることができます。
プロパティの管理
次の表は、Veeva QualityDocs コネクタが既定でインデックスを作成するプロパティの一覧です。
| プロパティ | セマンティック ラベル | 説明 | スキーマ属性 |
|---|---|---|---|
| content | ドキュメントから抽出されたメイン テキストまたは本文コンテンツ | 検索 | |
| country | ドキュメントに関連付けられている国または地域 | クエリ、取得 | |
| createdBy | CreatedBy | ドキュメントを最初に作成したユーザー | クエリ、取得 |
| createdByUserId | ドキュメント作成者の内部ユーザー識別子 | クエリ、取得 | |
| daysBeforeToStartPeriodicReview | ドキュメントの定期的なレビューが開始されるまでの日数 | クエリ、取得 | |
| documentCreationDate | CreatedDateTime | ドキュメントが最初に作成された日付と時刻 | クエリ、取得 |
| documentId | Veeva システム内のドキュメントの一意識別子 | クエリ、取得 | |
| 延長 | FileExtension | PDF、DOCX、XLSX などのファイルの種類の拡張子 | クエリ、取得、検索 |
| fileName | タイトル | ドキュメントのファイル名またはタイトル | クエリ、取得、検索 |
| format | ドキュメントの形式または型の情報 | クエリ、取得 | |
| id | ドキュメント レコードの一意識別子 | クエリ、取得 | |
| implementationPeriodDays | ドキュメントの実装に指定された日数 | クエリ、取得 | |
| importedDocument | ドキュメントがインポートされたかどうかを示します | クエリ、取得 | |
| lastModifiedBy | LastModifiedBy | ドキュメントを最後に変更したユーザー | クエリ、取得 |
| lastModifiedByUserId | 最後の修飾子の内部ユーザー識別子 | クエリ、取得 | |
| ライフサイクル | ドキュメント ライフサイクルの状態 (下書き、承認済みなど) | クエリ、取得 | |
| majorVersion | ドキュメントのメジャー バージョン番号 | クエリ、取得 | |
| minorVersion | ドキュメントのマイナー バージョン番号 | クエリ、取得 | |
| obsolescenceApproved | 陳腐化が承認されているかどうかを示します | クエリ、取得 | |
| owningDepartment | ドキュメントの所有を担当する部署 | クエリ、取得 | |
| owningFacility | ドキュメント所有権に関連付けられている機能 | クエリ、取得 | |
| periodicReviewFrequency | ドキュメントが定期的にレビューされる頻度 | クエリ、取得 | |
| 積 | ドキュメントに関連する、またはドキュメントの対象となる製品 | クエリ、取得 | |
| referenceModelCategory | ドキュメントの上位レベルの参照モデル カテゴリ | クエリ、取得 | |
| referenceModelSubcategory | 参照モデル分類内のサブカテゴリ | クエリ、取得 | |
| requiresDcc | ドキュメント変更コントロールが必要かどうかを示します | クエリ、取得 | |
| scope | ドキュメントのスコープまたは適用可能性 | クエリ、取得 | |
| size | ドキュメントのファイル サイズ | ||
| status | ドキュメントの状態 (アクティブ、アーカイブなど) | クエリ、取得 | |
| サブタイプ | ドキュメントの特定のサブタイプまたは分類 | クエリ、取得 | |
| type | ドキュメントの種類またはメイン カテゴリ | クエリ、取得 | |
| url | url | ドキュメントにアクセスまたはプレビューするための直接 URL | クエリ、取得 |
| versionModifiedDate | LastModifiedDateTime | このバージョンが最後に変更された日時 | クエリ、取得 |
同期間隔をカスタマイズする
organizationの要件に合わせてフル クロールの頻度を変更できます。 既定値は毎日フル クロールです。 詳細については、「 同期設定のガイドライン」を参照してください。