Veeva Vault RIM Microsoft 365 Copilot コネクタを使用すると、組織は Veeva Vault から Microsoft Graph への規制申請とコンプライアンス ドキュメントにインデックスを付け、Microsoft 365 Copilotや Microsoft Search を含む Microsoft 365 エクスペリエンス全体でアクセスできます。 コネクタは、Vault RIM の組み込みアクセス許可モデルを統合して、ユーザーが承認されたコンテンツにのみアクセスできるようにします。 インテリジェントなコンテンツ分析と準備を通じて、コンテンツの生成とレビューの速度を向上させます。 コネクタは、規制申請ライフサイクル全体を合理化することで、提出者がより効果的に提出状態を追跡し、応答時間を大幅に短縮するのに役立ちます。
この記事では、Veeva Vault RIM コネクタをデプロイしてカスタマイズする手順について説明します。 Copilot コネクタのデプロイに関する一般的な情報については、Microsoft 365 管理センターでの Copilot コネクタのセットアップに関するページを参照してください。
前提条件
コネクターをデプロイする前に、次の前提条件を満たしていることを確認してください:
- Microsoft 365 管理者である必要があります。
- Veeva Vault RIM インスタンスにアクセスし、適切に構成する必要があります。
- Microsoft Entra ID認証用に設定する必要があります。
- 必要なアクセス許可とロールは、Veeva Vault と Microsoft 365 で割り当てる必要があります。
アプリケーションを登録して OAuth を構成する
次の手順を使用して、Veeva RIM コネクタ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 RIM で 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 Vault RIM コネクタを追加するには:
- Microsoft 365 管理センターの左側のウィンドウで、[Copilot]>[コネクター] を選択します。
- [コネクター] タブに移動し、左側のウィンドウで [ギャラリー] を選択します。
- 使用可能なコネクタの一覧から[ Veeva Vault RIM]\(Veeva Vault RIM\) を選択します。
表示名の設定
表示名は、Copilot 応答内の参照を識別するために使用され、ユーザーが関連するファイルまたはアイテムを認識しやすくなります。 表示名は信頼されたコンテンツを示すとともに、コンテンツ ソースのフィルターとしても使用されます。
既定の Veeva Vault RIM 表示名をそのまま使用することも、organizationのユーザーが認識する表示名を使用するように値をカスタマイズすることもできます。
コネクターの表示名と説明の詳細については、「コネクター コンテンツの Copilot 検出を強化する」を参照してください。
インスタンス URL の設定
Veeva Vault RIM インスタンスの URL を入力します。 例:
https://<your-vault-domain>.veevavault.com
認証の種類を選択する
Veeva RIM コネクタを認証するには、[認証の種類] で [MICROSOFT ENTRA ID OIDC] を選択し、次の情報を指定します。
- コンテナー セッション ID URL: Veeva RIM で、管理 パネル>Settings>OAuth 2.0/OpenID Connect プロファイルに移動し、この接続用に作成したプロファイルを選択します。 コンテナー セッション ID URL をコピーします。
- クライアント ID: Veeva RIM に登録した Entra アプリケーションのアプリケーション ID。
- クライアント シークレット: Entra アプリケーションに関連付けられているクライアント シークレット。
[承認] を選択して Entra ID アカウントでサインインし、organizationに代わって [同意] を選択し、アクセス許可要求画面で [同意] を選択します。
重要
Microsoft Entra IDと Veeva RIM の両方の管理者設定を構成して、Microsoft Entra ID認証を有効にします。
ロールアウト
限定された対象ユーザーにロールアウトするには、[限定された対象ユーザーへのロールアウト] の横のトグルをオンにし、コネクターをロールアウトするユーザーとグループを指定します。 詳細については、「Copilot コネクターの段階的ロールアウト」を参照してください。
[作成] を選択して接続をデプロイします。 Veeva Vault RIM Copilot コネクタは、コンテンツのインデックス作成をすぐに開始します。
次の表に、設定される既定値を示します。
| カテゴリ | 既定値 |
|---|---|
| ユーザー | Veeva Vault のアクセス許可を尊重します。表示可能なドキュメントにのみアクセスできます。 |
| コンテンツ | ドキュメント名、所有者、ライフサイクル ステージなどのキー メタデータにインデックスを付けます。 タイトル、作成者、最終変更者などのメタデータを有効にします。 |
| 同期 | フル クロール -毎日。 |
これらの値をカスタマイズするには、[カスタム セットアップ] を選択します。 詳細については、「設定のカスタマイズ」を参照してください。
接続を作成したら、Microsoft 365 管理センターの [コネクター] セクションで状態を確認できます。
設定のカスタマイズ (オプション)
Veeva Vault RIM コネクタ設定の既定値をカスタマイズできます。 設定をカスタマイズするには、管理センターのコネクター ページで [カスタム セットアップ] を選択します。
ユーザー設定をカスタマイズする
アクセス許可
コネクタは、Veeva Vault で定義されているアクセス制御リスト (ACL) に準拠しています。 Microsoft 365 でインデックス付きコンテンツを表示できるのは、Veeva Vault の表示アクセス許可を持つユーザーのみです。 管理者は必要に応じて、すべてのユーザーにインデックス付きコンテンツへのアクセスを許可できますが、この方法はお勧めしません。
ID のマッピング
Veeva RIM インスタンスのセキュリティ設定を適用する場合は、コンテンツ ソースの ID の種類として [ 非 ME-ID ] を選択します。
ID マッピングに必要な情報を入力します。 たとえば、メール アドレスに基づいて ID をマップする場合は、次のようにします。
- [Microsoft Entra ユーザー] プロパティで、[メール] を選択します。
- [Microsoft Entra以外のユーザー プロパティ] で、[ID プロパティの追加] を選択し、[Email] を選択します。
([^@]+)などの式を使用して、@記号ではない 1 つ以上の文字のシーケンスをキャプチャします。{0}@<your-domain>など、マッピングを完了する数式を作成します。
コンテンツ設定をカスタマイズする
クエリ文字列
クエリ文字列条件を使用すると、アーティクルの同期を正確に制御し、効率的なインデックス作成を実現できます。
プロパティを管理する
次の表は、Veeva Vault RIM コネクタが既定でインデックスを作成するプロパティの一覧です。
| プロパティ | Veeva フィールド | セマンティック ラベル | 説明 | スキーマ属性 |
|---|---|---|---|---|
| ID | document_number_version | ドキュメント番号とバージョンで構成されるドキュメントの一意識別子 | クエリ、取得 | |
| DocumentNumber | document_number__v | Veeva システムのシステム割り当てドキュメント番号 | クエリ、取得 | |
| GlobalId | global_id__sys | Vault 間でシステムによって生成されたグローバル一意識別子 | クエリ、取得、検索 | |
| 名前 | name__v | title | ドキュメント名またはタイトル (最大 100 文字) | クエリ、取得、検索 |
| FileName | filename__v | fileName | アップロードされたソース ファイルの名前 | クエリ、取得、検索 |
| 拡張子 | filename__vのファイル拡張子 | FileExtension | ファイルの種類の拡張子 (PDF、DOCX、PPTX など) | クエリ、取得、検索 |
| 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 システムの一意のドキュメント識別子 (主キー) | クエリ、取得 | |
| バージョン | {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 | ドキュメントのメジャー バージョン番号 (v2.1 の "2" など) | クエリ、取得 | |
| MinorVersion | minor_version_number__v | ドキュメントのマイナー バージョン番号 (v2.1 の "1" など) | クエリ、取得 | |
| 型 | type__v | containerName | 最上位のドキュメントタイプ分類 | クエリ、取得 |
| Subtype | subtype__v | タイプの下の第 2 レベルのドキュメント分類 | クエリ、取得 | |
| Product | product__v.name__v | ドキュメントに関連付けられている製品 | クエリ、取得 | |
| 国 | country__v.name__v | ドキュメントに関連付けられている国または地域 | クエリ、取得 | |
| フォーマット | format__v | ソース ドキュメントのファイル形式 | クエリ、取得 | |
| ItemType | format__v | Itemtype | ドキュメント形式から派生したアイテムの種類 | クエリ、取得、絞り込み |
| ItemPath | {type__v}/{subtype__v} | itemPath | ドキュメントの種類とサブタイプを組み合わせた階層パス | クエリ、取得 |
| DocumentCreationDate | document_creation_date__v | createdDateTime | ドキュメントが Vault で作成された日付と時刻 | クエリ、取得 |
| VersionModifiedDate | version_modified_date__v | lastModifiedDateTime | このバージョンが最後に変更された日時 | クエリ、取得 |
| CreatedBy | created_by__v (名前、電子メール) | createdBy | 最初にドキュメントを作成したユーザー | クエリ、取得、検索 |
| CreatedByUserId | created_by__v | ドキュメント作成者の内部ユーザー識別子 | クエリ、取得 | |
| LastModifiedBy | last_modified_by__v (名前、電子メール) | lastModifiedBy | ドキュメントを最後に変更したユーザー | クエリ、取得、検索 |
| LastModifiedByUserId | last_modified_by__v | 最後の修飾子の内部ユーザー識別子 | クエリ、取得 | |
| ライフサイクル | lifecycle__v | ドキュメントに割り当てられたライフサイクル | クエリ、取得 | |
| Size | size__v | ドキュメントのファイル サイズ | ||
| コンテンツ | ドキュメント コンテンツ | ドキュメントから抽出されたメイン テキストまたは本文コンテンツ | 検索 | |
| ApprovedDate | approved_date__c | ドキュメントが承認された日付 | クエリ、取得 | |
| AnnotationsAll | annotations_all__v | ドキュメントのすべての注釈の合計数 | クエリ、取得 | |
| AnnotationsAnchors | annotations_anchors__v | ドキュメントのアンカー注釈の数 | クエリ、取得 | |
| AnnotationsApproved | annotations_approved__v | ドキュメントの承認済み注釈の数 | クエリ、取得 | |
| AnnotationsAuto | annotations_auto__v | ドキュメントの自動生成された注釈の数 | クエリ、取得 | |
| AnnotationsClaim | annotations_claim__v | ドキュメントの要求注釈の数 | クエリ、取得 | |
| AnnotationsLines | annotations_lines__v | ドキュメントの行注釈の数 | クエリ、取得 | |
| AnnotationsLinks | annotations_links__v | ドキュメントのリンク注釈の数 | クエリ、取得 | |
| AnnotationsNotes | annotations_notes__v | ドキュメント上の注釈の数 | クエリ、取得 | |
| AnnotationsPermalink | annotations_permalink__v | ドキュメント上のパーマリンク注釈の数 | クエリ、取得 | |
| AnnotationsResolved | annotations_resolved__v | ドキュメントの解決済み注釈の数 | クエリ、取得 | |
| AnnotationsUnresolved | annotations_unresolved__v | ドキュメント上の未解決の注釈の数 | クエリ、取得 | |
| FileCreatedBy | file_created_by__v | アップロードされたソース ファイルを作成したユーザー | クエリ、取得 | |
| FileCreatedDate | file_created_date__v | アップロードされたソース ファイルが作成された日付 | クエリ、取得 | |
| FileMetaAuthor | file_meta_author__v | ソース ファイルから抽出されたメタデータを作成する | クエリ、取得 | |
| FileMetaKeywords | file_meta_keywords__v | ソース ファイルから抽出されたキーワード メタデータ | クエリ、取得 | |
| FileModifiedBy | file_modified_by__v | アップロードしたソース ファイルを最後に変更したユーザー | クエリ、取得 | |
| FileModifiedDate | file_modified_date__v | アップロードされたソース ファイルが最後に変更された日付 | クエリ、取得 | |
| SourceDocumentId | source_document_id__v | このバージョンが派生したソース ドキュメントの識別子 | クエリ、取得 | |
| SourceDocumentName | source_document_name__v | このバージョンが派生したソース ドキュメントの名前 | クエリ、取得 | |
| VersionCreatedBy | version_created_by__v (名前、電子メール) | この特定のドキュメント バージョンを作成したユーザー | クエリ、取得、検索 | |
| VersionLink | version_link__sys | ドキュメント バージョンへのシステム リンク | クエリ、取得 | |
| HealthAuthorityVersion | health_authority_version__c | 規制申請の正常性機関のバージョン識別子 | クエリ、取得 | |
| IdmpSubmissionDate | idmp_submission_date__v | 医薬品 (IDMP) の提出日の識別 | クエリ、取得 | |
| IncludeForAllLanguages | include_for_all_languages__v | ドキュメントがすべての言語バージョンに含まれているかどうかを示します | クエリ、取得 | |
| MasterFileCode | master_file_code__v | 規制ドキュメントのマスター ファイル コード | クエリ、取得 | |
| MasterFileIdentifier | master_file_identifier__v | 規制ドキュメントのマスター ファイル識別子 | クエリ、取得 | |
| RIMAutoClassification | rim_autoclassification__v | ドキュメントに割り当てられた RIM 自動分類値 | クエリ、取得 | |
| TemplateDocument | template_document__v | ドキュメントがテンプレートであるかどうかを示します | クエリ、取得 | |
| XevmpdSubmissionStatus | xevmpd_attachment_only_submission_status__v | 拡張 EudraVigilance 薬用製品辞書 (XEVMPD) 添付ファイルのみの提出状態 | クエリ、取得 |
カスタム プロパティを追加する
コネクタは、既定のプロパティに加えて、Veeva Vault RIM インスタンスからカスタムやその他のドキュメント プロパティを自動的に検出します。 セットアップ中に、コネクタはクエリ可能で無効ではなく、非表示ではない使用可能なすべてのドキュメント フィールドを取得し、[ プロパティの管理] の下に追加のプロパティとして表示します。
これらのカスタム プロパティを 1 つずつ選択してコネクタ スキーマに追加できます。 追加された各カスタム プロパティには、次の既定のスキーマ属性があります。
- クエリ と 取得 は既定で有効になっています。
- 検索 と 絞り込み は既定では有効になっていませんが、[ プロパティの管理] で有効にすることができます。
Veeva Vault オブジェクト (ObjectReference 型) を参照するプロパティの場合、コネクタは参照先オブジェクトのメタデータもフェッチし、そのフィールドを入れ子になったプロパティとして公開します。 たとえば、カスタム プロパティが campaign__v 型の VObject を参照している場合、コネクタは campaign__v.name__v、 campaign__v.status__vなどのプロパティを生成します。
カスタム プロパティを追加した後、[プロパティの 管理] で、任意のプロパティ (既定とカスタムの両方) のスキーマ属性をカスタマイズできます。 organizationの要件に基づいて、各プロパティに対してクエリ、取得、検索、および絞り込みを有効または無効にすることができます。
同期間隔をカスタマイズする
organizationの要件に合わせてフル クロールの頻度を変更できます。 既定のクロールを次に示します。
- フル クロール -毎日。
詳細については、「同期設定のガイドライン」を参照してください。