Compartilhar via


Implementar o conector de Microsoft 365 Copilot Veeva QualityDocs

O conector veeva QualityDocs Microsoft 365 Copilot permite que as organizações indexem documentos de qualidade controlada, como Standard Procedimentos Operacionais (SOPs), instruções de trabalho, políticas, CAPAs e registos em lote, desde QualityDocs do Veeva Vault até ao Microsoft Graph. Esta integração torna-os acessíveis em todas as experiências do Microsoft 365, incluindo Microsoft 365 Copilot e o Microsoft Search. O conector respeita o modelo de permissão granular QualityDocs do Vault, garantindo que apenas os utilizadores autorizados podem ver ou interagir com documentos relevantes. Ao emparelhar as capacidades de IA da Microsoft com a única fonte de verdade, qualidade, regulamentação, fabrico e cadeia de fornecimento da Microsoft, as equipas podem colaborar de forma mais eficiente e manter a conformidade.

Este artigo descreve os passos para implementar e personalizar o conector Veeva QualityDocs. Para obter informações gerais sobre a implementação do conector Copilot, veja Configurar conectores Copilot no Centro de administração do Microsoft 365.

Pré-requisitos

Antes de implementar o conector, certifique-se de que cumpre os seguintes pré-requisitos:

  • Tem de ser um administrador do Microsoft 365.
  • A sua organização tem de ter um ambiente QualityDocs do Veeva Vault configurado.
  • Microsoft Entra ID tem de ser configurado para a autenticação OAuth 2.0/OpenID Connect.
  • Tem de ter o ID de cliente e o segredo do cliente da sua aplicação Microsoft Entra.
  • Tem de ter o URL da instância QualityDocs do Veeva Vault.
  • O mapeamento de identidade do utilizador entre QualityDocs do Cofre Veeva e Microsoft Entra ID tem de ser configurado.

Registar uma aplicação e configurar o OAuth

Utilize os seguintes passos para configurar Microsoft Entra ID OAuth 2.0/OpenID Connect para o conector Veeva QualityDocs.

  1. Registar uma aplicação no Microsoft Entra ID.

    • Aceda a centro de administração do Microsoft Entra>Registros de aplicativo>Novo registo.
    • Atribua um nome à aplicação e selecione Contas apenas neste diretório organizacional.
    • Adicione o URI de redirecionamento:
      • Para Microsoft 365 Enterprise:https://gcs.office.com/v1.0/admin/oauth/callback
      • Para o Microsoft 365 Administração Pública: https://gcsgcc.office.com/v1.0/admin/oauth/callback
    • Gere um segredo do cliente em Certificados & Segredos e armazene-o de forma segura.
  2. Configurar o OAuth em Veeva QualityDocs.

    • Aceda a Administração > Definições > Perfis OAuth 2.0/OpenID Connect.
    • Crie um novo perfil, defina o Estado como ativo e selecione Azure AD como fornecedor.
    • Selecione Carregar metadados> ASFornecer URL de Metadados do Servidor de Autorização e cole a seguinte ligação. Substitua {tenant-id} pelo seu ID de inquilino. https://login.microsoftonline.com/{tenant-id}/v2.0/.well-known/openid-configuration
    • Definir Identidade está noutra afirmação como upne, em Tipo de ID de Utilizador, selecione ID Federado. O UPN deve ser o mesmo que o ID federado.
    • EscolhaAdicionarAplicações> Cliente e utilize o ID de cliente da sua aplicação Microsoft Entra ID para o ID de Cliente da Aplicação e o ID de Cliente do Servidor de Autorização. Adicione uma Etiqueta da Aplicação.

    Observação

    Para ativar a validação de Restrição de Audiência estrita, adicione o ID de cliente ao campo Audiência .

  3. Crie políticas de segurança e ligue utilizadores.

    • Aceda a Administração > Definições Políticas >> de SegurançaCriar>Início de sessão único. Forneça um nome e uma descrição e defina o status como ativo.
    • Para o tipo de autenticação, selecione Início de Sessão Único e escolha um perfil. Para obter mais informações, veja Configurar o Início de Sessão Único.
    • No Perfil de ESignature, selecione Nenhum e, em OAuth 2.0/OpenID Connect Profile, selecione o perfil OAuth 2.0 que criou. Mantenha os valores padrão nas configurações restantes.
    • Aceda a Administração>Utilizadores & Grupos, selecione o proprietário do cofre e selecione Editar.
    • Em Política de>Segurança de Detalhes, altere os valores para a nova política e, em ID Federado, altere o valor para o UPN da conta de administrador do conector.

