Gerenciar verticais de pesquisa

  • Artigo
  • 8 minutos para o fim da leitura

Os verticais de pesquisa são guias na página de resultados da pesquisa que mostram os resultados de um tipo específico ou de fontes selecionadas. Por exemplo, a vertical Arquivos mostra os resultados classificados como arquivos e facilita para os usuários que estão procurando encontrar documentos. Você pode personalizar os verticais Pesquisa da Microsoft para atender às necessidades de sua organização ou departamentos individuais. Pesquisa da Microsoft tem dois tipos de verticais, fora da caixa ou verticais padrão e personalizadas. Os verticais padrão, como Todos, Arquivos e Pessoas, criam acesso fácil aos resultados de pesquisa mais usados.

Você pode gerenciar verticais em dois níveis:

  • Nível da organização – um vertical no nível da organização aparece na página de resultados da pesquisa quando os usuários pesquisam na página inicial do SharePoint, Microsoft Office e Pesquisa da Microsoft no Bing
  • Nível de site – um vertical no nível do site aparece na página de resultados da pesquisa quando os usuários pesquisam em um SharePoint site. Por exemplo, talvez você queira permitir que os funcionários do serviço de atendimento ao cliente pesquisem incidentes de Severidade 1 diretamente do site de SharePoint do departamento.

Verticais padrão

Os verticais padrão estão presentes no nível da organização em experiências como SharePoint, Microsoft Office e Pesquisa da Microsoft no Bing ou no nível do site SharePoint na página de resultados de pesquisa de cada site.

Aqui está um resumo dos recursos de personalização em verticais fora da caixa.

Tipo de personalização Nível da organização   Nível do site 
Renomear vertical   Sim Sim
Desabilitar vertical  Parcial    Sim
Adicionando uma consulta     Parcial    Sim

Verticais personalizados

Você pode adicionar verticais de pesquisa relevantes para sua organização. Por exemplo, você pode criar um vertical para conteúdo relacionado ao marketing e outro para vendas, com base no tipo de informação de que cada departamento precisa. Você pode adicionar verticais para mostrar os resultados do conteúdo indexado por Graph conectores ou de SharePoint.

Criar ou modificar os verticais de pesquisa

A experiência de gerenciamento vertical é orientada por assistente, você é guiado pelas etapas para definir o nome vertical, a fonte de conteúdo e o escopo do conteúdo a ser pesquisado. Você pode usar um conjunto limitado de linguagem de consulta de palavra-chave (KQL) para definir o escopo da pesquisa vertical para uma determinada fonte de conteúdo. Os filtros também podem ser adicionados à caixa inicial e aos verticais personalizados no nível da organização e do site. Para obter mais informações sobre filtros, consulte Gerenciar filtros.

Gerenciar verticais no nível da organização

  1. No Centro de administração do Microsoft 365, vá para a página Verticais na seção Personalização.
  2. Selecione um vertical existente e clique em Editar ou clique em Adicionar para criar um novo vertical.
  3. Depois de percorrer as etapas de configuração, você pode examinar e salvar a vertical.

Gerenciar verticais no nível do site

  1. No site SharePoint local em que você deseja gerenciar verticais, abra o painel de configurações clicando na engrenagem.
  2. Selecione Informações do site e, em seguida, selecione Exibir todas as configurações do site. 
  3. Procure a seção Pesquisa da Microsoft e, em seguida, selecione Definir configurações de pesquisa.
  4. No painel de navegação, vá para Experiência personalizada e selecione Verticais.
  5. Selecione um vertical existente e clique em Editar ou clique em Adicionar para criar um novo vertical.
  6. Depois de definir sua configuração, você pode examinar e salvar a vertical.

Exibir a vertical na página de resultados da pesquisa

Um layout de resultado de pesquisa é necessário para Graph resultados do conector a serem renderizados na página vertical da pesquisa. Ao garantir que o layout de resultado apropriado esteja presente, você pode habilitar a pesquisa vertical. Depois de habilitar ou atualizar um vertical, há um atraso de algumas horas antes de exibir as alterações na página de pesquisa. Você pode acrescentar cacheClear=true à URL SharePoint e Office exibir as alterações imediatamente. No Bing, acrescente &features=uncachedVerticals à URL vertical de trabalho para exibir as alterações imediatamente.

Observação

Os verticais adicionados não são visíveis SharePoint e Office quando exibidos em navegadores da Web móveis.

Opções de configuração avançada

Várias conexões em um vertical

