Gerir o esquema de pesquisa (pré-visualização)
O esquema de pesquisa determina a forma como os seus conteúdos ingeridos através de um conector do Microsoft Graph são utilizados em várias experiências do Microsoft Graph. O esquema define a estrutura de como os conteúdos são recolhidos a partir de origens de dados, indexados, consultados e obtidos a partir do índice de pesquisa. Ao alterar o esquema de pesquisa, pode controlar o que os utilizadores podem procurar, como os utilizadores podem procurá-lo e como pode apresentar os resultados nos pontos finais da Microsoft Search.
O esquema de pesquisa contém propriedades pesquisadas, atributos de pesquisa, etiquetas semânticas e aliases. As secções seguintes definirão os vários constituintes das capacidades de gestão e esquema fornecidas.
Observação
Leia o artigo Configurar o conector do Microsoft Graph para compreender as instruções gerais de configuração dos conectores do Microsoft Graph. Os passos 6 e 7 definem o esquema ao configurar uma nova ligação.
Observação
Se quiser modificar o esquema de pesquisa do SharePoint Online, leia Gerir o esquema de pesquisa no SharePoint.
Propriedades rastreadas
Para construir o índice de pesquisa, você deve rastrear o conteúdo primeiro. Pode pesquisar várias origens de conteúdo, conforme listado na galeria de conectores. Os conteúdos e metadados dos itens que pesquisa são representados como propriedades pesquisadas (ou propriedades de origem).
Por exemplo, a tabela seguinte apresenta propriedades pesquisadas de exemplo para um conector de sistema de pedidos de trabalho.
Propriedade | Tipo |
---|---|
ticketId | Cadeia de caracteres |
title | Cadeia de caracteres |
createdBy | Cadeia de caracteres |
assignedTo | Cadeia de caracteres |
lastEditedDate | DateTime |
lastEditedBy | Cadeia de caracteres |
workItemType | Cadeia de caracteres |
prioridade | Int64 |
categorias | StringCollection |
status | Cadeia de caracteres |
url | Cadeia de caracteres |
resolvido | Booliano |
Observação
- Para conectores criados pela Microsoft, as propriedades pesquisadas estão selecionadas no passo 4 do artigo Configurar o conector do Microsoft Graph .
Procurar atributos
Propriedade content
Esta propriedade é utilizada para indexação de texto completo de conteúdo, geração de fragmentos de página de resultados de pesquisa, participação do cluster de resultados , deteção de idioma, suporte html/texto, classificação e relevância e formulação de consultas.
Se selecionar uma propriedade de conteúdo, terá a opção de utilizar a propriedade gerada pelo sistema ResultSnippet quando criar o tipo de resultado. Esta propriedade serve como um marcador de posição para os fragmentos dinâmicos que são gerados a partir da propriedade content no momento da consulta. Se utilizar esta propriedade no tipo de resultado, os fragmentos são gerados nos resultados da pesquisa.
Pesquisável
Se uma propriedade for pesquisável, o respetivo valor é adicionado ao índice de texto completo. Quando um usuário realiza uma pesquisa, retornamos resultados se houver uma ocorrência de pesquisa em um dos campos pesquisáveis ou seu conteúdo.
Uma pesquisa por "design" exibindo resultados de ocorrências contra a propriedade (title
) e conteúdo.
Consultável
Se uma propriedade é consultável, você pode consultá-la usando a linguagem de consulta de conhecimento (KQL). KQL consiste em uma ou mais palavras-chave de texto livre (palavras ou frases) ou restrições de propriedade. O nome da propriedade deve ser incluído na consulta, sendo especificado diretamente na consulta ou incluído de maneira programática. Você pode usar a correspondência de prefixo com o operador de caractere curinga(*).
Observação
Não há suporte para correspondência de sufixo.
Uma pesquisa por "search ba*" exibindo resultados que correspondem a esse prefixo.
Uma pesquisa de "tags:design" a analisar os resultados em itens com "design" na tags
propriedade.
Recuperável
Se uma propriedade for recuperável, seu valor poderá ser retornado nos resultados da pesquisa. Qualquer propriedade que pretenda adicionar ao modelo de apresentação ou ser devolvida da consulta e ser relevante nos resultados da pesquisa tem de ser recuperável. Marcar propriedades grandes ou demais como recuperáveis aumenta a latência da pesquisa. Tenha cuidado ao escolher as propriedades certas.
Como resultado, é composto um conjunto de propriedades recuperáveis (title
e lastEditedBy
).
Refinável
Observação
As propriedades do tipo de dados "int" não podem ser refinadas, mesmo que sejam marcadas como refináveis.
Se uma propriedade for refinável, um administrador pode configurá-la como um filtro personalizado na página de resultados do Microsoft Search. Uma refinable
propriedade não pode ser searchable
.
Refinar resultados por tags
, uma propriedade refináveis.
Observação
- Para conectores criados pela Microsoft, os atributos de pesquisa estão selecionados no passo 7 do artigo Configurar o conector do Microsoft Graph .
Rótulos semânticos
Um rótulo semântico é uma marca conhecida publicada pela Microsoft que você pode adicionar em relação a uma propriedade em seu esquema. Adicionar um rótulo semântico ajuda vários produtos da Microsoft a entender a propriedade e fornecer uma experiência melhor.
Os rótulos semânticos fornecem uma abordagem independente de domínio para atribuir propriedades de diferentes domínios de conteúdo a um conjunto de classes conhecidas. Encontram aplicações em muitas experiências de conteúdo diferentes e fornecem suporte automatizado para tarefas como:
- Integração de dados em experiências heterogêneas
- Criar gráficos de conhecimentos comuns (por exemplo, Topics)
- Modelos padrão para experiências do usuário
Os rótulos fornecem significado semântico e permitem que você integre seus dados de conector às experiências do Microsoft 365.
Rótulo | Descrição |
---|---|
title | O título do item que pretende que seja apresentado na pesquisa e noutras experiências. |
url | A URL de destino do item na fonte de dados. |
createdBy | O nome da pessoa que criou o item na fonte de dados. |
lastModifiedBy | O nome da pessoa que editou mais recentemente o item na fonte de dados. |
autores | Os nomes de todas as pessoas que participaram/colaboraram no item na fonte de dados. |
createdDateTime | A data e hora em que o item foi criado na fonte de dados. |
lastModifiedDateTime | A data e hora em que o item foi modificado pela última vez na fonte de dados. |
fileName | No caso de um ficheiro, o nome do ficheiro na origem de dados. |
FileExtension | No caso de um ficheiro, a extensão do ficheiro encontra-se na origem de dados. |
iconUrl | A URL de um ícone. |
Por exemplo, a propriedade pesquisada lastEditedBy tem o mesmo significado que a etiqueta da Microsoft lastModifiedBy.
Importante
Todas as propriedades que você mapeia para rótulos devem ser recuperáveis.
O rótulo título é o rótulo mais importante. Certifique-se de atribuir uma propriedade a esse rótulo para permitir que sua conexão participe da experiência do cluster de resultados. O mapeamento incorreto de rótulos prejudica a experiência de pesquisa. Não há problema em alguns rótulos não terem uma propriedade atribuída a eles.
Observação
- Para conectores criados pela Microsoft, as etiquetas semânticas estão selecionadas no passo 6 do artigo Configurar o conector do Microsoft Graph .
Aliases
Os aliases são nomes amigáveis para as propriedades que você atribuir. Eles são usados em consultas e seleções em filtros de propriedades refináveis.
Observação
- Para conectores criados pela Microsoft, os aliases são definidos no passo 7 do artigo Configurar o conector do Microsoft Graph .
Recursos de atualização de esquema
Esta secção inclui informações sobre as capacidades de atualização para o esquema de pesquisa dos conectores criados pela Microsoft.
Observação
Recomendamos que execute uma pesquisa completa após uma atualização para colocá-las no esquema mais recente. Sem uma pesquisa completa, o comportamento dos itens será inconsistente.
Gerenciar esquema
- Na Centro de administração do Microsoft 365, aceda à página Esquema na secção Personalização.
- Clique em Ver detalhes em Esquema de conectores do Microsoft Graph.
- Selecione a ligação para a qual pretende atualizar o esquema e clique em Personalizar esquema.
- Depois de fazer as alterações de esquema necessárias, clique em Publicar alterações de esquema para publicar o novo esquema.
Adicionar uma propriedade pesquisada
Pode adicionar uma propriedade ao esquema. Ao adicionar uma propriedade, você pode incluir todos os atributos de pesquisa necessários.
Adicione uma nova propriedade de origem a partir da lista de propriedades suportadas por conector.
Importante
Não é possível eliminar uma propriedade existente para uma ligação publicada. Para remover uma propriedade, tem de eliminar e recriar uma ligação.
Adicionar/remover um recurso de pesquisa
Pode adicionar ou remover atributos de pesquisa específicos a uma propriedade. Adicionar uma capacidade de pesquisa requer uma pesquisa completa.
Atualizar as anotações de pesquisa para propriedades pesquisadas
Importante
- Não é possível remover um atributo de pesquisa recuperável de uma propriedade.
- Não pode adicionar ou remover um atributo de pesquisa refinável a uma propriedade.
Adicionar/remover um rótulo semântico
Pode adicionar ou atualizar o mapeamento de etiquetas semânticas das propriedades pesquisadas.
Atualizar etiquetas semânticas para propriedades pesquisadas
Adicionar/remover um alias
Você pode adicionar ou remover aliases e usá-los para suas consultas de pesquisa.
Adicionar ou remover um alias para propriedades pesquisadas