Gerir o esquema de pesquisa (pré-visualização)
O esquema de pesquisa determina como os seus conteúdos ingeridos através de um conector do 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 da origem 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 pesquisá-lo e como pode apresentar os resultados nos pontos finais do 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 Graph para compreender as instruções gerais de configuração dos conectores do 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 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 puder ser pesquisada, seu valor será 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*" a apresentar resultados que correspondem a este prefixo.
Uma pesquisa por "tags:design" reduz os resultados para itens com "design" na propriedade tags.
Recuperável
Se uma propriedade for recuperável, seu valor poderá ser retornado nos resultados da pesquisa. As propriedades que você deseja adicionar ao modelo de exibição ou que são retornadas da consulta e sejam relevantes para os resultados da pesquisa devem ser recuperáveis. Marcar propriedades grandes ou demais como recuperáveis aumenta a latência da pesquisa. Seja seletivo e escolha propriedades relevantes.
Um conjunto de propriedades recuperáveis (title e lastEditedBy) renderizadas como resultado.
Refinável
Se uma propriedade for refinável, um administrador poderá configurá-la como um filtro personalizado na página de resultados da Pesquisa da Microsoft. 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 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. Eles localizam aplicativos 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 você deseja mostrar na pesquisa e em outras 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 arquivo, o nome do arquivo na fonte de dados. |
| FileExtension | No caso de um arquivo, a extensão do arquivo na fonte 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 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 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 do Graph 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 de Gráficos.
- 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.
Adicionar uma nova propriedade de origem a partir da lista de propriedades suportadas pelo 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 o 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