Implementar o conector

Para adicionar o conector Veeva QualityDocs à sua organização:

  1. Na Centro de administração do Microsoft 365, no painel esquerdo, selecioneConectoresCopilot>.
  2. Aceda ao separador Conectores e, no painel esquerdo, selecione Galeria.
  3. Na lista de conectores disponíveis, selecione Veeva QualityDocs.

Definir nome a apresentar

O nome a apresentar é utilizado para identificar referências em respostas copilot para ajudar os utilizadores a reconhecer o ficheiro ou item associado. O nome a apresentar também significa conteúdo fidedigno e é utilizado como um filtro de origem de conteúdo.

Pode aceitar o nome a apresentar predefinido veeva QualityDocs ou personalizar o valor para utilizar um nome a apresentar que os utilizadores na sua organização reconheçam.

Para obter mais informações sobre os nomes a apresentar e descrições do conector, veja Melhorar a deteção copilot de conteúdo do conector.

Definir URL da instância

Introduza o URL da sua instância Veeva QualityDocs. Por exemplo: https://<your-vault-domain>.veevavault.com.

Escolher tipo de autenticação

Para autenticar o conector Veeva QualityDocs, para o tipo de Autenticação, selecione Microsoft Entra ID OIDC e forneça as seguintes informações:

  • URL do ID da sessão do cofre: em Veeva QualityDocs, aceda a Administração painel>Definições>OAuth 2.0/OpenID Connect Profiles e escolha o perfil que criou para esta ligação. Copie o URL do ID da Sessão do Cofre.
  • ID de Cliente: o ID da aplicação Entra que registou para Veeva QualityDocs.
  • Segredo do cliente: o segredo do cliente associado à aplicação Entra.

Selecione Autorizar para iniciar sessão com a sua conta do Entra ID e selecione Consentimento em nome da sua organização e, no ecrã do pedido de permissão, selecione Aceitar.

Importante

Configure as definições de administrador Microsoft Entra ID e Veeva QualityDocs para ativar a autenticação Microsoft Entra ID.

Implementar

Para implementar para uma audiência limitada, selecione o botão de alternar junto a Implementação para audiência limitada e especifique os utilizadores e grupos para os quais pretende implementar o conector. Para obter mais informações, veja Implementação faseada para conectores Copilot.

Selecione Criar para implementar a ligação. O conector Veeva QualityDocs Copilot começa imediatamente a indexar conteúdo.

A tabela seguinte lista os valores predefinidos que estão definidos.

Categoria Valor padrão
Usuários Respeita as permissões veeva QualityDocs; apenas os documentos visíveis são acessíveis.
Conteúdo Indexa metadados chave, como o nome do documento, o proprietário e a fase do ciclo de vida.
Sincronização Pesquisas completas todos os dias.

Para personalizar estes valores, selecione Configuração personalizada. Para obter mais informações, veja Personalizar definições.

Depois de criar a ligação, pode rever a status na secção Conectores do Centro de administração do Microsoft 365.

Personalizar definições (opcional)

Pode personalizar os valores predefinidos para as definições do conector Veeva QualityDocs. Para personalizar as definições, na página do conector no centro de administração, selecione Configuração personalizada.

Personalizar as definições do utilizador

Permissões de acesso

O conector cumpre as listas de controlo de acesso (ACLs) definidas em Veeva QualityDocs. Apenas os utilizadores com permissões de visualização em Veeva QualityDocs podem ver o conteúdo indexado no Microsoft 365. Opcionalmente, os administradores podem permitir que todos os utilizadores acedam a todos os conteúdos indexados, embora esta abordagem não seja recomendada para repositórios regulados.

Identidades de mapeamento

O conector baseia-se no mapeamento de identidades de utilizador Veeva QualityDocs (por exemplo, ID Federado) para Microsoft Entra ID contas de utilizador. Certifique-se de que a Microsoft Entra UPN corresponde ao ID Federado utilizado em QualityDocs ou configure o mapeamento de identidade personalizado para que as permissões de segurança possam ser impostas corretamente.

