Pesquisar soluções para o SharePoint

Artigo
04/08/2023

A pesquisa no SharePoint combina facilidade de configuração e implantação com a escalabilidade e extensibilidade do servidor FAST Search em uma única plataforma de pesquisa corporativa.

O SharePoint inclui padrões comuns na plataforma de pesquisa para ajudar você a personalizar a pesquisa em diferentes cenários. Por exemplo:

A pesquisa de vídeo e a pesquisa de conversas são incluídas como verticais de pesquisa fora da caixa.
Páginas de tópico e Conteúdo por Pesquisa aprimoram os recursos e cenários de gerenciamento de conteúdo da Web, como sites controlados por pesquisa e sites de gerenciamento de conhecimento.
Minhas tarefas reúnem tarefas de projeto para que os usuários possam acompanhar tarefas atribuídas em vários sites em um local central: seu OneDrive for Business site.

Arquitetura de pesquisa do SharePoint

A arquitetura de pesquisa no SharePoint inclui componentes e bancos de dados que funcionam juntos.

Pesquisar componentes no SharePoint

Componente	Descrição
Rastreamento	Rastreia fontes de conteúdo para coletar propriedades e metadados e envia essas informações para o componente de processamento de conteúdo.
Processamento de conteúdo	Transforma os itens rastreados e os envia ao componente de índice. Esse componente também mapeia propriedades rastreadas para propriedades gerenciadas.
Processamento de análise	Realiza análises de pesquisa e análise de uso.
Índice	Recebe os itens processados do componente de processamento de conteúdo e os grava no índice de pesquisa. Esse componente também trata de consultas de entrada, recupera as informações do índice de pesquisa e envia o resultado definido como o componente de processamento de consulta de volta.
Processamento de consulta	Analisa as consultas de entrada. Isso ajuda a otimizar a precisão, o recall e a relevância. As consultas são enviadas ao componente de índice, que retorna um conjunto de resultados de pesquisa para a consulta.
Administração de pesquisa	Executa os processos do sistema para pesquisa e adiciona e inicializa novas instâncias de componentes de pesquisa.

Pesquisar bancos de dados no SharePoint

Banco de dados	Descrição
Rastreamento	Armazena informações de rastreamento e informações de histórico sobre itens rastreados, como documentos e URLs. Ele também armazena informações como a última hora de rastreamento, a última ID de rastreamento e o tipo de atualização (adicionar, atualizar, excluir) durante o último rastreamento.
Link	Armazena informações não processadas que são extraídas pelo componente de processamento de conteúdo, bem como as informações sobre os cliques de pesquisa. O componente de processamento de análise analisa essas informações.
Relatórios de análise	Armazena os resultados de análise de uso.
Administração de pesquisa	Armazena os dados de configuração de pesquisa.

Rastreamento e processamento de conteúdo

O processo de rastreamento começa com as diferentes fontes de conteúdo (por exemplo, HTTP, compartilhamentos de arquivos e SharePoint). Para que o conteúdo seja adicionado ao índice, o rastreador usa conectores que informam ao rastreador como se conectar à fonte de conteúdo e acessar os itens de conteúdo na origem. Depois que o rastreador encontrar os itens de conteúdo, ele usa um manipulador de formato aplicável para analisar o conteúdo.

Depois de recuperar o conteúdo, o componente de rastreamento passa itens rastreados para o componente de processamento de conteúdo, que processa os itens e os envia para o componente de índice. Isso inclui análise de documentos, mapeamento de propriedades rastreadas para suas propriedades gerenciadas associadas e processamento linguístico, como detecção de idioma e extração de entidade. O componente de processamento de conteúdo também grava informações sobre links e URLs no banco de dados de link.

Processamento de consulta

O componente de processamento de consulta analisa e processa consultas de pesquisa para otimizar a precisão, o recall e a relevância, incluindo a execução do processamento linguístico, como quebra de palavras e contenção. A consulta processada é então enviada ao componente de índice, que retorna um conjunto de resultados com base na consulta processada para o componente de processamento de consulta, que por sua vez processa o conjunto de resultados.

