Compartir a través de


Cómo mostrar valores de propiedades administradas personalizadas en los resultados de búsqueda clásicos: opción 1 en SharePoint Server

SE APLICA A:yes-img-132013 yes-img-162016 yes-img-192019 yes-img-seSubscription Edition no-img-sopSharePoint en Microsoft 365

En este artículo, aprenderá:

Cómo mostrar un icono personalizado

En Descripción de cómo se muestran los resultados de la búsqueda en SharePoint Server, explicamos cómo se muestran los iconos Word, PDF y Excel para los resultados de búsqueda clásicos. En nuestro escenario del centro de búsqueda, queríamos agregar el siguiente icono personalizado junto a todos los resultados de la búsqueda que pertenecen al recién creado tipo de resultado contenido de TechNet:

TN

Para mostrar un icono personalizado para los resultados de búsqueda clásicos, esto es lo que debe hacer:

  1. Agregue el icono personalizado a una biblioteca de SharePoint Server.

    En nuestro escenario de centro de búsqueda, agregamos el icono personalizado a la biblioteca Imágenes.

    Icono agregado

  2. Abra la plantilla para mostrar elementos a la que se hace referencia desde el tipo de resultado para el que desea mostrar un icono personalizado.

    En nuestro escenario de centro de búsqueda, también quitamos la instrucción if: if (ctx.CurrentItem.IsContainer).

    Icono personalizado de plantilla para mostrar

  3. En una página de búsqueda, escriba una consulta que desencadene el nuevo tipo de resultado.

  4. En nuestro escenario del Centro de búsqueda, escribimos "tipo de resultado". Los resultados de búsqueda que son publicaciones de TechNet ahora tienen un icono personalizado junto a ellos. ¡Genial!

    Icono mostrado

Así que los usuarios de nuestro centro de búsqueda ahora podrían distinguir fácilmente los resultados de búsqueda que se publicaron en TechNet. Pero también queríamos agregar información de columnas de sitio personalizadas para que los usuarios puedan ver información importante sobre cada resultado de búsqueda sin tener que hacer clic en él.

En Descripción de cómo se muestran los resultados de la búsqueda en SharePoint Server , explicamos que las columnas de sitio se "transforman" en propiedades administradas durante el rastreo. También explicamos que solo las propiedades administradas que aparecen en una plantilla para mostrar elementos se pueden mostrar en los resultados de la búsqueda. Así que, para mostrar información personalizada en sus resultados de la búsqueda, debe agregar propiedades administradas a una plantilla para mostrar elementos. Por lo tanto, lo siguiente que debe hacer es buscar el nombre de la propiedad administrada que corresponde a la columna de sitio personalizada que quiere usar.

Cómo encontrar un nombre de propiedad administrada

Antes de empezar a buscar un nombre de propiedad administrada, es importante que sepa un poco sobre la convención de nomenclatura de las propiedades administradas. Para obtener más información sobre esto, vea Acerca de la convención de nomenclatura para las propiedades administradas y rastreadas que se crean automáticamente.

Según su nivel de permisos, puede buscar propiedades administradas desde tres lugares:

Nivel de permisos Buscar desde esta ubicación
Administrador de la aplicación de servicio de búsqueda
Administración central --> Aplicación de servicio administrada --> Aplicación de servicio de búsqueda --> Esquema de búsqueda
Administrador de la colección de sitios
Configuración del sitio --> Esquema de búsqueda (en la sección Administración de la colección de sitios)
Propietario de la colección de sitios
Configuración del sitio --> Esquema (en la sección Buscar)

Esto es lo que debe hacer:

  1. Vaya a Configuración del sitio>Esquema de búsqueda.

    Esquema de búsqueda

  2. En la página Propiedades administradas , en el campo Propiedad administrada , escriba el nombre de la columna de sitio de la que desea encontrar el nombre de la propiedad administrada. Recuerde que los nombres de las propiedades administradas no contienen espacios. Por lo tanto, si el nombre de su columna de sitio contiene un espacio, omítalo.

    En nuestro escenario de centro de búsqueda, queríamos buscar el nombre de la propiedad administrada de la columna de sitio Resumen de contenido. Hemos escrito ContentSummary en el campo Propiedad administrada y hemos seleccionado el icono de flecha verde.

    Resumen de búsqueda de contenido

    Se devolvió un resultado de búsqueda: ContentSummaryOWSMTXT.

    Resumen de contenido

    Como la columna de sitio Resumen de contenido es de tipo Varias líneas de texto, sabíamos que este era el nombre de la propiedad administrada que queríamos usar.

  3. Repita los pasos de este procedimiento para buscar los nombres de todas las propiedades administradas que quiere mostrar en los resultados de la búsqueda.

Ahora que ha encontrado los nombres de las propiedades administradas que quiere mostrar en los resultados de la búsqueda, el siguiente paso es cambiar la plantilla para mostrar elementos.

Cómo cambiar una plantilla para mostrar elementos para mostrar valores de propiedades administradas: opción 1

En Descripción de cómo se muestran los resultados de la búsqueda en SharePoint Server , hemos mencionado que hay varias maneras de cambiar una plantilla de presentación de elementos para mostrar valores de propiedades administradas personalizadas. La opción que se explica en esta sección es muy sencilla. Trataremos la segunda opción en el siguiente artículo de la serie. No se incluyen instrucciones if y no se aplica el resaltado de referencias.

Esto es lo que debe hacer:

  1. Abra la plantilla para mostrar elementos que pertenece al tipo de resultado para el que desea personalizar los resultados de la búsqueda.

    En nuestro escenario del Centro de búsqueda era Contenido de TechNet.

  2. En la plantilla para mostrar elementos, en la etiqueta ManagedPropertyMapping, use la siguiente sintaxis para agregar las propiedades administradas personalizadas que desea que se muestren:

