Compartir vía

Buscar soluciones para SharePoint

  • Artículo

La búsqueda en SharePoint combina la facilidad de configuración e implementación con la escalabilidad y extensibilidad de FAST Search Server en una única plataforma de búsqueda empresarial.

SharePoint incluye patrones comunes en la plataforma de búsqueda para ayudarle a personalizar la búsqueda de diferentes escenarios. Por ejemplo:

  • La búsqueda de vídeo y la búsqueda de conversaciones se incluyen como verticales de búsqueda integradas.
  • Las páginas de temas y el contenido por búsqueda mejoran las funcionalidades y escenarios de administración de contenido web, como sitios controlados por búsquedas y sitios de administración de conocimiento.
  • Mis tareas reúnen las tareas del proyecto para que los usuarios puedan realizar un seguimiento de las tareas asignadas en varios sitios en una ubicación central: su sitio OneDrive para la Empresa.

Arquitectura de búsqueda de SharePoint

La arquitectura de búsqueda en SharePoint incluye componentes y bases de datos que funcionan conjuntamente.

Componentes de búsqueda en SharePoint

Componente Descripción
Rastreo Rastrea los orígenes de contenido para recopilar propiedades y metadatos y enviar esta información al componente de procesamiento de contenido.
Procesamiento de contenido Transforma los elementos rastreados y los envía al componente de índice.
Este componente también asigna propiedades rastreadas a propiedades administradas.
Procesamiento de Analytics Lleva a cabo análisis de búsqueda y análisis de uso.
Índice Recibe los elementos procesados del componente de procesamiento de contenido y los escribe en el índice de búsqueda.
Este componente también controla las consultas entrantes, recupera la información del índice de búsqueda y devuelve el conjunto de resultados al componente de procesamiento de consultas.
Procesamiento de consultas Analiza las consultas entrantes. Esto ayuda a optimizar la precisión, la recuperación y la relevancia.
Las consultas se envían al componente de índice que, a su vez, devuelve un conjunto de resultados de la búsqueda para la consulta.
Administración de búsquedas Inicia los procesos de búsqueda del sistema, agrega e inicia nuevas instancias de los componentes de búsqueda.

Buscar bases de datos en SharePoint

Base de datos Descripción
Rastreo Almacena la información de seguimiento y la información histórica sobre los elementos rastreados como, por ejemplo, direcciones URL y documentos.
También almacena información, como, por ejemplo, la hora del último rastreo, el id. del último rastreo y el tipo de actualización (agregación, actualización o eliminación) durante el último rastreo.
Vínculo Almacena la información no procesada que extrae el componente de procesamiento de contenido, así como la información de los clics de búsqueda.
El componente de procesamiento de Analytics analiza esta información.
Informes de Analytics Almacena los resultados de análisis de uso.
Administración de búsquedas Almacena datos de configuración de búsqueda.

Rastreo y procesamiento de contenido

El proceso de rastreo comienza con los diferentes orígenes de contenido (por ejemplo, HTTP, recursos compartidos de archivos y SharePoint). Para que se agregue contenido al índice, el rastreador usa conectores que le indican cómo conectarse al origen de contenido y obtener acceso a los elementos del origen de contenido. Cuando el rastreador ha encontrado los elementos de contenido, usa un controlador de formato aplicable para analizar el contenido.

Tras recuperar el contenido, el componente de rastreo pasa los elementos rastreados al componente de procesamiento de contenido, que procesa los elementos y los envía al componente de índice. Esto incluye analizar documentos, asignar propiedades rastreadas a sus propiedades administradas asociadas y procesamiento lingüístico, como, por ejemplo, la extracción de entidades y detección de idioma. El componente de procesamiento de contenido también escribe información sobre vínculos y direcciones URL en la base de datos de vínculo.

Procesamiento de consultas

El componente de procesamiento de consultas analiza y procesa consultas para optimizar la precisión, recuperación y relevancia, incluyendo la realización de procesamiento lingüístico como, por ejemplo, la separación de palabras y la lematización. Después se envía la consulta procesada al componente de índice, que devuelve un conjunto de resultados basado en la consulta procesada al componente de procesamiento de consultas que, a su vez, procesa dicho conjunto de resultados.

