Modificar la experiencia de búsqueda de Microsoft con las extensiones de SharePoint Framework
La versión SharePoint Framework v1.10 presenta extensiones de consulta de búsqueda. Se trata de extensiones SharePoint Framework (SPFx), que se pueden usar para modificar la consulta de búsqueda ejecutada mediante la experiencia de búsqueda.
Nota:
Esta característica está actualmente en versión preliminar para desarrolladores. Para usar características en la versión preliminar del desarrollador, asegúrese de usar la --plusbeta versión del paquete. Para obtener más información, vea: Probar SharePoint Framework funcionalidades de versión preliminar.
Importante
Incluso pensaba que esta extensión está disponible en la versión SharePoint Framework v1.10, no se admite en SharePoint Online.
Una extensión de consulta actúa como una extensión de SharePoint Framework normal, pero se invocará justo antes de que se ejecute la consulta de búsqueda, de modo que la consulta pueda modificarse potencialmente. Durante la versión preliminar, las extensiones de consulta tienen las siguientes características:
- Las extensiones de consulta solo funcionan en el contexto de SharePoint
- Tendrá que habilitar explícitamente las extensiones de consulta en el sitio o en el ámbito de la colección de sitios.
- Las extensiones de consulta solo funcionan cuando la colección de sitios está asociada para usar una página de resultados de búsqueda personalizada
- La página de resultados de búsqueda personalizada puede usar el nuevo diseño de página HeaderlessSearchResults para reducir el contenido del encabezado.
- El diseño de página HeaderlessSearchResults solo se admite para las páginas asociadas como página de resultados de búsqueda personalizada
- Puede proporcionar una experiencia de búsqueda moderna mediante la solución de experiencia de búsqueda moderna de código abierto.
Proceso de desarrollo
Puede empezar a desarrollar extensiones de consulta simplemente con los paquetes SharePoint Framework v1.10 o posteriores. Dado que esta característica está en estado de vista previa, tendrá que ejecutar el generador de Yeoman mediante el --plusbeta modificador como se muestra a continuación.
yo @microsoft/sharepoint --plusbeta
Puede ver una nueva opción denominada Modificador de consulta de búsqueda en la selección de extensión para aplicar scaffolding a un componente de extensión de consulta.
Asociación de extensiones de consulta a sitios
La extensión de consulta está asociada de forma predeterminada en una colección de sitios cuando se instala una solución que contiene la extensión en el sitio. Esto sucede automáticamente con las definiciones de Feature Framework empaquetadas automáticamente como parte del paquete de solución. Técnicamente, esta asociación se realiza mediante la UserCustomAction colección con ClientSideExtension.SearchQueryModifier como Location atributo .
Al crear una nueva solución con el modificador de consulta de búsqueda, se incluye el siguiente archivo elements.xml :
<?xml version="1.0" encoding="utf-8"?>
<Elements xmlns="http://schemas.microsoft.com/sharepoint/">
<CustomAction
Title="QueryModifyer"
Location="ClientSideExtension.SearchQueryModifier"
ClientSideComponentId="801f82d5-1a21-4b2c-94b6-f13f6672142c"
ClientSideComponentProperties="{"testMessage":"Test message"}">
</CustomAction>
</Elements>
Técnicamente, también puede usar la implementación con ámbito de inquilino de extensiones de SharePoint Framework para asociar automáticamente la extensión a varias colecciones de sitios de un inquilino.
Implementación de la extensión
La implementación es un proceso de dos pasos de forma predeterminada para el modificador de consulta de búsqueda al menos durante la versión preliminar:
- Implementación de una solución en el catálogo de aplicaciones de SharePoint
- Instalar la solución en la colección de sitios donde desea usar la extensión
- Crear una página de resultados de búsqueda personalizada y configurarla para que se use en la colección de sitios
Para configurar la página de resultados de búsqueda personalizados para una colección de sitios desde la configuración del sitio, haga clic en Configuración de búsqueda y, a continuación, habilite la opción de experiencia de búsqueda personalizada.