Análise de pesquisa

O SharePoint analisa o conteúdo em si (análise de pesquisa) e também a maneira como os usuários interagem com ele (análise de uso) e usa essas informações para melhorar a pesquisa.

A análise de pesquisa diz respeito à extração de informações, como links, o número de vezes que um item é clicado, texto âncora, dados relacionados a pessoas e metadados, do banco de dados de links. A análise de pesquisa forma a base para determinar a relevância.

A análise de uso, por outro lado, trata-se de analisar as informações de log de uso recebidas do front-end por meio do repositório de eventos. A análise de uso forma a base de relatórios de uso e estatísticas.

Os resultados das análises são adicionados aos itens no índice de pesquisa. Além disso, os resultados da análise de uso são armazenados no banco de dados de relatórios de análise.

Criar blocos para personalizar a experiência de pesquisa

A pesquisa no SharePoint e no SharePoint Online inclui novas funcionalidades e melhorias que permitem personalizar a experiência de pesquisa. Muitas das melhorias não exigem que você escreva código. A pesquisa do SharePoint inclui APIs CSOM e REST para ajudar quando você precisar escrever código para sua personalização ou se quiser criar suplementos para acessar os resultados da pesquisa do SharePoint fora do SharePoint.

As novas funcionalidades e melhorias incluem o seguinte:

Site do Centro de Pesquisa
Web Parts do Search Center
Fontes de resultado
Regras da consulta
Transformações de consulta
Tipos de resultado e modelos de exibição

Site do Centro de Pesquisa

O Centro de Pesquisa é um site do SharePoint configurado para pesquisa. É um portal em que você pode pesquisar conteúdo na intranet da sua organização e fornece uma interface de usuário centralizada e altamente personalizável. Esta seção descreve as páginas e web parts do Centro de Pesquisa, juntamente com as configurações de configuração de pesquisa que você pode modificar para criar aplicativos de pesquisa personalizados ou experiências de pesquisa sem escrever muito código.

Ao criar um site do Search Center, o SharePoint cria uma página inicial de pesquisa padrão e uma página de resultados de pesquisa padrão. Além disso, várias páginas conhecidas como pesquisas verticais também são criadas. Verticais de pesquisa são páginas de resultados de pesquisa personalizadas para pesquisar tipos de conteúdo específicos, como Pessoas e Vídeos, e exibem resultados de pesquisa filtrados e formatados para um tipo de conteúdo ou classe específico.

As páginas a seguir são criadas em um conjunto de sites do Centro de Pesquisa, na biblioteca Páginas:

default.aspx – a home page do Centro de Pesquisa e a página em que os usuários finais inserem suas consultas.
results.aspx – A página de resultados de pesquisa padrão para o Centro de Pesquisa. Ela também é a página de resultados da pesquisa vertical Tudo.
peopleresults.aspx – A página de resultados da pesquisa para a vertical de pesquisa Pessoas.
conversationresults.aspx – A página de resultados da pesquisa para a vertical pesquisa conversas .
videoresults.aspx – A página de resultados da pesquisa para a vertical de pesquisa de vídeos .
advanced.aspx – A página de pesquisa em que os usuários finais podem aplicar restrições às suas frases de pesquisa, por exemplo, limitando a pesquisa a uma frase exata.

Todas as páginas verticais de pesquisa contêm a Web Part de Resultados de Pesquisa, embora a Web Part esteja configurada de forma diferente para cada vertical de pesquisa. Para cada uma delas, a consulta na Web Part de Resultados de Pesquisa é direcionada para uma fonte de resultado específica, aplicável a essa vertical de pesquisa. Por exemplo, a consulta na web part resultados da pesquisa na página peopleresults.aspx é limitada à fonte de resultados de resultados do Local Pessoas. Entender como as verticais de pesquisa padrão no SharePoint estão configuradas pode ajudá-lo a criar sua própria pesquisa vertical ou personalizar o Centro de Pesquisa.

Veja a seguir recursos adicionais para ajudá-lo a trabalhar com o Centro de Pesquisa:

Web Parts do Search Center

As páginas do Centro de Pesquisa contêm quatro tipos de web parts: Caixa de Pesquisa, Resultados da Pesquisa, Navegação de Pesquisa e Refinamento.

A Web Part da Caixa de Pesquisa mostra uma caixa de texto em que os usuários inserem texto no qual pesquisar. Por padrão, a Web Part do Search Box é usada na home page do Search Center (default.aspx), bem como em todas as páginas de resultados de pesquisa padrão (results.aspx, peopleresults.aspx, conversationresults.aspx e videoresults.aspx).

Você pode personalizar a Web Part do Search Box editando propriedades no painel de ferramentas da Web Part. Isso permite que você faça o seguinte:

Altere onde os resultados da pesquisa são exibidos. Por exemplo, você pode mostrar resultados em uma Web Part de Resultados de Pesquisa personalizada ou em uma página de resultados de pesquisa personalizada.
Desativar as sugestões de consultas e as sugestões de pessoas.
Mostrar links para uma página de preferência de pesquisa e uma página de pesquisa avançada.
Altere o modelo de exibição da Web Part.

Para saber mais, veja:

Web Part de Resultados de Pesquisa

A Web Part de Resultados da Pesquisa exibe os resultados de uma consulta de pesquisa. Por padrão, a Web Part de Resultados de Pesquisa é usada em todas as páginas verticais de pesquisa padrão (results.aspx, peopleresults.aspx, conversationresults.aspx e videoresults.aspx). A Web Part de Resultados da Pesquisa também envia os resultados da pesquisa para a Web Part de Refinamento e a Web Part de Navegação de Pesquisa, portanto, deve haver uma Web Part de Resultados de Pesquisa em uma página de resultados de pesquisa para que as outras web parts de pesquisa funcionem.

Você pode editar as propriedades da Web Part de Resultados da Pesquisa no painel de ferramentas da Web Part para alterar a consulta de pesquisa, bem como alterar o comportamento e a aparência dos resultados na página de resultados da pesquisa.

Alterando os valores da propriedade, você pode fazer o seguinte:

Altere a fonte de resultado para especificar qual conteúdo deve ser pesquisado.
Adicione variáveis de consulta ou filtros de propriedade para personalizar os resultados da pesquisa para diferentes usuários ou grupos de usuários.
Promover ou rebaixar itens ou páginas nos resultados da pesquisa.
Alterar a classificação dos resultados da pesquisa.
Alterar o modelo de exibição.

Para obter mais informações sobre as Web Parts de Resultados de Pesquisa, confira:

A Web Part de Navegação de Pesquisa mostra links que permitem que os usuários se movam rapidamente entre as diferentes verticais de pesquisa (Tudo, Pessoas, Conversas e Vídeos). A Web Part de Navegação de Pesquisa usa os resultados da pesquisa da Web Part de Resultados da Pesquisa para que, quando os usuários escolhem um link vertical de pesquisa, os resultados da pesquisa sejam filtrados e exibidos de acordo com a forma como a vertical de pesquisa é configurada.

Ao editar as propriedades da Web Part de Navegação de Pesquisa no painel de ferramentas da Web Part, você pode personalizar a Web Part da seguinte maneira:

Especifique uma Web Part diferente da qual obter os resultados.
Altere o número de links verticais de pesquisa a serem exibidos.
Altere a aparência e o layout da Web Part.

Além disso, na faixa de opções, você pode selecionar Configurações do Site Configurações> de Pesquisa para fazer asseguintes alterações:

Altere os nomes de exibição do link.
Alterar a ordem dos links.

A Web Part de Refinamento filtra os resultados da pesquisa em categorias chamadas refinarias. Os usuários podem escolher esses refinadores para restringir os resultados da pesquisa. As refinarias são propriedades gerenciadas marcadas como Refináveis e Queryable. Para obter informações sobre essas configurações, consulte a visão geral das configurações de propriedade gerenciada em Visão geral do esquema de pesquisa no SharePoint Server.

Você pode editar as propriedades da Web Part do Refinamento no painel de ferramentas da Web Part para especificar o seguinte:

