Condividi tramite


Distribuire il connettore Microsoft 365 Copilot Veeva QualityDocs

Il connettore Veeva QualityDocs Microsoft 365 Copilot consente alle organizzazioni di indicizzare documenti di qualità controllati, ad esempio Standard procedure operative (SOP), istruzioni di lavoro, criteri, CAPA e record batch, da QualityDocs di Veeva Vault a Microsoft Graph. Questa integrazione li rende accessibili nelle esperienze di Microsoft 365, tra cui Microsoft 365 Copilot e Microsoft Search. Il connettore rispetta il modello di autorizzazione granulare di Vault QualityDocs, garantendo che solo gli utenti autorizzati possano visualizzare o interagire con i documenti pertinenti. Associando le funzionalità di intelligenza artificiale di Microsoft con l'unica fonte di verità, qualità, normative, produzione e supply chain di QualityDocs, i team possono collaborare in modo più efficiente mantenendo la conformità.

Questo articolo descrive i passaggi per distribuire e personalizzare il connettore Veeva QualityDocs. Per informazioni generali sulla distribuzione del connettore Copilot, vedere Configurare i connettori Copilot nel interfaccia di amministrazione di Microsoft 365.

Prerequisiti

Prima di distribuire il connettore, assicurarsi di soddisfare i prerequisiti seguenti:

  • È necessario essere un amministratore di Microsoft 365.
  • L'organizzazione deve avere un ambiente Veeva Vault QualityDocs configurato.
  • Microsoft Entra ID deve essere configurato per l'autenticazione OAuth 2.0/OpenID Connect.
  • È necessario disporre dell'ID client e del segreto client dell'applicazione Microsoft Entra.
  • È necessario disporre dell'URL dell'istanza di Veeva Vault QualityDocs.
  • È necessario configurare il mapping delle identità utente tra Veeva Vault QualityDocs e Microsoft Entra ID.

Registrare un'applicazione e configurare OAuth

Seguire questa procedura per configurare Microsoft Entra ID OAuth 2.0/OpenID Connect per il connettore Veeva QualityDocs.

  1. Registrare un'applicazione in Microsoft Entra ID.

    • Passare a Interfaccia di amministrazione di Microsoft Entra>Registrazioni app>Nuova registrazione.
    • Assegnare all'applicazione il nome e selezionare Account solo in questa directory organizzativa.
    • Aggiungere l'URI di reindirizzamento:
      • Per Microsoft 365 Enterprise:https://gcs.office.com/v1.0/admin/oauth/callback
      • Per Microsoft 365 Per enti pubblici: https://gcsgcc.office.com/v1.0/admin/oauth/callback
    • Generare un segreto client in Certificati & Segreti e archiviarlo in modo sicuro.
  2. Configurare OAuth in Veeva QualityDocs.

    • Passare a Amministrazione > Settings OAuth 2.0/OpenID Connect Profiles (Impostazioni > OAuth 2.0/OpenID Connect Profiles).
    • Creare un nuovo profilo, impostare Stato su attivo e selezionare Azure AD come provider.
    • Scegliere Carica metadati> ASSpecificare l'URL dei metadati del server di autorizzazione e incollare il collegamento seguente. Sostituire {tenant-id} con l'ID tenant. https://login.microsoftonline.com/{tenant-id}/v2.0/.well-known/openid-configuration
    • Impostare Identità è in un'altra attestazione su upne in Tipo ID utente selezionare ID federato. L'UPN deve essere uguale all'ID federato.
    • Scegliere Aggiungi applicazioni> client e usare l'ID client dell'applicazione Microsoft Entra ID sia per l'ID client dell'applicazione che per l'ID client del server di autorizzazione. Aggiungere un'etichetta dell'applicazione.

    Nota

    Per abilitare La convalida di Una restrizione del gruppo di destinatari rigorosa, aggiungere l'ID client al campo Gruppo di destinatari .

  3. Creare criteri di sicurezza e collegare gli utenti.

    • Passare a Amministrazione > Impostazioni Criteri >> di sicurezzaCreare>l'accesso Single Sign-On. Specificare un nome e una descrizione e impostare lo stato su attivo.
    • Per il tipo di autenticazione, scegliere Single Sign-On e scegliere un profilo. Per altre informazioni, vedere Configurazione dell'accesso Single Sign-On.
    • In eSignature Profile (Profilo di eSignature) selezionare Nessuno e in OAuth 2.0/OpenID Connect Profile (Profilo di connessione OpenID) selezionare il profilo OAuth 2.0 creato. Per le altre impostazioni, mantenere i valori predefiniti.
    • Passare a Amministrazione>Utenti & Gruppi, selezionare il proprietario dell'insieme di credenziali e scegliere Modifica.
    • In Dettagli>criteri di sicurezza modificare i valori in nuovi criteri e in ID federato modificare il valore in UPN dell'account amministratore del connettore.

