Configurar conectores do Microsoft Graph no Centro de administração do Microsoft 365
Este artigo mostra o processo básico necessário para configurar conectores do Microsoft Graph no Centro de administração do Microsoft 365. O processo básico inclui as seguintes etapas:
- Adicionar um conector do Microsoft Graph no Centro de administração do Microsoft 365
- Dar um nome à conexão
- Definir as configurações de conexão
- Selecionar propriedades
- Gerenciar as permissões de pesquisa
- Atribuir os rótulos de propriedade
- Gerenciar esquema
- Atualizar as configurações
- Analisar a conexão
- Personalizar a página de resultados da pesquisa
Este artigo também inclui as seguintes informações:
Observação
O processo de instalação é semelhante para todos os conectores do Microsoft Graph, mas não é exatamente o mesmo. Além de ler este artigo, leia as informações específicas do conector para sua fonte de dados.
Etapa 1: Adicionar um conector do Microsoft Graph no Centro de administração do Microsoft 365
Conclua as seguintes etapas para configurar qualquer um dos conectores do Microsoft Graph:
Entre em sua conta de administrador no Centro de administração do Microsoft 365.
No painel de navegação, selecione Configurações e, em seguida, selecione Pesquisar & inteligência. Selecione a guia Fontes de dados.
Selecione +Adicionar e, em seguida, selecione a fonte de dados de sua escolha no menu de opções disponíveis.
Observação
Você pode adicionar um máximo de dez conexões do Microsoft Graph a cada locatário.
Etapa 2: Nomear a conexão
Especifique estes atributos:
- Nome (obrigatório)
- ID da conexão (obrigatório)
- Descrição (opcional)
- Marque a caixa de seleção (obrigatório)
A ID de conexão cria propriedades implícitas para o conector. Ele deve conter apenas caracteres alfanuméricos e ter um máximo de 32 caracteres.
Etapa 3: Definir as configurações de conexão
O processo para definir as configurações de conexão varia de acordo com o tipo de fonte de dados. Para o tipo de fonte de dados a ser adicionada ao seu locatário para concluir esta etapa no processo de instalação, consulte as informações específicas do Conector.
Para saber mais sobre como se conectar a uma fonte de dados local, consulte Configurar o Agente do Conector do Microsoft Graph.
Etapa 4: Selecionar propriedades
Você pode escolher as propriedades indexadas pela Pesquisa da Microsoft.
Observação
Para atualizar as propriedades rastreadas depois de criar uma conexão, consulte o artigo gerenciar esquema de pesquisa.
Etapa 5: Gerenciar permissões de pesquisa
As ACLs (listas de controle de acesso) determinam quais usuários em sua organização podem acessar cada item.
Alguns conectores, como o Microsoft SQL e o Azure Data Lake Storage Gen2 dão suporte nativo a ACLs do Azure Active Directory (Azure AD) .
Outros conectores, como o ServiceNow Knowledge, o Catálogo do ServiceNow, os Itens de Trabalho do Azure DevOps e o Salesforce dão suporte à sincronização de grupos e usuários Azure AD não relacionados.
Selecionar todos permite que todos em sua organização vejam os resultados da pesquisa dessa fonte de dados.
Etapa 6: Atribuir rótulos de propriedade
Você pode atribuir rótulos semânticos às suas propriedades de origem na página "Atribuir rótulos de propriedade". Rótulos são marcas conhecidas fornecidas pela Microsoft que fornecem significado semântico. Eles permitem que a Microsoft integre seus dados do conector às experiências do Microsoft 365, como pesquisa aprimorada, cartões de pessoas, descoberta inteligente e muito mais.
A tabela a seguir lista os rótulos com suporte no momento e suas descrições.
| Rótulo | Descrição |
|---|---|
| título | O título do item que você deseja mostrar na pesquisa e em outras experiências |
| url | A URL de destino do item no sistema de origem |
| Criado por | Nome da pessoa que criou o item |
| Última modificação por | Nome da pessoa que editou o item mais recentemente |
| Authors | Nome das pessoas que participaram/colaboraram no item |
| Data e hora da criação | Hora em que o item foi criado |
| Data e hora da última modificação | Hora em que o item foi editado mais recentemente |
| Nome do arquivo | Nome do item de arquivo |
| Extensão do arquivo | Tipo de item de arquivo, como .pdf ou .word |
As propriedades nesta página são pré-selecionadas com base na fonte de dados, mas você pode alterar essa seleção se houver uma propriedade diferente mais adequada para um rótulo específico.
O rótulo título é o rótulo mais importante. É altamente recomendável que você tenha uma propriedade atribuída a esse rótulo para que sua conexão participe da experiência do cluster de resultados.
O mapeamento incorreto de rótulos causa uma experiência de pesquisa deteriorada. Não há problema em alguns rótulos não ter uma propriedade atribuída a ela.
Etapa 7: Gerenciar esquema
Propriedade Content
Recomendamos que você selecione uma Propriedade de Conteúdo no menu suspenso de opções ou mantenha o padrão se houver uma. Essa propriedade é usada para indexação de texto completo de conteúdo, geração de snippet de página de resultados de pesquisa, participação de cluster de resultados, detecção de idioma, suporte a HTML/texto, classificação e relevância e formulação de consulta.
Se você selecionar uma propriedade de conteúdo, terá a opção de usar a propriedade ResultSnippet gerada pelo sistema ao criar o tipo de resultado. Essa propriedade serve como um espaço reservado para os snippets dinâmicos gerados a partir da propriedade de conteúdo no momento da consulta. Se você usar essa propriedade em seu tipo de resultado, os snippets serão gerados nos resultados da pesquisa.
Aliases para propriedades de origem
Você pode adicionar aliases às suas propriedades na coluna "Alias" na página "Gerenciar esquema". Aliases são nomes amigáveis para suas propriedades. Eles são usados em consultas e na criação de filtros. Eles também são usados para normalizar as propriedades de origem de várias conexões, de modo que tenham o mesmo nome. Dessa forma, você pode criar um único filtro para um vertical com várias conexões. Para obter mais informações, consulte Personalizar a página de resultados da pesquisa.
Pesquisar atributos de esquema
Você pode definir os atributos de esquema de pesquisa para controlar a funcionalidade de pesquisa de cada propriedade de origem. Um esquema de pesquisa ajuda a determinar quais resultados são exibidos na página de resultados da pesquisa e quais informações os usuários finais podem exibir e acessar.
Os atributos de esquema de pesquisa incluem opções para Consultar, Pesquisar, Recuperar e Refinar. A tabela a seguir lista cada um dos atributos aos quais os conectores do Microsoft Graph dão suporte e explica suas funções.
| Atributo de esquema de pesquisa | Função | Exemplo |
|---|---|---|
| BUSCA | Torna o conteúdo de texto de uma propriedade pesquisável. O conteúdo da propriedade é incluído no índice de texto completo. | Se a propriedade for título, uma consulta enterprise retornará respostas que contenham a palavra Enterprise em qualquer texto ou título. |
| CONSULTA | Pesquisa por consulta uma correspondência para uma propriedade específica. O nome da propriedade pode ser especificado na consulta de forma programática ou textual. | Se a propriedade Title puder ser consultada, a consulta Title: Enterprise será compatível. |
| RECUPERAR | Somente propriedades recuperáveis podem ser usadas no tipo de resultado e exibidas no resultado da pesquisa. | |
| REFINAR | A opção refinar pode ser usada como na página de resultados da Pesquisa da Microsoft. | Os usuários em sua organização poderão filtrar por URL na página de resultados da pesquisa se a propriedade refinar estiver marcada durante a configuração da conexão. |
Para todos os conectores, exceto o conector de compartilhamento de arquivos, os tipos personalizados devem ser definidos manualmente. Para ativar os recursos de pesquisa para cada campo, você precisa de um esquema de pesquisa mapeado para uma lista de propriedades. O assistente de configuração de conexão seleciona automaticamente um esquema de pesquisa com base no conjunto de propriedades de origem que você escolher. Você pode modificar esse esquema marcando as caixas de seleção de cada propriedade e atributo na página de esquema de pesquisa.
Restrições e recomendações para configurações de esquema de pesquisa
A propriedade de conteúdo é pesquisável apenas. Depois de selecioná-la na lista suspensa, essa propriedade não poderá ser usada com as opções recuperadas ou consulta.
Problemas significativos de desempenho ocorrem quando os resultados da pesquisa são renderizados com a propriedade de conteúdo. Um exemplo é o campo Conteúdo de texto para um artigo da base de dados de conhecimento do ServiceNow .
Somente propriedades marcadas como renderizáveis recuperáveis nos resultados da pesquisa e podem ser usadas para criar MRTs (tipos de resultado modernos).
Somente propriedades de cadeia de caracteres podem ser marcadas como pesquisáveis.
Observação
Para atualizar o esquema depois de criar uma conexão, consulte o artigo gerenciar esquema de pesquisa.
Etapa 8: Atualizar configurações
O intervalo de atualização determina com que frequência seus dados são sincronizados entre a fonte de dados e a Pesquisa da Microsoft. Cada tipo de fonte de dados tem um conjunto diferente de agendamentos de atualização ideais com base na frequência com que os dados são modificados e no tipo de modificações.
Há dois tipos de intervalos de atualização, atualização completa e atualização incremental, mas as atualizações incrementais não estão disponíveis para algumas fontes de dados.
Com uma atualização completa, o mecanismo de pesquisa processa e indexa os itens que foram alterados na fonte de conteúdo, independentemente dos rastreamentos anteriores. Uma atualização completa funciona melhor para estas situações:
- Detectando exclusões de dados.
- A atualização incremental encontrou erros e falhou.
- AS ACLs foram modificadas.
- As regras de rastreamento foram modificadas.
- O esquema para a conexão foi atualizado.
Com uma atualização incremental, o mecanismo de pesquisa pode processar e indexar apenas os itens que foram criados ou modificados desde o último rastreamento bem-sucedido. Como resultado, nem todos os dados na fonte de conteúdo são reindexados. As atualizações incrementais funcionam melhor para detectar conteúdo, metadados, permissão e outras atualizações.
Observação
Atualmente, os rastreamentos incrementais não dão suporte ao processamento de atualizações para permissões.
As atualizações incrementais são muito mais rápidas do que as atualizações completas porque os itens inalterados não são processados. No entanto, se você optar por executar atualizações incrementais, ainda precisará executar atualizações completas periodicamente para manter a sincronização de dados correta entre a fonte de conteúdo e o índice de pesquisa.
Etapa 9: Examinar a conexão
Você pode examinar toda a configuração e editar as configurações conforme necessário antes de concluir a conexão. Leia as informações específicas do conector para sua fonte de dados, caso ainda não tenha feito isso. Quando estiver pronto para concluir a conexão, selecione Concluir atualização.
Etapa 10: Personalizar a página de resultados da pesquisa
Depois de publicar a conexão, você precisa personalizar a página de resultados da pesquisa com tipos de resultados e verticais. Para saber mais sobre como personalizar os resultados da pesquisa, examine como gerenciar tipos de resultados e verticais.
Etapa 11: Confirmar se a configuração da conexão funcionou
Vá para a lista de suas conexões publicadas na guia Conectores no centro de administração. Para saber como fazer atualizações e exclusões, consulte Monitorar suas conexões.
Solução de problemas
Leia as informações específicas do conector para sua fonte de dados.
Observação
Atualmente, nem todos os artigos específicos do conector incluem recomendações de solução de problemas.
Limitações
Para saber mais sobre as limitações que se aplicam a todas as fontes de dados, consulte o artigo Visão geral dos conectores do Microsoft Graph .
Consulte as informações específicas do conector para sua fonte de dados para descobrir se outras limitações se aplicam a esse conector específico do Microsoft Graph.