Qual Web Part de Resultados de Pesquisa para filtrar os resultados da pesquisa.
Os refinadores a serem usados na Web Part de Refinamento.
O modelo de exibição que é aplicado a cada refinador.
A aparência, o layout e o comportamento da Web Part do Refinamento.

Por padrão, a Web Part de Refinamento não mostra o número de resultados para cada valor de refinador. Você pode adicionar contagens de refinaria modificando o modelo de exibição do refinador.

Para obter mais informações sobre esse recurso, consulte Configurar propriedades da Web Part de Refinamento no SharePoint Server.

Para obter mais informações sobre a Web Part de Refinamento e refinarias, confira:

Fontes de resultado

Fontes de resultados limitam as pesquisas a um determinado conteúdo ou a um subconjunto de resultados da pesquisa. Você pode definir uma fonte de resultado especificando o seguinte:

Um provedor de pesquisa ou URL de origem para obter os resultados da pesquisa; por exemplo, o índice de pesquisa do sharepoint local serviço Pesquisa.
Um protocolo a ser usado para obter resultados de pesquisa; por exemplo, o protocolo OpenSearch .
Uma transformação de consulta, que pode restringir os resultados do provedor de pesquisa ou URL determinado para um subconjunto específico de resultados; por exemplo, para um conjunto de resultados que tem um tipo de conteúdo específico.

O SharePoint fornece dezesseis fontes de resultado pré-configuradas, incluindo resultados, conversas e itens do SharePoint local relacionados ao usuário atual. Você pode exibir detalhes sobre fontes de resultado na página Gerenciar Fontes de Resultado (Fontes deResultado dePesquisa>de Configurações> do Site).

Na página Gerenciar Fontes de Resultado , você pode criar novas fontes de resultado de qualquer uma das duas seguintes maneiras:

Escolha Nova Fonte de Resultado e selecione a fonte de resultado desejada. Para saber mais, confira Configurar as fontes de resultado para pesquisa no SharePoint Server.
Aponte para a seta ao lado de uma fonte de resultado existente, escolha Copiar e modifique a cópia conforme necessário e salve-a com um novo nome.

Uma fonte de resultado especifica um dos quatro protocolos para obter os resultados da pesquisa. Se a fonte de resultado usar um protocolo diferente do SharePoint Local, a fonte de resultado também deverá especificar uma URL da qual obter resultados de pesquisa.

Protocolos de origem de resultado e seus provedores

Protocolo de origem do resultado	Provedor	URL
SharePoint Local	O índice de pesquisa do serviço Pesquisa local.	N/D
SharePoint Remoto	O índice de pesquisa de um serviço Pesquisa hospedado em outro farm.	O endereço da coleção de sites raiz do farm remoto do SharePoint.
OpenSearch 1.0/1.1	Um provedor de pesquisa externo (como um mecanismo de pesquisa remoto ou feed) que usa o protocolo OpenSearch para fornecer resultados de pesquisa.	A URL do feed RSS de um provedor de pesquisa que usa o protocolo OpenSearch.
Exchange	EWS (Exchange Web Services).	Uma URL do EWS.

Para obter mais informações, confira o seguinte:

Regras da consulta

Use regras de consulta para personalizar a experiência de pesquisa para consultas particularmente importantes para seus usuários. Em uma regra de consulta, você especifica o contexto, as condições e as ações correlacionadas. Em seguida, no contexto especificado e quando uma consulta atende às condições especificadas, a pesquisa executa suas ações correlacionadas para melhorar a relevância dos resultados da pesquisa.

Em relação ao contexto, você pode restringir consultas de regra de consulta que são:

Executado em uma fonte de resultado especificada.
De uma categoria de tópico especificada.
Executado por um usuário que corresponde a um segmento de usuário especificado.

A tabela a seguir lista as condições que você pode especificar que fazem com que uma regra de consulta seja executada.

Condições da regra de consulta