Análisis de búsqueda

SharePoint analiza tanto el contenido en sí (análisis de búsqueda) como la forma en que los usuarios interactúan con él (análisis de uso) y usa esta información para mejorar la búsqueda.

El análisis de búsqueda consiste en extraer información, como vínculos, el número de veces que se hace clic en un elemento, texto de hipervínculo, datos relacionados con personas y metadatos, de la base de datos de vínculo. Buscar formularios de análisis con el objeto de determinar la relevancia.

El análisis de uso, por otra parte, consiste en analizar la información de registro de uso que se recibe del front-end a través del almacén de eventos. El análisis de uso constituye la base de los informes de uso y estadísticas.

Los resultados de los análisis se agregan a los elementos en el índice de búsqueda. Además, los resultados de análisis de uso se almacenan en la base de datos de informes de análisis.

Bloques de creación para personalizar la experiencia de búsqueda

La búsqueda en SharePoint y SharePoint Online incluye nuevas funcionalidades y mejoras que le permiten personalizar la experiencia de búsqueda. Muchas de las mejoras no necesitan que escriba código. La búsqueda de SharePoint incluye CSOM y API REST para ayudarle cuando necesita escribir código para la personalización, o si desea crear complementos para acceder a los resultados de búsqueda de SharePoint fuera de SharePoint.

Entre las nuevas funcionalidades y mejoras se incluyen las siguientes:

  • Sitio del Centro de búsqueda
  • Elementos web del Centro de búsqueda
  • Orígenes de resultados
  • Reglas de consulta
  • Transformaciones de consulta
  • Tipos de resultado y las plantillas de visualización

Sitio del Centro de búsqueda

El Centro de búsqueda es un sitio de SharePoint configurado para la búsqueda. Es un portal en el que puede buscar contenido en la intranet de su organización y proporciona una interfaz de usuario centralizada y altamente personalizable. En esta sección se describen las páginas y los elementos web del Centro de búsqueda, junto con los valores de configuración de búsqueda que puede modificar para crear aplicaciones de búsqueda personalizadas o experiencias de búsqueda sin escribir mucho código.

Al crear un sitio del Centro de búsqueda, SharePoint crea una página principal de búsqueda predeterminada y una página de resultados de búsqueda predeterminada. Además, también se crean varias páginas conocidas como presentaciones verticales de búsqueda. Las presentaciones verticales de búsqueda son páginas de resultados de la búsqueda que se personalizan para buscar tipos de contenido específicos como Contactos y Vídeos y muestran resultados de la búsqueda que se filtran y formatean para un determinado o clase de contenido.

Las páginas siguientes se crean en una colección de sitios del Centro de búsqueda, en la Biblioteca de páginas:

  • default.aspx : la página principal del Centro de búsqueda y la página donde los usuarios finales escriben sus consultas.
  • results.aspx : página de resultados de búsqueda predeterminada del Centro de búsqueda. También es la página de resultados de búsqueda de la presentación vertical de búsqueda Todo.
  • peopleresults.aspx: página de resultados de búsqueda del Personas vertical de búsqueda.
  • conversationresults.aspx : página de resultados de la búsqueda de conversaciones vertical.
  • videoresults.aspx : la página de resultados de búsqueda de la búsqueda vídeos vertical.
  • advanced.aspx : página de búsqueda en la que los usuarios finales pueden aplicar restricciones a sus frases de búsqueda, por ejemplo, limitando la búsqueda a una frase exacta.

Todas las páginas de presentación vertical de búsqueda contienen el elemento web de Resultados de la búsqueda, aunque el elemento web se configura de manera diferente para cada presentación vertical de búsqueda. En cada una, la consulta del elemento web de Resultados de la búsqueda se dirige a un origen de resultados concreto, aplicable a esa presentación vertical de búsqueda. Por ejemplo, la consulta del elemento web de Resultados de la búsqueda en la página peopleresults.aspx está limitada al origen de resultados Resultados locales de personas. Comprender cómo se configuran los verticales de búsqueda predeterminados en SharePoint puede ayudarle a crear su propia búsqueda vertical o personalizar el Centro de búsqueda.

