Partilhar via


Novidades na pesquisa do SharePoint para desenvolvedores

Saiba mais sobre os novos recursos disponíveis para desenvolvedores no Search no SharePoint.

Modelo de objeto de cliente de pesquisa para acesso à consulta a funcionalidade do modelo de objeto para on-line, no local e desenvolvimento móvel

O SharePoint Search inclui um CSOM (modelo de objeto cliente) que permite o acesso à maior parte da funcionalidade do modelo de objeto Query para desenvolvimento online, local e móvel. Você pode usar o CSOM de Pesquisa para criar aplicativos cliente que são executados em um computador que não tem o SharePoint instalado para retornar os resultados da pesquisa do SharePoint.

O CSOM de Pesquisa inclui um modelo de objeto cliente gerenciado da Microsoft .NET Framework e um modelo de objeto JavaScript, e é criado no SharePoint. Primeiro, o código do cliente acessa o SharePoint CSOM. Em seguida, o código do cliente acessa CSOM a pesquisa.

Para usar o CSOM gerenciado .NET Framework pesquisa, você deve obter uma instância ClientContext (localizada no namespace Microsoft.SharePoint.Client no Microsoft.SharePoint.Client.dll). Em seguida, use o modelo de objeto no namespace Microsoft.SharePoint.Client.Search.Query na Microsoft.Office.Server.Search.Client.dll. Para obter mais informações sobre o SharePoint CSOM, consulte SharePoint 2010 Client Object Model. Para obter mais informações sobre o objeto ClientContext, que é o ponto de entrada para o CSOM, consulte Client Context as Central Object.

CSOM a pesquisa retorna os dados de resultados de pesquisa do servidor em JavaScript Object Notation (JSON). O JSON para os dados de resultados da pesquisa contém uma coleção ResultTableCollection composta por objetos ResultTable que representam diferentes conjuntos de resultados.

Suporte a sintaxe SQL removido

As soluções de pesquisa personalizadas no SharePoint não dão suporte à sintaxe SQL. A pesquisa no SharePoint dá suporte à sintaxe FQL e à sintaxe KQL para soluções de pesquisa personalizadas. Você não pode usar a sintaxe SQL em soluções de pesquisa personalizada usando qualquer tecnologia, incluindo o modelo de objeto do servidor de consulta, o modelo de objeto do cliente e o serviço de pesquisa restante. Soluções de pesquisa personalizadas que usam sintaxe SQL com o modelo de objeto do servidor de consulta e o serviço Web de consulta que foram criados em versões anteriores do SharePoint Server não funcionarão quando você os atualizar para o SharePoint. As consultas enviadas através desses aplicativos irão retornar um erro. Para obter mais informações sobre como usar a sintaxe FQL e a sintaxe KQL, consulte Referência de sintaxe KQL (Linguagem de Consulta de Palavra-Chave) e referência de sintaxe FAST Query Language (FQL.md).

Serviço de pesquisa do restante para execução remota das consultas de aplicativos cliente

O SharePoint inclui um serviço REST (Transferência de Estado Representacional) que permite executar remotamente consultas no SharePoint serviço Pesquisa de aplicativos cliente usando qualquer tecnologia que dê suporte a solicitações da Web REST. O serviço pesquisa REST expõe dois pontos de extremidade, query e suggeste dará suporte a operações GET e o POST. Os resultados são retornados em formato XML ou JSON.

Veja a seguir o ponto de acesso do serviço: http://server/_api/search/. Você também pode especificar o site na URL, da seguinte maneira: http://server/site/_api/search/. O serviço de pesquisa retorna resultados do conjunto de sites inteiro, para que os mesmos resultados são retornados para ambas as maneiras de acessar o serviço.

Você também pode usar a URL que faz referência a client.svc para acessar o serviço, da seguinte maneira: http://server/_vti_bin/client.svc/search/. No entanto, usar _api é a convenção preferencial.

Use o seguinte ponto de acesso para acessar os metadados do serviço:

http://server/_api/$metadata

Para obter informações gerais sobre o serviço REST no SharePoint, consulte Usar operações de consulta OData em solicitações REST do SharePoint.

Serviço web de consulta de pesquisa do SharePoint está obsoleto