Condition	Descrição
Consulta corresponde à palavra-chave exatamente	Aplicar a regra de consulta quando a consulta coincidir exatamente com uma palavra ou frase que você especificar.
Consulta contém termo da ação	Aplicar a regra de consulta quando a consulta contiver um termo na forma de uma única palavra ou frase que indica algo que a pessoa está tentando fazer. O termo deve estar no começo ou final da consulta e pode ser um verbo, comando ou filtro.
Consulta corresponde ao dicionário exatamente	Aplicar a regra de consulta quando a consulta coincidir exatamente com a entrada do dicionário. Essa entrada pode ser um termo no repositório de termos ou uma entrada no dicionário de nomes de pessoas.
Consulta mais comum na fonte	Aplicar a regra de consulta se a consulta do usuário for mais comumente realizada do que uma fonte de resultados diferente do que a atual. Essa condição usa uma análise das consultas que os usuários inserem nas diversas fontes de resultados.
Tipo de resultado comumente clicado	Aplique a regra de consulta se a consulta geralmente terminar em usuários escolhendo resultados de um tipo de resultado específico. Ao criar um novo tipo de resultado, você pode indicar que essas seleções devem ser gravadas para serem usadas em regras de consulta.
Correspondência de texto de consulta avançada	Aplicar a regra de consulta se a consulta corresponder a uma expressão regular. Ele também permite que você use variações das condições de palavra-chave, termo de ação e dicionário explicadas anteriormente, mas com controle mais avançado.

Uma regra de consulta pode especificar três tipos de ações:

Adicione resultados promovidos (anteriormente chamados de Melhores Apostas) que aparecem acima dos resultados classificados. Por exemplo, para a licença médica de consulta, uma regra de consulta pode especificar um resultado promovido específico, como um link para um site que tem uma instrução da política da empresa sobre o tempo de folga do trabalho.
Adicione um ou mais grupos de resultados, chamados blocos de resultados. Um bloco de resultados contém um pequeno subconjunto de resultados relacionados a uma consulta de uma maneira específica. Como resultados individuais, você pode promover um bloco de resultados ou classificá-lo com outros resultados de pesquisa.
Altere a classificação dos resultados alterando a consulta. Por exemplo, para uma consulta que contém a caixa de ferramentas de download, uma regra de consulta pode reconhecer o download da palavra como um termo de ação e aumentar os resultados da pesquisa que apontam para um determinado site de download em sua intranet.

Para obter mais informações sobre regras de consulta, consulte Gerenciar regras de consulta no SharePoint Server.

Transformações de consulta

Para fornecer resultados de pesquisa apropriados para uma consulta de usuário, às vezes, a consulta precisa ser modificada. Você faz isso com transformações de consulta. Verticais de pesquisa padrão incluídas no SharePoint, como Vídeos, Pessoas e Conversas, todas contêm transformações de consulta predefinidas para otimizar a experiência de pesquisa para essa vertical.

Você pode configurar as transformações de consulta em três locais:

Em uma Web Part, como uma Web Part de Resultados de Pesquisa.
Em uma regra de consulta, que especifica que determinadas ações são executadas somente se determinadas condições forem atendidas.
Na fonte de resultado que a consulta usa para obter resultados de pesquisa.

Uma consulta de usuário é transformada primeiro pela Web Part e, em seguida, por todas as regras de consulta que se aplicam e, por fim, pela fonte de resultado. Ao configurar uma transformação em uma fonte de resultado, você sabe que as alterações de transformação não serão descartadas ou substituídas porque a fonte de resultado transforma a consulta por último. Você pode reutilizar uma transformação de consulta de origem de resultado em web parts ou blocos de resultados e pode criar regras de consulta ou tipos de resultado que só são aplicados a resultados de determinadas fontes de resultado.

Você pode usar o Construtor de Consultas para ajudá-lo a escrever e testar transformações de consulta. Você pode testar a consulta de dentro do Construtor de Consultas definindo valores de teste temporários para as variáveis de consulta, executando a consulta e visualizando os resultados da pesquisa.

Para obter mais informações sobre transformações de consulta, consulte Planejar para transformar consultas e resultados de pedidos no SharePoint Server.