Los siguientes son recursos adicionales que le ayudarán a trabajar con el Centro de búsqueda:

Elementos web del Centro de búsqueda

Las páginas del Centro de búsqueda contienen cuatro tipos de elementos web: Cuadro de búsqueda, Resultados de la búsqueda, Navegación de la búsqueda y Refinamiento.

Elemento web de Cuadro de búsqueda

El elemento web Cuadro de búsqueda muestra un cuadro de texto donde los usuarios introducen texto sobre lo que se va a buscar. El elemento web de Cuadro de búsqueda se usa de forma predeterminada en la página principal del Centro de búsqueda (default.aspx), así como en todas las páginas de resultados de la búsqueda predeterminadas (results.aspx, peopleresults.aspx, conversationresults.aspx, videoresults.aspx).

Puede personalizar el elemento web Cuadro de búsqueda mediante la edición de propiedades en el panel de herramientas del elemento web. Esto le permite hacer lo siguiente:

  • Cambiar dónde se muestran los resultados de la búsqueda. Por ejemplo, puede mostrar los resultados en un elemento web personalizado de Resultados de la búsqueda o en una página personalizada de resultados de la búsqueda.
  • Desactivar las sugerencias de consulta y de contactos.
  • Mostrar vínculos a una página de preferencias de búsqueda y a una página de búsqueda avanzada.
  • Cambiar la plantilla para mostrar del elemento web.

Para obtener más información, consulte:

Elemento web de Resultados de la búsqueda

El elemento web de Resultados de la búsqueda muestra los resultados de una consulta de búsqueda. De forma predeterminada, los elementos web de Resultados de la búsqueda se usan en todas las páginas de presentación vertical de búsqueda (results.aspx, peopleresults.aspx, conversationresults.aspx, and videoresults.aspx). El elemento web de Resultados de la búsqueda también envía los resultados de búsqueda para los elementos web de Refinamiento y Exploración de la búsqueda, por lo que debe haber un elemento web de Resultados de la búsqueda en una página de resultados de la búsqueda para que los otros web de búsqueda funcionen.

Puede editar las propiedades del elemento web de Resultados de la búsqueda en el panel de herramientas del elemento web para cambiar la consulta de búsqueda, así como para alterar el comportamiento y la apariencia de los resultados en la página de resultados de la búsqueda.

Cambiando los valores de propiedad, puede hacer lo siguiente:

  • Cambiar el origen de resultados para especificar el contenido que desea buscar.
  • Agregar variables de consulta o filtros de propiedades para personalizar los resultados de la búsqueda para diferentes usuarios o grupos de usuarios.
  • Aumentar o disminuir el nivel de los elementos o las páginas en los resultados de la búsqueda.
  • Cambiar la ordenación de los resultados de la búsqueda.
  • Cambiar la plantilla para mostrar.

Para obtener más información sobre los elementos web de resultados de búsqueda, consulte:

Elemento web de Navegación de la búsqueda

El elemento web de Navegación de la búsqueda muestra vínculos que permiten al usuario desplazarse rápidamente entre las diferentes presentaciones verticales de búsqueda (Todo, Contactos, Conversaciones y Vídeos). El elemento web de Exploración de la búsqueda usa los resultados de la búsqueda desde el elemento web de Resultados de la búsqueda para que, cuando los usuarios elijan un vínculo de presentación vertical de búsqueda, los resultados de la búsqueda se filtren y se muestren en función de cómo esté configurada la presentación vertical de búsqueda.

Editando las propiedades del elemento web exploración de la búsqueda en el panel de herramientas del elemento web, puede personalizar el elemento web como sigue:

  • Especificar un elemento web distinto del que recibir resultados.
  • Cambiar el número de vínculos a presentaciones verticales de búsqueda para mostrar.
  • Cambiar la apariencia y el diseño del elemento web.