Uma pesquisa vertical pode exibir resultados de várias fontes de conector. Essa opção fornece flexibilidade na criação da página de resultados da pesquisa. O processo de instalação vertical permite que os administradores selecionem várias conexões na etapa "Fonte de conteúdo".

Se você indicar com precisão o máximo possível de rótulos semânticos , essa experiência será aprimorada. Você adiciona rótulos semânticos no ponto de definição de esquema e ingestão. Veja mais sobre como criar e gerenciar rótulos semânticos. Aqui estão informações adicionais sobre como criar e gerenciar rótulos semânticos.

Observação

  • As várias conexões em um recurso vertical estão atualmente em versão prévia. Para obter mais informações, consulte a versão prévia dos recursos dos Conectores.
  • Uma conexão pode ser adicionada como uma fonte de conteúdo em uma única vertical. Você não pode usar conexões em várias verticais.

Para configurar uma consulta para uma pesquisa vertical em que várias fontes de conexão foram adicionadas, use propriedades de origem comuns para criar a consulta.

Idioma de consulta de palavra-chave (KQL)

Uma consulta pode ser adicionada a um vertical para restringir os resultados mostrados na pesquisa vertical usando a linguagem de consulta de palavra-chave (KQL) (suporte limitado). Esta página lista as propriedades disponíveis. Recomendamos que você use palavras-chave de texto livre e restrições de propriedade com operadores boolianos para criar o KQL. Não há suporte para operadores de classificação dinâmica, como XRANK, operadores de proximidade e palavras.

Aqui estão alguns exemplos de consultas.

Cenário Consulta 
Excluindo resultados de sites de arquivo morto  NOT (path:http//contoso.sharepoint.com/archive OR path:http//contoso.sharepoint.com/CompanyArchive)
Excluindo resultados com base na propriedade de tipo de arquivo NOT(FileType:htm)

Use variáveis na KQL de consulta de uma vertical para fornecer dados dinâmicos como uma entrada para a consulta de um vertical. "Perfil" e "cadeia de caracteres de consulta" são os tipos de variáveis de consulta que podem ser usadas.

Variáveis de consulta de perfil

Você pode usar variáveis de consulta de perfil para contextualizar os resultados da pesquisa para o usuário conectado. As variáveis de consulta de perfil buscam valores do perfil do usuário conectado. Por exemplo, para criar um "Tíquetes" vertical para o usuário encontrar tíquetes de suporte atribuídos a ele, você pode especificar a consulta a seguir na seção "Consulta" durante a criação vertical na página de administração.

AssignedTo:{Profile.accounts.userPrincipalName}

Isso cortará os resultados da pesquisa para mostrar apenas os itens atribuídos à pessoa que está fazendo a pesquisa.

O recurso de perfil expõe propriedades como coleções. Por exemplo, as informações relacionadas a endereços de email são expostas por meio de coleta de email, posições de trabalho como coleção de posições e assim por diante. Todas as propriedades disponíveis no perfil do usuário são expostas como variáveis de consulta.

Considere um usuário que tenha três endereços de email disponíveis na coleção de emails, conforme mostrado aqui:

"emails": [{ 

        "address": "Megan.Bowen@contoso.com",
        "id": "xyz", 
        "source": { 
            "CreatedBy": "xyz", 
            "CreatedOn": "2222", 
            "Type": "official" 
        },
        "type": "main" 
    }, { 
        "address": "meganb@hotmail.com",
        "id": "abc", 
        "source": { 
            "CreatedBy": "abc",
            "CreatedOn": "3333", 
            "Type": "non-official",
        },
        "type": "work"
    }, { 
        "address": "meganb@outlook.com",
        "id": "pqr", 
        "source": { 
            "CreatedBy": "pqr", 
            "CreatedOn": "4444", 
            "Type": "personal" 
        },
        "type": "personal" 
    } 
]

  • A consulta será MyProperty: {Profile.emails.address} resolvida para MyProperty: "Megan.Bowen@contoso.com".

  • Para resolver todos os valores do atributo de endereço, use a sintaxe de expansão de vários valores. {|MyProperty:{Profile.emails.address}} A consulta será resolvida como ((MyProperty:"Megan.Bowen@contoso.com") OR (MyProperty: "meganb@hotmail.com") OR (MyProperty:"meganb@outlook.com"))).

Use o operador "|" para resolver variáveis de vários valores. Consulte a tabela a seguir para obter mais exemplos de expansão de perfil.