Tipos de resultado e modelos de exibição

A pesquisa do SharePoint inclui uma nova estrutura de resultados que facilita a personalização da forma como os resultados da pesquisa são exibidos. Agora, em vez de escrever XSLT personalizado para alterar a forma como os resultados da pesquisa são exibidos, você pode personalizar a aparência de tipos importantes de resultados usando modelos de exibição e tipos de resultado.

Tipos de resultado

Para exibir os resultados da pesquisa de forma diferente, os resultados da pesquisa precisam ser classificados em diferentes tipos de resultado. Um tipo de resultado é uma classificação de um resultado de pesquisa que distingue um resultado de pesquisa de outro. Ela é composta por uma coleção do seguinte:

Regras – uma ou mais características ou condições para comparar cada resultado da pesquisa, como a origem do resultado ou o tipo de conteúdo do resultado da pesquisa. Condições de regra podem ser unidas usando operadores lógicos, de comparação e de igualdade.
Propriedades – A lista de propriedades gerenciadas para o resultado da pesquisa. Você deve adicionar propriedades gerenciadas à lista de propriedades antes de mapear a propriedade gerenciada para um modelo de exibição.
Exibir modelos – controla a maneira como todos os resultados que atendem às condições aparecem e se comportam em uma página de resultados de pesquisa.

A pesquisa do SharePoint inclui vários tipos de resultado padrão. Para vê-los, acesseTipos de Resultado da Pesquisa deAdministração de Conjunto>de Sites de Configurações> do Site. Você não pode editar nenhum dos tipos de resultado padrão. Você pode criar novos tipos de resultados copiando os existentes e modificando-os.

Para obter mais informações sobre os tipos de resultado padrão incluídos no SharePoint, consulte Tipos de resultado e modelos de exibição que são usados para exibir os resultados da pesquisa no SharePoint Server.

Modelos de exibição

Modelos de exibição definem o layout visual e o comportamento dos resultados da pesquisa. Eles controlam quais propriedades gerenciadas são mostradas nos resultados da pesquisa e como elas aparecem. O SharePoint armazena modelos de exibição na subpasta Pesquisa da pasta Modelos de Exibição na Galeria de Páginas Mestras. Cada modelo de exibição consiste em dois arquivos:

Uma versão HTML do modelo de exibição que você pode editar em seu editor HTML.
Um arquivo .js que o SharePoint usa.

Quando você trabalha com modelos de exibição, modifica o arquivo HTML. O arquivo .js é criado e modificado pelo SharePoint. Você não edita esse arquivo.

Existem dois tipos principais de modelos de exibição:

Modelos de exibição de controle – Determine a estrutura geral de como os resultados são apresentados.
Modelos de exibição de item – Determine como cada resultado no conjunto é exibido.

O modelo de exibição do controle fornece HTML para estruturar o layout geral de como você deseja apresentar os resultados da pesquisa. Por exemplo, o modelo de exibição de controle pode fornecer o HTML para um título e o início e fim de uma lista. O modelo de exibição de controle é processado apenas uma vez na web part.

O modelo de exibição de item fornece HTML que determina como cada item no conjunto de resultados é exibida. Por exemplo, o modelo de exibição de item pode fornecer o HTML para um item de lista que contém uma imagem e três linhas de texto que são mapeadas para propriedades gerenciadas diferentes associadas ao item. O modelo de exibição do item é processado uma vez para cada item no conjunto de resultados. Portanto, se o conjunto de resultados contiver dez itens, o modelo de exibição de item cria sua seção de HTML dez vezes.

Para obter detalhes sobre modelos de exibição e sua estrutura, confira:

Para obter mais informações sobre modelos de exibição disponíveis no SharePoint, consulte Referência de modelo de exibição no SharePoint Server.

Personalizar modelos de exibição

Se você quiser personalizar modelos de exibição incluídos no SharePoint, crie um novo modelo de exibição copiando o conteúdo do que deseja modificar e personalize a nova versão. A partir de uma cópia de um modelo de exibição existente também é a maneira mais fácil de criar um novo, pois ele garante que você esteja começando com todos os elementos necessários.