Además, en la cinta de opciones, puede seleccionar Configuración> del sitioBuscar configuración para realizar los siguientes cambios:

  • Cambiar los nombres para mostrar de vínculos.
  • Cambiar el orden de vínculos.

Elemento web de Refinamiento

El elemento web Refinamiento filtra resultados de la búsqueda en categorías llamadas refinadores. Los usuarios pueden elegir estos refinadores para limitar los resultados de la búsqueda. Los refinadores son propiedades administradas que están marcadas como Refinable y Queryable. Para obtener información sobre esta configuración, vea información general sobre la configuración de propiedades administradas en Información general sobre el esquema de búsqueda en SharePoint Server.

Puede editar las propiedades del elemento web Refinamiento en el panel de herramientas del elemento web para especificar lo siguiente:

  • Qué elemento web de Resultados de la búsqueda usar para filtrar el formulario resultados de la búsqueda.
  • Los refinadores que se usarán en el elemento web de Refinamiento.
  • La plantilla para mostrar que se aplica a cada refinador.
  • La apariencia, el diseño y el comportamiento del elemento web de Refinamiento.

De manera predeterminada, el elemento web de Refinamiento no muestra el número de resultados por cada valor de refinador. Puede agregar recuentos de refinador modificando la plantilla de presentación para el refinador.

Para obtener más información sobre esta característica, vea Configurar las propiedades del elemento web Refinamiento en SharePoint Server.

Para obtener más información sobre el elemento web de refinamiento y los refinadores, consulte:

Orígenes de resultados

Result sources limit searches to certain content or to a subset of search results. Puede definir un origen de resultados especificando lo siguiente:

  • Un proveedor de búsqueda o una dirección URL de origen desde la que obtener los resultados de la búsqueda; por ejemplo, el índice de búsqueda de la servicio Search local de SharePoint.
  • Protocolo que se va a usar para obtener resultados de búsqueda; por ejemplo, el protocolo OpenSearch .
  • Una transformación de consulta, que puede limitar los resultados del proveedor de búsquedas determinado o dirección URL a un subconjunto especificado de resultados, por ejemplo, un conjunto de resultados que tiene un tipo de contenido concreto.

SharePoint proporciona dieciséis orígenes de resultados preconfigurados, incluidos los resultados locales de SharePoint, las conversaciones y los elementos relacionados con el usuario actual. Puede ver detalles sobre los orígenes de resultados en la página Administrar orígenes de resultados (Orígenes de resultados debúsqueda>de configuración> del sitio).

En la página Administrar orígenes de resultados , puede crear nuevos orígenes de resultados de cualquiera de las dos maneras siguientes:

  • Seleccione Nuevo origen de resultados y seleccione el origen del resultado que desee. Para más información, vea Configurar orígenes de resultados para búsqueda en SharePoint Server.
  • Apunte a la flecha que se encuentra junto a un origen de resultados existente, escoja Copiar y, a continuación, modifique la copia según sea necesario y guárdela con un nombre nuevo.

Un origen de resultado especifica uno de los cuatro protocolos para obtener resultados de la búsqueda. Si el origen de resultados usa un protocolo distinto de SharePoint local también debe especificar una dirección URL desde la cual obtener resultados de la búsqueda.

Protocolos de orígenes de resultados y sus proveedores

Protocolo de origen de resultados Proveedor URL
SharePoint local El índice de búsqueda del Servicio de búsqueda local. N/D
SharePoint remoto El índice de búsqueda de un Servicio de búsqueda hospedado en otra granja de servidores. La dirección de la colección de sitios raíz de la granja de servidores de SharePoint remota.
OpenSearch 1.0/1.1 Proveedor de búsqueda externo (como un suministro o motor de búsqueda remoto) que usa el protocolo OpenSearch para proporcionar resultados de la búsqueda. La dirección URL de la fuente RSS de un proveedor de búsqueda que usa el protocolo OpenSearch.
Exchange Servicios web de Exchange (EWS). Una dirección URL de EWS.

Para obtener más información, vea los artículos siguientes:

Reglas de consulta

Utilice reglas de consulta para personalizar la experiencia de búsqueda para las consultas que son especialmente importantes para los usuarios. En una regla de consulta, se especifica el contexto, las condiciones y las acciones correlacionadas. A continuación, en el contexto especificado y cuando una consulta cumple las condiciones especificadas, la búsqueda realiza sus acciones correlacionadas para mejorar la relevancia de los resultados de la búsqueda.

En relación con el contexto, puede restringir las consultas de regla de consulta que son:

  • Realizadas en un origen de resultados especificado.
  • De una categoría de tema especificada.
  • Realizadas por un usuario que coincida con un segmento de usuario especificado.

Las condiciones de listas de tabla siguientes que se pueden especificar que provocan que se ejecute una regla de consulta.

Condiciones de reglas de consulta

Condición Descripción
Coincidencia exacta de la consulta con la palabra clave Se aplica la regla de consulta si la consulta coincide de forma exacta con la palabra o frase especificada.
La consulta contiene el término de acción Se aplica la regla de consulta si la consulta contiene un término consistente en una sola palabra o frase, que indica que el usuario intenta realizar una acción.
El término debe estar al principio o al final de la consulta y podría ser un verbo, un comando o un filtro.
Coincidencia exacta de la consulta con un diccionario Se aplica la regla de consulta si la consulta coincide de forma exacta con una entrada del diccionario.
Esta entrada puede ser un término en el almacén de términos o una entrada en el diccionario de nombres de personas.
Consulta más común en este origen Se aplica la regla de consulta si la consulta del usuario suele realizarse con un origen de resultados distinto del actual.
Esta condición analiza las consultas que los usuarios han escrito en los distintos orígenes de resultados.
Tipo de resultado: con clics frecuentes Aplique la regla de consulta si la consulta se termina a menudo en usuarios que eligen resultados de un tipo de resultado concreto.
Cuando cree un nuevo tipo de resultado, puede indicar que esas selecciones deben registrarse para usarse en reglas de consulta.
Coincidencia de texto de consulta avanzada Se aplica la regla de consulta si la consulta coincide con una expresión regular.
También le permite usar variaciones de las condiciones de palabra clave, diccionario y términos de acciones explicadas antes, pero con un control más avanzado.

Una regla de consulta puede especificar tres tipos de acciones:

  • Agregar Resultados promocionados (anteriormente conocidos como Opciones más probables) que aparezcan por encima de los resultados clasificados. Por ejemplo, para la licencia por enfermedad de consulta, una regla de consulta podría especificar un resultado promocionado determinado, como un vínculo a un sitio que tenga una declaración de directiva de empresa con respecto al tiempo de espera del trabajo.

  • Agregue uno o más grupos de resultados, llamados bloques de resultado. Un bloque de resultados contiene un subconjunto pequeño de resultados que están relacionados a una consulta de una forma particular. De la misma forma que los resultados individuales, puede promover un bloque de resultados o clasificarlo con otros resultados de la búsqueda.

  • Cambie la clasificación de los resultados cambiando la consulta. Por ejemplo, para una consulta que contiene el cuadro de herramientas de descarga, una regla de consulta podría reconocer la palabra download como un término de acción y aumentar los resultados de búsqueda que apuntan a un sitio de descarga determinado en la intranet.

Para obtener más información sobre las reglas de consulta, vea Administrar reglas de consulta en SharePoint Server.

Transformaciones de consulta

A veces, para proporcionar resultados de la búsqueda que son adecuados para una consulta de usuario, la consulta necesita modificarse. Para ello se usan las transformaciones de consulta. Los verticales de búsqueda predeterminados incluidos con SharePoint, como vídeos, Personas y conversaciones, contienen transformaciones de consulta predefinidas para optimizar la experiencia de búsqueda de esa vertical.

Las transformaciones de consulta pueden configurarse en tres ubicaciones:

  • En un elemento web, como un elemento web de Resultados de la búsqueda.
  • En una regla de consulta, que especifica que ciertas acciones se realizan solo si se cumplen ciertas condiciones.
  • En el origen del resultado que usa la consulta para obtener resultados de la búsqueda.