# Sintaxe Valor retornado
1 MyProperty:{Profile.emails.address} "Megan.Bowen@contoso.com"
2 MyProperty:{Profile.emails} {Profile.emails} Isso não será resolvido porque os emails são um objeto.
3 {? MyProperty:{Profile.emails}} Isso não será resolvido porque os emails são um objeto. O "?" O operador ignora variáveis de consulta que não são resolvidas. Essa variável será removida quando passada mais para baixo na pilha de consultas.
4 {|MyProperty: {Profile.emails.source.Type}} ((MyProperty:"official") OR (MyProperty:"non-official") OR (MyProperty:"personal"))

Variáveis de cadeia de caracteres de consulta

As variáveis de cadeia de caracteres de consulta permitem que você personalize os resultados da pesquisa com base em como os usuários interagem com SharePoint sites. Isso é feito adicionando pares chave-valor à URL de pesquisa. Por exemplo, suponha que você tenha um site SharePoint que fornece informações sobre um projeto com uma Web Part simples que mostra tarefas em andamento. Clicando na Web Part "Em andamento", vincula os usuários à pesquisa vertical "Itens de trabalho", em que os resultados são refinados para mostrar apenas os itens marcados como InProgress.

Isso pode ser feito especificando a consulta a seguir na seção "Consulta" durante a criação vertical na página de administração.

Status:{QueryString.state}

A URL na Web Part do botão do site do SharePoint precisa ser atualizada para passar o seguinte par de valores de chave https://{seu-domínio}.sharepoint.com/sites/{nome-do-site}/_layouts/15/search.aspx/{vertical-ID}?state=InProgress

O status da consulta:{QueryString.state} será resolvido para status:InProgress.

Aqui estão mais exemplos de expansão de cadeia de caracteres de consulta.

# Sintaxe da consulta Sintaxe de URL Valor retornado
1 MyProperty:{QueryString.state} https://{your-domain}.sharepoint.com/sites/{site-name}/_layouts/15/search.aspx/{vertical-ID}?state=InProgress MyProperty:InProgress
2 MyProperty:{QueryString.state} OR MyProperty:{QueryString.priority} https://{your-domain}.sharepoint.com/sites/{site-name}/_layouts/15/search.aspx/{vertical-ID}?state=InProgress&priority=1 MyProperty:InProgress OR MyProperty:1
3 {? MyProperty:{QueryString.state}} https://{your-domain}.sharepoint.com/sites/{site-name}/_layouts/15/search.aspx/{vertical-ID}? State=InProgress Aqui, o estado não será resolvido porque QueryStrings diferencia maiúsculas de minúsculas. O "?" O operador ignora variáveis de consulta que não são resolvidas. Essa variável será removida quando passada mais para baixo na pilha de consultas.
4 {|MyProperty: {QueryString.state}} https://{your-domain}.sharepoint.com/sites/{site-name}/_layouts/15/search.aspx/{vertical-ID}?state=InProgress,Closed (MyProperty:InProgress) OR (MyProperty:Closed)
O | operador é usado para resolver variáveis muti-value. Os valores das variáveis devem ser passados usando o separador de vírgula, conforme mostrado na sintaxe da URL.
5 {MyProperty: {QueryString.state}} https://{your-domain}.sharepoint.com/sites/{site-name}/_layouts/15/search.aspx/{vertical-ID}?state=InProgress,Closed MyProperty:InProgress
Aqui, apenas o primeiro valor de estado é retirado da URL, pois a sintaxe da consulta não o define como uma variável de vários valores.

Limitações

  • A localização de idioma não é aplicável a nomes de verticais fora de caixa depois de modificados.
  • Os verticais personalizados não aparecem na exibição móvel Pesquisa da Microsoft.
  • Não há suporte para a adição de consulta na vertical Pessoas.
  • Modificação vertical e novas verticais não são visíveis para usuários convidados em uma organização.
  • Não há suporte para a reorordagem vertical.
  • Não há suporte para a renomeação vertical para a guia Todos Pesquisa da Microsoft no Bing.
  • As variáveis de cadeia de caracteres de consulta só podem ser usadas SharePoint sites.

Solução de problemas

Aqui está uma lista de problemas comuns que você pode encontrar e ações para corrigi-los.

Problema Action
Vejo uma mensagem de erro "Algo deu errado" na vertical. Os tipos vertical e de resultado são necessários para concluir a configuração. Verifique se ambos estão configurados para a fonte de conteúdo.
Não vejo nenhuma fonte de conteúdo na página vertical. Verifique se você configurou conectores e dados indexados.