Outra dica ao trabalhar com modelos de exibição é mapear uma unidade de rede para a Galeria de Página Mestra. Para obter detalhes, confira Mapear uma unidade de rede para a Galeria de Páginas Mestras do SharePoint.

O arquivo HTML usado para um modelo de exibição é um documento HTML totalmente formado com head e body elementos. Dentro do head elemento, há um title elemento que especifica o nome de exibição do modelo de exibição. O texto nesta marca é o que é mostrado quando você faz configurações na interface do usuário do SharePoint; por exemplo, quando você configura um tipo de resultado.

Após o title elemento, há um elemento de propriedades de documento personalizado, mso:CustomDocumentProperties. Em modelos de exibição de item, esse elemento contém um mso:ManagedPropertyMapping elemento, que é onde as propriedades gerenciadas usadas pela pesquisa do SharePoint são mapeadas para valores usados pelo modelo de exibição.

A seguir está a sintaxe para isso: <display template reference name>:<managed property name>, conforme mostrado no exemplo a seguir.

<mso:ManagedPropertyMapping msdt:dt="string">'Title':'Title','Path':'Path','Description':'Description'

Dentro do body elemento, há um script elemento em que você pode incluir recursos externos, como arquivos CSS ou arquivos JavaScript fora do modelo de exibição. Para obter exemplos que mostram como incluir recursos externos no elemento script, confira a seção Bloco de script nos modelos de exibição do SharePoint Design Manager.

O próximo elemento é um div elemento. É aqui que você coloca qualquer HTML ou script desejado como parte do modelo de exibição. Uma boa maneira de se familiarizar com a estrutura do modelo de exibição é baixar cópias dos modelos de exibição padrão para resultados de pesquisa, Control_SearchResults.html (o modelo de exibição de controle) e Item_Default.html (o modelo de exibição de item).

A seguir estão alguns recursos adicionais para modelos de exibição e tipos de resultado:

APIs de consulta e suplementos de pesquisa

A pesquisa do SharePoint inclui modelos de objeto cliente .NET e JavaScript e um serviço REST que permite acesso aos resultados de pesquisa para desenvolvimento online, local e móvel.

Pesquisar APIs de consulta

API	Biblioteca de classes ou caminho de esquema	Exemplo
CSOM DO .NET	Microsoft.SharePoint.Client.Search.dll SDK de componentes de cliente do SharePoint 2013 %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\15\ISAPI SDK de componentes de cliente online do SharePoint %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\16\ISAPI	Pesquisa de consulta com o modelo de objeto cliente gerenciado (Galeria de Códigos)
JavaScript CSOM	SP.search.js %ProgramFiles%\SharePoint Client Components\Scripts	Pesquisa de consulta com o modelo de objeto cliente JavaScript (Galeria de Códigos)
Serviço REST	`http://server/_api/search/query` `http://server/_api/search/postquery` `http://server/_api/search/suggest`	Usando o serviço REST de pesquisa de um suplemento do SharePoint (Galeria de Códigos)

Consulta de pesquisa .NET CSOM

Para usar a consulta .NET CSOM, crie uma nova instância da classe T:Microsoft.SharePoint.Client.ClientContext , que está localizada no namespace Microsoft.SharePoint.Client no Microsoft.SharePoint.Client.dll. Em seguida, use o modelo de objeto de consulta no namespace Microsoft.SharePoint.Search.Client.Query .

Apresentamos um exemplo simples a seguir.

using Microsoft.SharePoint.Client; 
using Microsoft.SharePoint.Client.Search.Query;
â€¦
using (ClientContext clientContext = new ClientContext("http://intranet.contoso.com"))
{
    KeywordQuery keywordQuery = new KeywordQuery(clientContext);
    keywordQuery.QueryText = "Argument";
    SearchExecutor searchExecutor = new SearchExecutor(clientContext);
    ClientResult<ResultTableCollection> results = searchExecutor.ExecuteQuery(keywordQuery);
    clientContext.ExecuteQuery();
}