Una consulta de usuario es transformada primero por el elemento web, después por las reglas de consulta que se aplican y finalmente por el origen del resultado. Al configurar una transformación en un origen de resultados, sabe que los cambios de transformación no se descartarán ni invalidarán porque el origen de resultados transforma la última consulta. Puede volver a usar una transformación de consulta del origen de resultado en elementos web o bloques de resultado y puede crear reglas de consulta de tipos de resultado que se aplican solo a los resultados de ciertas fuentes de resultados.

Puede usar el Generador de consultas para ayudarle a escribir y probar transformaciones de consulta. Puede probar la consulta desde el Generador de consultas estableciendo los valores de prueba temporal para las variables de consulta, ejecutando la consulta y obteniendo así una vista previa de los resultados de búsqueda.

Para obtener más información sobre las transformaciones de consultas, vea Planear la transformación de consultas y ordenar los resultados en SharePoint Server.

Tipos de resultado y las plantillas de visualización

La búsqueda de SharePoint incluye un nuevo marco de resultados que facilita la personalización de la forma en que se muestran los resultados de la búsqueda. Ahora, en lugar de escribir XSLT personalizadas para cambiar cómo se muestran los resultados de la búsqueda, puede personalizar la apariencia de los tipos de resultados importantes mediante plantillas para mostrar y tipos de resultado.

Tipos de resultado

Para mostrar los resultados de la búsqueda de manera distinta, estos deben ordenarse en diferentes tipos de resultados. Un tipo de resultado es una clasificación del resultado de una búsqueda que distingue un resultado de la búsqueda de otro. Consta de una colección de los siguientes elementos:

  • Reglas : una o varias características o condiciones con las que comparar cada resultado de búsqueda, como el origen de resultados o el tipo de contenido del resultado de la búsqueda. Las condiciones de regla se pueden combinar mediante operadores lógicos, de igualdad y de comparación.

  • Propiedades : lista de propiedades administradas para el resultado de la búsqueda. Debe agregar propiedades administradas a la lista de propiedades antes de asignar la propiedad administrada para una plantilla de presentación.

  • Plantillas para mostrar : controla la forma en que aparecen y se comportan todos los resultados que cumplen las condiciones en una página de resultados de búsqueda.

La búsqueda de SharePoint incluye varios tipos de resultados predeterminados. Para verlos, vaya a Configuración del sitio Tipos> de resultados de búsquedade administración> decolecciones de sitios. No puede editar cualquiera de los tipos de resultados predeterminados. Para crear nuevos tipos de resultados, copie los existentes y modifíquelos.

Para obtener más información sobre los tipos de resultados predeterminados incluidos con SharePoint, vea Tipos de resultados y plantillas para mostrar que se usan para mostrar los resultados de búsqueda en SharePoint Server.

Plantillas para mostrar

Las plantillas para mostrar definen el diseño visual y el comportamiento de los resultados de la búsqueda. Controlan qué propiedades administradas se muestran en los resultados de la búsqueda y la forma en que aparecen. SharePoint almacena plantillas para mostrar en la subcarpeta Buscar de la carpeta Plantillas para mostrar de la Galería de páginas maestras. Cada plantilla para mostrar consta de dos archivos:

  • Una versión HTML de la plantilla para mostrar que se puede editar en el editor HTML.
  • Un archivo .js que SharePoint usa.

Cuando se trabaja con plantillas de presentación, se modifica el archivo HTML. SharePoint crea y modifica el archivo .js. No modifique este archivo.

Hay dos tipos principales de plantillas para mostrar:

  • Plantillas para mostrar de control : determine la estructura general de cómo se presentan los resultados.
  • Plantillas para mostrar elementos : determine cómo se muestra cada resultado del conjunto.

La plantilla para mostrar de control proporciona HTML para estructurar el diseño general de la presentación de los resultados de búsqueda. Por ejemplo, la plantilla para mostrar del control podría proporcionar el código HTML para un título y el comienzo y el final de una lista. La plantilla para mostrar del control se representa solo una vez en el elemento web.