Distribuire il connettore

Per aggiungere il connettore Veeva QualityDocs per l'organizzazione:

  1. Nel riquadro sinistro della interfaccia di amministrazione di Microsoft 365 scegliere Connettori Copilot>.
  2. Passare alla scheda Connettori e nel riquadro sinistro scegliere Raccolta.
  3. Nell'elenco dei connettori disponibili scegliere Veeva QualityDocs.

Impostare il nome visualizzato

Il nome visualizzato viene usato per identificare i riferimenti nelle risposte copilot per consentire agli utenti di riconoscere il file o l'elemento associato. Il nome visualizzato indica anche il contenuto attendibile e viene usato come filtro origine contenuto.

È possibile accettare il nome visualizzato predefinito di Veeva QualityDocs o personalizzare il valore per usare un nome visualizzato riconosciuto dagli utenti dell'organizzazione.

Per altre informazioni sui nomi visualizzati e sulle descrizioni dei connettori, vedere Migliorare l'individuazione copilot del contenuto del connettore.

Impostare l'URL dell'istanza

Immettere l'URL dell'istanza di Veeva QualityDocs. Ad esempio: https://<your-vault-domain>.veevavault.com.

Scegliere il tipo di autenticazione

Per autenticare il connettore Veeva QualityDocs, per il tipo di autenticazione scegliere Microsoft Entra ID OIDC e specificare le informazioni seguenti:

  • URL DELL'ID sessione dell'insieme di credenziali: in Veeva QualityDocs passare a Amministrazione pannello>Impostazioni>OAuth 2.0/OpenID Connect Profiles e scegliere il profilo creato per questa connessione. Copiare l'URL dell'ID sessione dell'insieme di credenziali.
  • ID client: ID applicazione per l'applicazione Entra registrata per Veeva QualityDocs.
  • Segreto client: segreto client associato all'applicazione Entra.

Selezionare Autorizza per accedere con l'account ID entra e selezionare Consenso per conto dell'organizzazione e nella schermata della richiesta di autorizzazione scegliere Accetta.

Importante

Configurare le impostazioni di amministrazione di Microsoft Entra ID e Veeva QualityDocs per abilitare l'autenticazione Microsoft Entra ID.

Eseguire l'implementazione

Per eseguire l'implementazione a un gruppo di destinatari limitato, scegliere l'interruttore accanto a Implementazione a gruppi di destinatari limitati e specificare gli utenti e i gruppi a cui distribuire il connettore. Per altre informazioni, vedere Implementazione temporanea per i connettori Copilot.

Scegliere Crea per distribuire la connessione. Il connettore Veeva QualityDocs Copilot avvia immediatamente l'indicizzazione del contenuto.

Nella tabella seguente sono elencati i valori predefiniti impostati.

Categoria Valore predefinito
Utenti Rispetta le autorizzazioni Veeva QualityDocs; sono accessibili solo i documenti visualizzabili.
Contenuto Indicizza i metadati della chiave, ad esempio il nome del documento, il proprietario e la fase del ciclo di vita.
Sincronizza Ricerche per indicizzazione complete ogni giorno.

Per personalizzare questi valori, scegliere Configurazione personalizzata. Per altre informazioni, vedere Personalizzare le impostazioni.

Dopo aver creato la connessione, è possibile esaminare lo stato nella sezione Connettori del interfaccia di amministrazione di Microsoft 365.

Personalizzare le impostazioni (facoltativo)

È possibile personalizzare i valori predefiniti per le impostazioni del connettore Veeva QualityDocs. Per personalizzare le impostazioni, nella pagina del connettore nell'interfaccia di amministrazione scegliere Configurazione personalizzata.

Personalizzare le impostazioni utente

Autorizzazioni di accesso