Se quiser impor as definições de segurança da sua instância Veeva QualityDocs, selecione Non-ME-ID como o tipo de identidade da sua origem de conteúdo.

Introduza as informações necessárias para o mapeamento de identidades. Por exemplo, se quiser mapear identidades com base em endereços de e-mail:

  1. Para a propriedade Microsoft Entra utilizador, selecione Correio.
  2. Em propriedade de utilizador não Microsoft Entra, selecione Adicionar propriedade de identidade e escolha Email. Utilize uma expressão como ([^@]+) para capturar uma sequência de um ou mais carateres que não são o @ símbolo. Crie uma fórmula para concluir o mapeamento, como {0}@<your-domain>.

Personalizar definições de conteúdo

Cadeia de consulta

Pode utilizar condições de cadeia de consulta para incluir apenas documentos relevantes para permitir uma indexação mais direcionada e eficiente.

Gerir propriedades

A tabela seguinte lista as propriedades que o conector Veeva QualityDocs indexa por predefinição.

Propriedade Etiqueta Semântica Descrição Atributos de Esquema
conteúdo Texto principal ou conteúdo do corpo extraído do documento Pesquisar
country País ou região associado ao documento Consultar, Obter
createdBy CreatedBy Utilizador que criou inicialmente o documento Consultar, Obter
createdByUserId Identificador de utilizador interno para o criador do documento Consultar, Obter
daysBeforeToStartPeriodicReview Número de dias antes do início da revisão periódica do documento Consultar, Obter
documentCreationDate DataeHoraDaCriação Data e hora em que o documento foi originalmente criado Consultar, Obter
documentId Identificador exclusivo do documento no sistema Veeva Consultar, Obter
extensão FileExtension Extensão de tipo de ficheiro, como PDF, DOCX, XLSX Consultar, Obter, Procurar
fileName Título Nome do ficheiro ou título do documento Consultar, Obter, Procurar
format Formatar ou escrever informações do documento Consultar, Obter
id Identificador exclusivo do registo do documento Consultar, Obter
implementationPeriodDays Número de dias designados para a implementação do documento Consultar, Obter
importedDocument Indica se o documento foi importado Consultar, Obter
lastModifiedBy LastModifiedBy Utilizador que modificou o documento pela última vez Consultar, Obter
lastModifiedByUserId Identificador de utilizador interno do último modificador Consultar, Obter
ciclo de vida Estado do ciclo de vida do documento (por exemplo, Rascunho, Aprovado) Consultar, Obter
majorVersion Número de versão principal do documento Consultar, Obter
minorVersion Número de versão secundária do documento Consultar, Obter
obsolescenceApproved Indica se a obsolescência foi aprovada Consultar, Obter
owningDepartment Departamento responsável por ser o proprietário do documento Consultar, Obter
owningFacility Instalação associada à propriedade do documento Consultar, Obter
periodicReviewFrequency Frequência com que o documento é submetido a revisão periódica Consultar, Obter
produto Produto relacionado ou abrangido pelo documento Consultar, Obter
referenceModelCategory Categoria de modelo de referência de alto nível do documento Consultar, Obter
referenceModelSubcategory Subcategoria na classificação do modelo de referência Consultar, Obter
requiresDcc Indica se o Controlo de Alteração de Documentos é necessário Consultar, Obter
scope Âmbito ou aplicabilidade do documento Consultar, Obter
size Tamanho do ficheiro do documento
status Status de documentos (por exemplo, Ativo, Arquivado) Consultar, Obter
subtipo Subtipo específico ou classificação do documento Consultar, Obter
type Tipo ou categoria principal do documento Consultar, Obter
url url URL direto para aceder ou pré-visualizar o documento Consultar, Obter
versionModifiedDate DataeHoraDaÚltimaModificação Data e hora em que esta versão foi modificada pela última vez Consultar, Obter

Personalizar intervalos de sincronização

Pode modificar a frequência das pesquisas completas de acordo com os requisitos da sua organização. A predefinição é uma pesquisa completa todos os dias. Para obter mais informações, veja Diretrizes para definições de sincronização.