La plantilla de presentación de elementos proporciona HTML que determina cómo se muestra cada elemento del conjunto de resultados. Por ejemplo, la plantilla de presentación de elementos podría proporcionar el CÓDIGO HTML para un elemento de lista que contiene una imagen y tres líneas de texto que se asignan a diferentes propiedades administradas asociadas al elemento. La plantilla de presentación de elementos se representa una vez para cada elemento del conjunto de resultados. Por lo tanto, si el conjunto de resultados contiene diez elementos, la plantilla de presentación de elementos crea su sección de HTML diez veces.

Para obtener más información sobre las plantillas para mostrar y su estructura, consulte:

Para obtener más información sobre las plantillas para mostrar disponibles en SharePoint, vea Mostrar referencia de plantilla en SharePoint Server.

Plantillas de visualización personalizadas

Si desea personalizar las plantillas para mostrar incluidas con SharePoint, cree una nueva plantilla para mostrar copiando el contenido del que desea modificar y, a continuación, personalice la nueva versión. A partir de una copia de una plantilla de presentación existente también es la manera más fácil de crear una nueva, ya que garantiza que está empezando con todos los elementos necesarios.

Otra sugerencia al trabajar con plantillas para mostrar es asignar una unidad de red a la Galería de páginas maestras. Para obtener más información, vea Asignación de una unidad de red a la Galería de páginas maestras de SharePoint.

El archivo HTML que se usa para una plantilla para mostrar es un documento HTML completo con head elementos y body . Dentro del head elemento , hay un title elemento que especifica el nombre para mostrar de la plantilla para mostrar. El texto de esta etiqueta es lo que se muestra cuando se realizan configuraciones en la interfaz de usuario de SharePoint; por ejemplo, al configurar un tipo de resultado.

Después del title elemento , hay un elemento de propiedades de documento personalizado, mso:CustomDocumentProperties. En las plantillas de presentación de elementos, este elemento contiene un mso:ManagedPropertyMapping elemento, que es donde las propiedades administradas usadas por la búsqueda de SharePoint se asignan a los valores utilizados por la plantilla para mostrar.

La siguiente es la sintaxis para esto: <display template reference name>:<managed property name>, como se muestra en el ejemplo siguiente.

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

Dentro del body elemento, hay un script elemento donde puede incluir recursos externos, como archivos CSS o archivos JavaScript fuera de la plantilla para mostrar. Para ver ejemplos que muestran cómo incluir recursos externos en el elemento script, vea la sección Bloque de scripts en Plantillas para mostrar del Administrador de diseño de SharePoint.

El siguiente elemento es un div elemento . Aquí es donde coloca cualquier HTML o secuencia de comandos que desea usar como parte de la plantilla para mostrar. Una buena manera de familiarizarse con la estructura de plantillas para mostrar es descargar copias de las plantillas de presentación predeterminadas para los resultados de búsqueda, Control_SearchResults.html (la plantilla de visualización de control) y Item_Default.html (la plantilla para mostrar del elemento).

Los siguientes son algunos recursos adicionales para plantillas para mostrar y tipos de resultado:

APIs y complementos de consulta

La búsqueda de SharePoint incluye modelos de objetos de cliente .NET y JavaScript y un servicio REST que permite el acceso a los resultados de búsqueda para el desarrollo en línea, local y móvil.

APIs de consulta de búsqueda

API Biblioteca de clases o ruta de esquema Ejemplo
.NET CSOM Microsoft.SharePoint.Client.Search.dll

SDK de componentes cliente de SharePoint Server 2013
%ProgramFiles%\Common Files\Microsoft Shared\web server extensions\15\ISAPI

El SDK de componentes de cliente de SharePoint Online
%ProgramFiles%\Common Files\Microsoft Shared\web server extensions\16\ISAPI		 Búsqueda de consultas con el modelo de objetos de cliente administrado (Galería de código)
JavaScript CSOM SP.search.js
%ProgramFiles%\SharePoint Client Components\Scripts		 Búsqueda de consultas con el modelo de objetos de cliente de JavaScript (Galería de código)
Servicio REST http://server/_api/search/query

