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]>[コネクター] を選択します。
- [コネクター] タブに移動し、左側のウィンドウで [ギャラリー] を選択します。
- 使用可能なコネクタの一覧から[ 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 コネクタが既定でインデックスを作成するプロパティの一覧です。
| プロパティ | Veeva フィールド | セマンティック ラベル | 説明 | スキーマ属性 |
|---|---|---|---|---|
| ID | document_number + ドキュメント バージョン | ドキュメント レコードの一意識別子 | クエリ、取得 | |
| FileName | filename__v | fileName | アップロードされたソース ファイルの名前 | クエリ、取得、検索 |
| タイトル | title__v | title | ドキュメント タイトル | 取得、検索 |
| 説明 | description__v | ドキュメントの自由テキストの説明 | 取得、検索 | |
| 拡張子 | filename__vのファイル拡張子 | FileExtension | PDF、DOCX、XLSX などのファイルの種類の拡張子 | クエリ、取得、検索 |
| Url | https://{vaultDns}/ui/#doc_info/{id}/{major_version_number__v}/{minor_version_number__v} | url | Veeva Vault でドキュメントにアクセスまたはプレビューするための直接 URL | クエリ、取得 |
| 状態 | status__v | state | ドキュメントの現在のライフサイクル状態 (下書き、承認済み、有効など) | クエリ、取得 |
| DocumentId | id | Veeva システムの一意のドキュメント識別子 (主キー) | クエリ、取得 | |
| GlobalId | global_id__sys | Vault 間でシステムによって生成されたグローバル一意識別子 | クエリ、取得 | |
| DocumentNumber | document_number__v | Veeva システムのシステム割り当てドキュメント番号 | クエリ、取得 | |
| バージョン | {major_version_number__v}_{minor_version_number__v} | ドキュメントの組み合わせバージョン文字列 | クエリ、取得 | |
| UrlRoutingId | concat(id, '/', major_version_number__v, '/', minor_version_number__v) | URL 解決に使用される複合ルーティング識別子 | クエリ、取得 | |
| MajorVersion | major_version_number__v | ドキュメントのメジャー バージョン番号 | クエリ、取得 | |
| MinorVersion | minor_version_number__v | ドキュメントのマイナー バージョン番号 | クエリ、取得 | |
| 型 | type__v | containerName | 最上位のドキュメントタイプ分類 | クエリ、取得 |
| Subtype | subtype__v | タイプの下の第 2 レベルのドキュメント分類 | クエリ、取得 | |
| Product | product__v.name__v | ドキュメントに関連する、またはドキュメントの対象となる製品 | クエリ、取得 | |
| タグ | tags__v | tags | ドキュメントに関連付けられているタグまたはキーワード | クエリ、取得、絞り込み |
| 国 | country__v.name__v | ドキュメントに関連付けられている国または地域 | クエリ、取得 | |
| フォーマット | format__v | ドキュメントの形式または型の情報 | クエリ、取得 | |
| ItemType | format__v | Itemtype | ドキュメント形式から派生したアイテムの種類 | クエリ、取得、絞り込み |
| ItemPath | {type__v}/{subtype__v} | itemPath | ドキュメントの種類とサブタイプを組み合わせた階層パス | クエリ、取得 |
| Owner | source_owner__v | Veeva システムのドキュメント所有者 | クエリ、取得、検索、絞り込み | |
| DocumentCreationDate | document_creation_date__v | createdDateTime | ドキュメントが最初に作成された日付と時刻 | クエリ、取得 |
| VersionModifiedDate | version_modified_date__v | lastModifiedDateTime | このバージョンが最後に変更された日時 | クエリ、取得 |
| CreatedBy | created_by__v (名前、電子メール) | createdBy | ドキュメントを最初に作成したユーザー | クエリ、取得、検索 |
| CreatedByUserId | created_by__v | ドキュメント作成者の内部ユーザー識別子 | クエリ、取得 | |
| LastModifiedByUserId | last_modified_by__v | 最後の修飾子の内部ユーザー識別子 | クエリ、取得 | |
| LastModifiedBy | last_modified_by__v (名前、電子メール) | lastModifiedBy | ドキュメントを最後に変更したユーザー | クエリ、取得、検索 |
| ライフサイクル | lifecycle__v | ドキュメントに割り当てられたライフサイクル | クエリ、取得 | |
| OwningDepartment | owning_department__v.name__v | ドキュメントの所有を担当する部署 | クエリ、取得 | |
| OwningFacility | owning_facility__c.name__v | ドキュメント所有権に関連付けられている機能 | クエリ、取得 | |
| ReferenceModelCategory | reference_model_category__c.name__v | ドキュメントの上位レベルの参照モデル カテゴリ | クエリ、取得 | |
| ReferenceModelSubcategory | reference_model_subcategory__c.name__v | 参照モデル分類内のサブカテゴリ | クエリ、取得 | |
| PeriodicReviewFrequency | periodic_review_frequency1__c | ドキュメントが定期的にレビューされる頻度 | クエリ、取得 | |
| DaysBeforeToStartPeriodicReview | days_before_to_start_periodic_review__c | ドキュメントの定期的なレビューが開始されるまでの日数 | クエリ、取得 | |
| ObsolescenceApproved | obsolescence_approved__c | 陳腐化が承認されているかどうかを示します | クエリ、取得 | |
| 範囲 | scope__c | ドキュメントのスコープまたは適用可能性 | クエリ、取得 | |
| ImplementationPeriodDays | implementation_period_days__c | ドキュメントの実装に指定された日数 | クエリ、取得 | |
| RequiresDcc | requires_dcc__c | ドキュメント変更コントロールが必要かどうかを示します | クエリ、取得 | |
| ImportedDocument | imported_document__c | ドキュメントがインポートされたかどうかを示します | クエリ、取得 | |
| Size | size__v | ドキュメントのファイル サイズ | ||
| コンテンツ | ドキュメント コンテンツ | ドキュメントから抽出されたメイン テキストまたは本文コンテンツ | 検索 |
カスタム プロパティを追加する
コネクタは、既定のプロパティに加えて、Veeva QualityDocs インスタンスからカスタムプロパティやその他のドキュメント プロパティを自動的に検出します。 セットアップ中に、コネクタはクエリ可能で無効ではなく、非表示ではない使用可能なすべてのドキュメント フィールドを取得し、[ プロパティの管理] の下に追加のプロパティとして表示します。
これらのカスタム プロパティを 1 つずつ選択してコネクタ スキーマに追加できます。 追加された各カスタム プロパティには、次の既定のスキーマ属性があります。
- クエリ と 取得 は既定で有効になっています。
- 検索 と 絞り込み は既定では有効になっていませんが、[ プロパティの管理] で有効にすることができます。
Veeva Vault オブジェクト (ObjectReference 型) を参照するプロパティの場合、コネクタは参照先オブジェクトのメタデータもフェッチし、そのフィールドを入れ子になったプロパティとして公開します。 たとえば、カスタム プロパティが campaign__v 型の VObject を参照している場合、コネクタは campaign__v.name__v、 campaign__v.status__vなどのプロパティを生成します。
カスタム プロパティを追加した後、[プロパティの 管理] で、任意のプロパティ (既定とカスタムの両方) のスキーマ属性をカスタマイズできます。 organizationの要件に基づいて、各プロパティに対してクエリ、取得、検索、および絞り込みを有効または無効にすることができます。
同期間隔をカスタマイズする
organizationの要件に合わせてフル クロールの頻度を変更できます。 既定値は毎日フル クロールです。 詳細については、「同期設定のガイドライン」を参照してください。