'<Current item property name>':<Managed property name>'

En nuestro escenario del Centro de búsqueda, queríamos que los valores de las propiedades administradas ContentSummaryOWSMTXT y owstaxIdTechnicalSubject aparecieran en el resultado de la búsqueda. Para facilitar el mantenimiento del archivo, le asignamos a las propiedades del elemento actual el mismo nombre que el de las propiedades administradas.

Agregar MP

  1. Dentro de la segunda etiqueta <div> en el <body>, use la siguiente sintaxis para agregar código que mostrará el valor de la propiedad administrada personalizada:
_#= ctx.CurrentItem.<Current item property name> =#

En nuestro escenario de centro de búsqueda, agregamos lo siguiente a la plantilla para mostrar elementos:

<div>_#= ctx.CurrentItem. ContentSummaryOWSMTXT =#_</div>
<div>_#= ctx.CurrentItem. owstaxIdTechnicalSubject =#></div>

Mostrar dos nuevos MP

  1. Guarde la plantilla para mostrar elementos.

    Nota:

    No es necesario realizar este paso si usa SharePoint en Microsoft 365. Vaya a Configuración del sitio>Tipos de resultados de búsqueda. Aparece una alerta de sincronización de propiedades.

    Alerta de sincronización de propiedades

    Esta alerta se muestra porque agregamos propiedades administradas a una plantilla para mostrar elementos (lo que hicimos en el paso 2). Para actualizar los tipos de resultado con las propiedades administradas recién agregadas, seleccione Actualizar.

    MPs actualizados

    Importante

    Si no aplica esta actualización, las propiedades administradas recién agregadas no se mostrarán en los resultados de la búsqueda.

    Después de realizar este cambio, cuando los usuarios escribieron una consulta en nuestro Centro de búsqueda, tanto el valor de ContentSummaryOWSMTXT como el valor de owstaxIdTechnicalSubject aparecieron en los resultados de la búsqueda.

    Elemento de lista de resultados de búsqueda

    Aunque aparecieran dos propiedades personalizadas en los resultados de la búsqueda, el resultado no era completamente correcto. Por ejemplo, queríamos mostrar las dos propiedades personalizadas entre el título y el vínculo, y no debajo del vínculo tal como sucede actualmente.

Para entender mejor por qué los resultados de la búsqueda se mostraban de esa forma, vamos a echar un vistazo a la plantilla para mostrar elementos personalizada:

Flujo de plantilla para mostrar

  1. ctx.CurrentItem.csr_Icon apunta a la ubicación de mi icono personalizado. La plantilla para mostrar Item_CommonItem_Body usaba esta variable.

  2. _#=ctx.RenderBody(ctx)=#_ llama a la plantilla para mostrar Item_CommonItem_Body . (Recuerde comprender cómo funcionan las plantillas de visualización de elementos y el resaltado de pulsaciones en SharePoint Server. La plantilla para mostrar Item_CommonItem_Body muestra el icono personalizado, el título y el vínculo al elemento).

  3. _#= ctx.CurrentItem.ContentSummaryOWSMTXT =#_ y _#= ctx.CurrentItem.owstaxIdTechnicalSubject =#_ mostrar los valores de las dos propiedades administradas, ContentSummaryOWSMTXT y owstaxIdTechnicalSubject.

Para mostrar las propiedades personalizadas entre el título y el vínculo, puede quitar el Item_CommonItem_Body plantilla para mostrar eliminando la referencia _#=ctx.RenderBody(ctx)=#_ de la plantilla de presentación personalizada. A continuación, puede agregar las propiedades en el orden en que quiera mostrarlas, por ejemplo de la siguiente forma:

Quitar referencia

El resultado de la búsqueda tendría el siguiente aspecto:

Resultados sin referencia común

Si trabaja un poco más en la aplicación de estilos, podría tener un mejor resultado. Sin embargo, al eliminar la referencia a _#=ctx.RenderBody(ctx)=#_ , la plantilla de presentación de Item_CommonItem_Body ya no se usa para mostrar los resultados. La plantilla para mostrar Item_CommonItem_Body contiene algunas funciones que mejorarán automáticamente la relevancia de los resultados de búsqueda clásicos. Por lo tanto, antes de eliminar la referencia _#=ctx.RenderBody(ctx)=#_, debe considerar si la relevancia mejorada de forma automática es algo de lo que podrían beneficiarse los usuarios de su sitio de búsqueda.

Acerca del seguimiento de clics y la relevancia mejorada de forma automática

La plantilla para mostrar Item_CommonItem_Body contiene un método onlick que hace un seguimiento del comportamiento de clic de los usuarios. Este seguimiento influye en la relevancia de los resultados de búsqueda clásicos. Por ejemplo, un resultado de búsqueda en el que los usuarios suelen hacer clic se mostrará automáticamente en la parte superior de los resultados de la búsqueda.

Importante

Si desea que los resultados de búsqueda clásicos reciban una relevancia mejorada automáticamente en función del comportamiento de clic de los usuarios, no elimine la referencia a _#=ctx.RenderBody(ctx)=#_ de la plantilla de presentación de elementos.

En el siguiente artículo, explicaremos cómo puede mantener esta referencia, mostrar propiedades personalizadas entre el título y el vínculo en los resultados de búsqueda clásicos y aplicar también el resaltado de aciertos a las propiedades personalizadas.

Próximo artículo de esta serie

Cómo mostrar valores de propiedades administradas personalizadas en los resultados de búsqueda: opción 2 en SharePoint Server