http://server/_api/search/postquery

http://server/_api/search/suggest		 Uso del servicio REST de búsqueda desde un complemento de SharePoint (Galería de código)

Consulta de búsqueda .NET CSOM

Para usar la consulta CSOM de .NET, cree una nueva instancia de la clase T:Microsoft.SharePoint.Client.ClientContext , que se encuentra en el espacio de nombres Microsoft.SharePoint.Client en el Microsoft.SharePoint.Client.dll. A continuación, use el modelo de objetos de consulta en el espacio de nombres Microsoft.SharePoint.Search.Client.Query .

A continuación puede ver un ejemplo simple.

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();
}

Ahora puede recorrer los resultados de la búsqueda. En el ejemplo siguiente se escribe el título de cada resultado.

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

Servicio REST de consulta de búsqueda

El servicio REST de consulta de búsqueda admite solicitudes POST y GET. Al realizar una llamada al servicio REST de búsqueda, se especifican los parámetros de consulta con la solicitud y la búsqueda usa estos parámetros de consulta para construir la consulta de búsqueda. Con una solicitud GET, se especifican los parámetros de consulta en la dirección URL. Para las solicitudes POST, se pasan los parámetros de consulta en el cuerpo del formato Notación de objetos de JavaScript (JSON).

Solicitudes JSON GET y POST

Verbo URI
Solicitudes GET http://server/_api/search/query
Solicitudes POST http://server/_api/search/postquery

Solicitudes GET de ejemplo para el Servicio de búsqueda REST

Tipo de solicitud Dirección URL de la solicitud
Palabras clave http://server/site/_api/search/query?querytext='{KQL Query}'
Seleccionar propiedades http://server/site/_api/search/query?querytext='test'&selectproperties='Title,Rank'
Ordenación 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 obtener una lista completa de los parámetros de consulta disponibles y cómo usarlos, vea Aspectos básicos del flujo de trabajo de SharePoint.

Para obtener código de ejemplo, vea Uso del servicio REST de búsqueda desde un complemento de SharePoint.

Complementos de búsqueda

Los complementos de SharePoint (anteriormente conocidos como aplicaciones para SharePoint) son elementos de funcionalidad independientes que amplían las capacidades de un sitio web de SharePoint. Los complementos de búsqueda (anteriormente conocidos como aplicaciones de búsqueda) son complementos de SharePoint que usan la funcionalidad de búsqueda. En un complemento de búsqueda, puede usar las API de consulta de búsqueda para recuperar los resultados de la búsqueda. Además, también puede usarlo para distribuir configuraciones de búsqueda de una instalación de SharePoint a otra.

Para obtener información sobre cómo configurar un entorno de desarrollo para crear complementos de búsqueda, vea Configurar un entorno de desarrollo local para complementos de SharePoint o Configurar un entorno de desarrollo para complementos de SharePoint en Office 365.

Permisos

Los complementos de búsqueda solo requieren permisos de nivel de usuario, donde el valor del atributo es QueryAsUserIgnoreAppPrincipal. Este permiso le permite consultar los complementos de búsqueda en función de los permisos del usuario. Esto significa que los resultados de la búsqueda se devuelven en función de las ACL del usuario. Para conceder permisos a los complementos para usar la búsqueda:

  1. En el Explorador de soluciones, abra AppManifest.xml.

  2. En la pestaña Permisos , seleccione Buscar ámbito y, a continuación, seleccione QueryAsUserIgnoreAppPrincipal.

Para obtener más información, vea Permisos de complementos en SharePoint.

API de consulta

Puede usar el CSOM de .NET, el CSOM de JavaScript o el servicio REST de búsqueda para recuperar los resultados de búsqueda en un complemento de búsqueda. En el ejemplo siguiente se muestra cómo usar el CSOM de .NET de consulta para recuperar los resultados de búsqueda en un complemento de búsqueda.

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();
}

Vea también