Gerenciar verticais de pesquisa

  • Artigo

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

Você pode gerenciar verticais em dois níveis:

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

Verticais padrão

Verticais padrão estão presentes no nível da organização em experiências como SharePoint, Microsoft Office e Microsoft Search no Bing ou no nível do site do 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 personalizadas

Você pode adicionar verticais de pesquisa na experiência de pesquisa em organização ou pesquisa no nível do site para obter conteúdo dos conectores do Graph ou do SharePoint. Verticais personalizadas para conteúdo do SharePoint mostrarão resultados do respectivo escopo, semelhantes às outras verticais nesse escopo. Por exemplo, uma vertical personalizada no escopo da Organização mostrará todos os resultados, enquanto uma vertical personalizada com conteúdo do SharePoint no site de Marketing mostrará dados desse site. O mesmo vale para sites de hub em que o mesmo escopo do hub será aplicado. 

Criar ou modificar verticais de pesquisa

A experiência de gerenciamento vertical é orientada pelo assistente, você é guiado por etapas para definir o nome da vertical, a fonte de conteúdo e o escopo do conteúdo a ser pesquisado. Você pode usar um conjunto limitado de KQL (Linguagem de Consulta de Palavra-Chave) para definir o escopo da pesquisa vertical de uma determinada fonte de conteúdo. Os filtros também podem ser adicionados a verticais personalizadas e fora da caixa 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 uma vertical existente e clique em editar ou clique em adicionar para criar uma nova vertical.
  3. Depois de passar pelas etapas de configuração, você pode examinar e salvar a vertical.

Gerenciar verticais no nível do site

  1. No site do SharePoint em que você deseja gerenciar verticais, abra o painel de configurações clicando na engrenagem.
  2. Selecione Informações do site e selecione Exibir todas as configurações do site. 
  3. Procure a seção Pesquisa da Microsoft e selecione Configurar configurações de pesquisa.
  4. No painel de navegação, acesse Experiência personalizada e selecione Verticais.
  5. Selecione uma vertical existente e clique em editar ou clique em adicionar para criar uma nova 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 da pesquisa é necessário para que os resultados do conector do Graph sejam renderizados na página vertical de pesquisa. Ao garantir que o layout de resultado apropriado esteja presente, você pode habilitar a pesquisa vertical. Depois de habilitar ou atualizar uma vertical, haverá um atraso de algumas horas para que você possa exibir as alterações na página de pesquisa. Você pode adicionar cacheClear=true à URL no SharePoint e no Office para exibir as alterações imediatamente. No Bing, anexe &features=uncachedVerticals à URL vertical de trabalho para exibir as alterações imediatamente.

Observação

Verticais adicionadas não são visíveis no SharePoint e no Office quando exibidas de navegadores da Web móveis.

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

Várias conexões em uma vertical

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

Se você nomear com precisão o maior número possível de rótulos semânticos , essa experiência será aprimorada. Você adiciona rótulos semânticos no ponto de definição e ingestão de esquema. Confira 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

  • 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 vertical de pesquisa em que várias fontes de conexão foram adicionadas, use propriedades comuns de origem para criar a consulta.

Idioma de consulta de palavra-chave (KQL)

Uma consulta pode ser adicionada a uma vertical para restringir os resultados mostrados na vertical de pesquisa usando kQL (linguagem de consulta de palavra-chave) (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. Operadores de classificação dinâmica como XRANK, operadores de proximidade e palavras não têm suporte.

Aqui estão algumas consultas de exemplo.

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

Use variáveis na seção de consulta KQL de uma vertical para fornecer dados dinâmicos como uma entrada para a consulta de uma 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 uma vertical "Tickets" para o usuário encontrar tíquetes de suporte atribuídos a eles, 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 itens atribuídos à pessoa que está fazendo a pesquisa.

O recurso de perfil expõe propriedades como coleções. Por exemplo, informações relacionadas a endereços de email são expostas por meio da coleção de email, posições de trabalho como coleção de posições e assim por diante. Todas as propriedades disponíveis no perfil de 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 email, 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 MyProperty: {Profile.emails.address} resolve ao MyProperty: "Megan.Bowen@contoso.com".

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

Use o operador "|" para resolve 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 resolve porque os emails são um objeto.
3 {? MyProperty:{Profile.emails}} Isso não resolve porque emails são um objeto. O "?" O operador ignora variáveis de consulta que não resolve. Essa variável será removida quando passada mais para baixo na pilha de consultas.
4 {|MyProperty: {Profile.emails.source.Type}} ((MyProperty:"oficial") OR (MyProperty:"nonofficial") OR (MyProperty:"personal"))

Variáveis cadeia de caracteres de consulta

As variáveis cadeia de caracteres de consulta permitem personalizar os resultados da pesquisa com base em como os usuários interagem com sites do SharePoint. Isso é feito adicionando pares de valor-chave à URL de pesquisa. Por exemplo, suponha que você tenha um site do SharePoint que forneça 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 à vertical de pesquisa "Itens de trabalho", em que os resultados são refinados para mostrar apenas 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 par de valores de chave a seguir https://{your-domain}.sharepoint.com/sites/{site-name}/_layouts/15/search.aspx/{vertical-ID}?state=InProgress

A consulta status:{QueryString.state} resolve para status:InProgress.

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

# Sintaxe de 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 resolve porque QueryStrings são sensíveis a casos. O "?" O operador ignora variáveis de consulta que não resolve. 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 | o operador é usado para resolve variáveis muti-value. Os valores das variáveis devem ser passados usando o separador de vírgula, conforme mostrado na sintaxe de 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 do estado é recolhido da URL, pois a sintaxe de consulta não o define como uma variável de vários valores.

Limitações

  • A localização do idioma não é aplicável a nomes de verticais fora da caixa depois de modificadas.
  • Verticais personalizadas não aparecem na exibição móvel do Microsoft Search.
  • Não há suporte para adicionar consulta no Pessoas vertical.
  • Modificações verticais e novas verticais não estão visíveis para usuários convidados em uma organização.
  • Não há suporte para reordenação vertical.
  • Não há suporte para renomeação vertical para Todas as guias na Pesquisa da Microsoft no Bing.
  • As variáveis de cadeia de caracteres de consulta só podem ser usadas em sites do SharePoint.

Solução de problemas

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

Problema Ação
Vejo uma mensagem de erro "Algo deu errado" na vertical. Os tipos verticais e de resultado são necessários para concluir a instalação. Verifique se ambos estão configuradas 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.