Agora você pode iterar por meio dos resultados da pesquisa. O exemplo a seguir grava o título de cada resultado.

foreach (var row in results.Value[0].ResultRows) 
{ 
    Console.WriteLine(row["Title"]); 
}

Pesquisar serviço REST de consulta

O serviço REST de consulta de pesquisa dá suporte a solicitações HTTP POST e GET . Ao fazer uma chamada para o serviço REST de Pesquisa, você especifica parâmetros de consulta com a solicitação e pesquisa usa esses parâmetros de consulta para construir a consulta de pesquisa. Com uma solicitação GET, você especifica os parâmetros de consulta na URL. Para solicitações POST, você passa os parâmetros de consulta no corpo no formato JavaScript Object Notation (JSON).

Solicitações JSON GET e POST

Verbo	URI
Solicitações GET	`http://server/_api/search/query`
Solicitações POST	`http://server/_api/search/postquery`

Solicitações GET de exemplo para o serviço REST de Pesquisa

Tipo de solicitação	URL de solicitação
Palavras-chave	`http://server/site/_api/search/query?querytext='{KQL Query}'`
Selecionando propriedades	`http://server/site/_api/search/query?querytext='test'&selectproperties='Title,Rank'`
Classificação	`http://server/site/_api/search/query?querytext='test'&sortlist='LastModifiedTime:descending'` `http://server/site/_api/search/query?querytext='test'&sortlist='LastModifiedTime:descending,Rank:ascending'`

Para obter uma lista completa dos parâmetros de consulta disponíveis e como usá-los, confira Os fundamentos do fluxo de trabalho do SharePoint.

Para obter o código de exemplo, consulte Usando o serviço REST de pesquisa de um Suplemento do SharePoint.

Suplementos de pesquisa

Suplementos do SharePoint (anteriormente conhecidos como aplicativos para SharePoint) são peças de funcionalidade independentes que estendem os recursos de um site do SharePoint. Os suplementos de pesquisa (anteriormente conhecidos como aplicativos de pesquisa) são suplementos do SharePoint que usam a funcionalidade de pesquisa. Em um suplemento de pesquisa, você pode usar as APIs de consulta de pesquisa para recuperar os resultados da pesquisa. Além disso, você também pode usá-lo para distribuir configurações de pesquisa de uma instalação do SharePoint para outra.

Para obter informações sobre como configurar um ambiente de desenvolvimento para criar suplementos de pesquisa, consulte Configurar um ambiente de desenvolvimento local para suplementos do SharePoint ou Configurar um ambiente de desenvolvimento para suplementos do SharePoint em Office 365.

Permissões

Os suplementos de pesquisa exigem apenas permissões no nível do usuário, em que o valor do atributo é QueryAsUserIgnoreAppPrincipal. Essa permissão permite consultar os suplementos de pesquisa com base nas permissões do usuário. Isso significa que os resultados da pesquisa são retornados com base nas ACLs do usuário. Para conceder permissões aos suplementos para usar a pesquisa:

Em Gerenciador de Soluções, abra AppManifest.xml.
Na guia Permissões , selecione Pesquisar escopo e selecione QueryAsUserIgnoreAppPrincipal.

Para saber mais, confira Permissões de suplementos no SharePoint.

APIs de Consulta

Você pode usar o serviço .NET CSOM, JavaScript CSOM ou search REST para recuperar os resultados da pesquisa em um suplemento de pesquisa. O exemplo a seguir mostra como usar a consulta .NET CSOM para recuperar os resultados da pesquisa em um suplemento de pesquisa.

var spContext = SharePointContextProvider.Current.GetSharePointContext(Context);
using (var clientContext = spContext.CreateUserClientContextForSPHost())
{
    KeywordQuery keywordQuery = new KeywordQuery(clientContext);
    keywordQuery.QueryText = "Argument";
    SearchExecutor searchExecutor = new SearchExecutor(clientContext);
    ClientResult<ResultTableCollection> results = searchExecutor.ExecuteQuery(keywordQuery);
    clientContext.ExecuteQuery();
}

Share via