Il connettore è conforme agli elenchi di controllo di accesso (ACL) definiti in Veeva QualityDocs. Solo gli utenti con autorizzazioni di visualizzazione in Veeva QualityDocs possono visualizzare il contenuto indicizzato in Microsoft 365. Gli amministratori possono facoltativamente consentire a tutti gli utenti l'accesso a tutto il contenuto indicizzato, anche se questo approccio non è consigliato per i repository regolamentati.

Mapping delle identità

Il connettore si basa sul mapping delle identità utente di Veeva QualityDocs (ad esempio, l'ID federato) agli account utente Microsoft Entra ID. Assicurarsi che il Microsoft Entra UPN corrisponda all'ID federato usato in QualityDocs oppure configurare il mapping di identità personalizzato in modo che le autorizzazioni di sicurezza possano essere applicate correttamente.

Se si vogliono applicare le impostazioni di sicurezza dell'istanza di Veeva QualityDocs, scegliere Non-ME-ID come tipo di identità per l'origine contenuto.

Immettere le informazioni necessarie per il mapping delle identità. Ad esempio, se si vuole eseguire il mapping delle identità in base agli indirizzi di posta elettronica:

  1. Per la proprietà utente Microsoft Entra selezionare Posta.
  2. In proprietà utente non Microsoft Entra selezionare Aggiungi proprietà di identità e scegliere Email. Usare un'espressione, ad ([^@]+) esempio per acquisire una sequenza di uno o più caratteri che non sono il @ simbolo. Creare una formula per completare il mapping, ad {0}@<your-domain>esempio .

Personalizzare le impostazioni del contenuto

Stringa di query

È possibile usare le condizioni della stringa di query per includere solo documenti pertinenti per abilitare un'indicizzazione più mirata ed efficiente.

Gestire le proprietà

Nella tabella seguente sono elencate le proprietà indicizzate per impostazione predefinita dal connettore Veeva QualityDocs.

Proprietà Campo Veeva Etichetta semantica Descrizione Attributi dello schema
Id document_number + versione del documento Identificatore univoco per il record del documento Query, Retrieve
FileName filename__v Filename Nome del file di origine caricato Query, Recupero, Ricerca
Titolo title__v title Titolo del documento Recupera, Cerca
Descrizione description__v Descrizione in testo libero del documento Recupera, Cerca
Extension estensione file di filename__v Fileextension Estensione del tipo di file, ad esempio PDF, DOCX, XLSX Query, Recupero, Ricerca
Url https://{vaultDns}/ui/#doc_info/{id}/{major_version_number__v}/{minor_version_number__v} Url URL diretto per accedere o visualizzare in anteprima il documento in Veeva Vault Query, Retrieve
Stato status__v Stato Stato corrente del ciclo di vita del documento (ad esempio Bozza, Approvato, Effettivo) Query, Retrieve
DocumentId id Identificatore univoco del documento (chiave primaria) nel sistema Veeva Query, Retrieve
GlobalId global_id__sys Identificatore univoco globale generato dal sistema tra insiemi di credenziali Query, Retrieve
DocumentNumber document_number__v Numero di documento assegnato dal sistema nel sistema Veeva Query, Retrieve
Versione {major_version_number__v}_{minor_version_number__v} Stringa di versione combinata del documento Query, Retrieve
UrlRoutingId concat(id, '/', major_version_number__v, '/', minor_version_number__v) Identificatore di routing composito usato per la risoluzione degli URL Query, Retrieve
Majorversion major_version_number__v Numero di versione principale del documento Query, Retrieve
Minorversion minor_version_number__v Numero di versione secondario del documento Query, Retrieve
Tipo type__v Containername Classificazione dei tipi di documento di primo livello Query, Retrieve
Sottotipo subtype__v Classificazione dei documenti di secondo livello nel tipo Query, Retrieve
Prodotto product__v.name__v Prodotto correlato o coperto dal documento Query, Retrieve
Tag tags__v tag Tag o parole chiave associate al documento Query, Retrieve, Refine
Paese country__v.name__v Paese o area geografica associati al documento Query, Retrieve
Formato format__v Informazioni sul formato o sul tipo di documento Query, Retrieve
Itemtype format__v Itemtype Tipo di elemento derivato dal formato del documento Query, Retrieve, Refine
Itempath {type__v}/{subtype__v} Itempath Percorso gerarchico che combina il tipo di documento e il sottotipo Query, Retrieve
Proprietario source_owner__v Proprietario del documento nel sistema Veeva Query, Retrieve, Search, Refine
DocumentCreationDate document_creation_date__v createdDateTime Data e ora di creazione del documento Query, Retrieve
VersionModifiedDate version_modified_date__v lastModifiedDateTime Data e ora dell'ultima modifica di questa versione Query, Retrieve
CreatedBy created_by__v (nome, posta elettronica) createdBy Utente che inizialmente ha creato il documento Query, Recupero, Ricerca
CreatedByUserId created_by__v Identificatore utente interno per l'autore del documento Query, Retrieve
LastModifiedByUserId last_modified_by__v Identificatore utente interno dell'ultimo modificatore Query, Retrieve
LastModifiedBy last_modified_by__v (nome, posta elettronica) lastModifiedBy Utente che ha modificato il documento per l'ultima volta Query, Recupero, Ricerca
Ciclo di vita lifecycle__v Ciclo di vita assegnato al documento Query, Retrieve
OwningDepartment owning_department__v.name__v Reparto responsabile della proprietà del documento Query, Retrieve
OwningFacility owning_facility__c.name__v Struttura associata alla proprietà del documento Query, Retrieve
ReferenceModelCategory reference_model_category__c.name__v Categoria di modelli di riferimento di alto livello del documento Query, Retrieve
ReferenceModelSubcategory reference_model_subcategory__c.name__v Sottocategoria all'interno della classificazione del modello di riferimento Query, Retrieve
PeriodicReviewFrequency periodic_review_frequency1__c Frequenza con cui il documento viene sottoposto a revisione periodica Query, Retrieve
DaysBeforeToStartPeriodicReview days_before_to_start_periodic_review__c Numero di giorni prima dell'inizio della revisione periodica del documento Query, Retrieve
ObsolescenceApproved obsolescence_approved__c Indica se l'obsolescenza è approvata Query, Retrieve
Ambito scope__c Ambito o applicabilità del documento Query, Retrieve
ImplementationPeriodDays implementation_period_days__c Numero di giorni designati per l'implementazione del documento Query, Retrieve
RequiresDcc requires_dcc__c Indica se è necessario il controllo delle modifiche del documento Query, Retrieve
ImportedDocument imported_document__c Indica se il documento è stato importato Query, Retrieve
Dimensioni size__v Dimensioni del file del documento
Contenuto contenuto del documento Contenuto principale del testo o del corpo estratto dal documento Ricerca

Aggiungere proprietà personalizzate

Oltre alle proprietà predefinite, il connettore individua automaticamente le proprietà personalizzate e di altro documento dall'istanza di Veeva QualityDocs. Durante l'installazione, il connettore recupera tutti i campi del documento disponibili che possono essere sottoposti a query, non disabilitati e non nascosti e li presenta come proprietà aggiuntive in Gestisci proprietà.

È possibile selezionare e aggiungere queste proprietà personalizzate una alla volta allo schema del connettore. Ogni proprietà personalizzata aggiunta ha gli attributi dello schema predefiniti seguenti:

  • Query e recupero sono abilitati per impostazione predefinita.
  • Ricerca e affinamento non sono abilitati per impostazione predefinita, ma possono essere attivati in Gestisci proprietà.

Per le proprietà che fanno riferimento agli oggetti Veeva Vault (tipo ObjectReference), il connettore recupera anche i metadati dell'oggetto a cui si fa riferimento ed espone i relativi campi come proprietà annidate. Ad esempio, se una proprietà personalizzata fa riferimento a un VObject di tipo campaign__v, il connettore genera proprietà come campaign__v.name__v, campaign__v.status__ve così via.

Dopo aver aggiunto proprietà personalizzate, è possibile personalizzare gli attributi dello schema per qualsiasi proprietà, sia predefinita che personalizzata, in Gestisci proprietà. È possibile abilitare o disabilitare Query, Retrieve, Search e Refine per ogni proprietà in base ai requisiti dell'organizzazione.

Personalizzare gli intervalli di sincronizzazione

È possibile modificare la frequenza delle ricerche per indicizzazione complete in base ai requisiti dell'organizzazione. Il valore predefinito è una ricerca per indicizzazione completa ogni giorno. Per altre informazioni, vedere Linee guida per le impostazioni di sincronizzazione.