O serviço Web de consulta (localizado no caminho http://server/site/_vti_bin/search.asmx) é preterido no SharePoint. Se você criar novos aplicativos, evite usar esse recurso reprovado e em vez disso, use o novo serviço de CSOM de consulta ou consulta restante. Se você modificar aplicativos existentes, recomendamos que você remova qualquer dependência sobre este recurso.

Aprimoramentos do modelo de objeto de consulta de pesquisa do SharePoint

Propriedades de consulta fornecem informações sobre uma consulta de pesquisa. No SharePoint Search, um saco de propriedades foi adicionado às classes de consulta e resultado para habilitar as propriedades de consulta definidas pelo usuário. Você pode acessar as propriedades de consulta existentes por meio da propriedade em uma das classes de consulta, como a seguir:

KeywordQuery.EnableStemming

Ou você pode usar o conjunto de propriedades, da seguinte maneira:

KeywordQuery.Properties["EnableStemming"]

Você pode acessar as propriedades definidas pelo usuário usando somente o conjunto de propriedades, da seguinte maneira:

KeywordQuery.Properties["UserDefinedProperty"]

O SharePoint Search inclui propriedades de consulta no saco de propriedades, incluindo novas propriedades de consulta, como:

  • BypassResultTypes Especifica se o tipo de item do resultado de pesquisa será retornado nos resultados da consulta. Especifique true para não retornar nenhum tipo de resultado; Caso contrário, false.

  • EnableInterleaving Especifica se os conjuntos de resultados gerados pela execução de ações de regra de consulta para adicionar um bloco de resultado são misturados com o conjunto de resultados para a consulta original. Especifique true para misturar o resultado gerado com o conjunto original de resultados; Caso contrário, false.

  • EnableQueryRules Especifica se as regras de consulta estão ativadas para essa consulta. Especifique true para habilitar regras de consulta para a consulta; caso contrário, false.

Você pode especificar qualquer propriedade no conjunto de propriedades, incluindo propriedades definidas pelo usuário, como condições de regra de consulta. Você pode usar regras de consulta para personalizar a experiência de pesquisa para os tipos de consultas que são importantes para os usuários. Quando uma consulta atende às condições especificadas em uma regra de consulta, a regra especifica ações para melhorar a relevância dos resultados da pesquisa associado.

Aprimoramentos de linguagem de consulta de palavra-chave

O SharePoint inclui melhorias no idioma de consulta de palavra-chave, que são descritos nesta seção.

Melhor próximo operador

Em SharePoint Server 2010, o operador NEAR implícito a uma distância máxima de token de 8 e preservados a ordenação dos tokens de entrada. No SharePoint, o operador NEAR não preserva mais a ordenação de tokens. Além disso, o operador NEAR agora recebe um parâmetro opcional que indica a distância máxima do token. No entanto, o valor padrão ainda é 8. Se você precisar usar o comportamento anterior, use ONEAR.

O operador de NEAR pode ser usado em expressões de restrição da propriedade, conforme mostrado no exemplo a seguir:

"acquisition" NEAR "debt"

Esta consulta corresponde itens onde os símbolos "aquisição" e "debt" aparecem dentro do mesmo documento, com uma distância de token máximo de 8 (que é o valor padrão de n se nenhum valor for fornecido). A ordem dos tokens não é significativa para a correspondência.

Se você precisar de uma distância menor de token, você pode especificá-lo da seguinte maneira:

"acquisition" NEAR(n=3) "debt"

Itens onde os dois tokens de "aquisição" e "debt" aparece dentro do mesmo documento, com uma distância máxima de token de 3 corresponde a essa consulta. A ordem dos tokens não é significativa para a correspondência.

Novo operador ONEAR

O operador de ONEAR fornece funcionalidade encomendada near. Ele recebe um parâmetro opcional que indica a distância máxima de token; o valor padrão é 8.

O operador de ONEAR preserva a ordem das expressões de entrada. De proximidade não ordenada, use NEAR.

Você pode usar o operador de ONEAR em expressões de restrição da propriedade, conforme mostrado no exemplo a seguir:

"acquisition" ONEAR "debt"

Esta consulta corresponde itens onde os dois tokens de "aquisição" e "debt" aparece dentro do mesmo documento, com uma distância de token máximo de 8 (que é o valor padrão de n se nenhum valor for fornecido). A ordem dos tokens deve coincidir com um item a ser retornado.

Se você precisar de uma distância menor de token, você pode especificá-lo da seguinte maneira:

"acquisition" ONEAR(n=3) "debt"

Itens onde os dois tokens de "aquisição" e "debt" aparece dentro do mesmo documento, com uma distância máxima de token de 3 corresponde a essa consulta. A ordem dos tokens deve coincidir com um item a ser retornado.

Novo operador XRANK

Em SharePoint Server 2010, o operador de XRANK estava disponível apenas com a linguagem de consulta rápida (FQL). O SharePoint apresenta um novo e poderoso operador XRANK .

O operador de XRANK fornece um controle dinâmico de classificação. Este operador aumenta o grau de dinâmico de itens com base na ocorrência de determinados termos sem alterar os itens que corresponderem à consulta.

Estrutura de resultados avançada para personalizar os resultados da pesquisa da interface do usuário

O SharePoint Search inclui uma nova estrutura de resultados que facilita a personalização da aparência (aparência e aparência) da interface do usuário (interface do usuário) dos resultados da pesquisa. Agora, em vez de escrever uma XSLT personalizada para alterar como os resultados da pesquisa são exibidos, você pode personalizar a aparência dos tipos importantes de resultados usando modelos de exibição e tipos de resultado.

Modelos de exibição

Os modelos de exibição definem o layout visual e o comportamento de um tipo de resultado usando HTML, CSS e JavaScript. Você pode personalizar os modelos de exibição existentes ou criar os modelos de exibição usando uma marca HTML editor e carregá-los para a Galeria de modelos de exibição.

Tipos de resultado

Os tipos de resultado definem como exibir um conjunto de resultados da pesquisa com base em um conjunto de procedimentos:

  • Regras Determine quando aplicar um tipo de resultado, com base nas condições especificadas. Condições de regra podem ser unidas usando operadores lógicos, de comparação e de igualdade.

  • Propriedades Determine a lista de propriedades gerenciadas para o resultado. Você deve adicionar propriedades gerenciadas para a lista antes de você mapear a propriedade gerenciada para um modelo de exibição.

  • Modelos de exibição Defina o layout visual do tipo de resultado.

Os administradores podem criar e gerenciar tipos de resultado no nível do site ou no nível de aplicativo de serviço; nenhuma codificação personalizada é necessária.

Aprimoramentos do conector do framework

O SharePoint Search permite recuperar informações de declarações para conteúdo armazenado em fontes de dados externas personalizadas que são rastreadas usando a estrutura do conector.

O framework de conector também fornece melhor exceção captura e log para ajudá-lo a solucionar problemas de erros encontrados quando rastreia fontes de conteúdo usando conectores personalizados que são criados sobre a estrutura do conector. Para obter informações sobre a estrutura do conector, consulte Estrutura do conector de pesquisa no SharePoint.

Confira também