Administración del esquema de búsqueda (versión preliminar)
El esquema de búsqueda determina cómo se usa el contenido ingerido a través de un conector de Graph en varias experiencias de Microsoft Graph. El esquema define la estructura de cómo se recopila el contenido del origen de datos, se indexa, se consulta y se recupera del índice de búsqueda. Al cambiar el esquema de búsqueda, puede controlar qué pueden buscar los usuarios, cómo pueden buscarlo y cómo puede presentar los resultados en los puntos de conexión de Búsqueda de Microsoft.
El esquema de búsqueda contiene propiedades rastreadas, atributos de búsqueda, etiquetas semánticas y alias. En las secciones siguientes se definirán los distintos componentes de las funcionalidades de esquema y administración proporcionadas.
Nota:
Lea el artículo Configuración del conector de Graph para conocer las instrucciones generales de configuración de los conectores de Graph. Los pasos 6 y 7 definen el esquema al configurar una nueva conexión.
Nota:
Si desea modificar el esquema de búsqueda de SharePoint Online, lea Administrar el esquema de búsqueda en SharePoint.
Propiedades rastreadas
Para crear el índice de búsqueda, primero necesita rastrear el contenido. Puede rastrear varios orígenes de contenido como se muestra en la galería de conectores. El contenido y los metadatos de los elementos que rastrea se representan como propiedades rastreadas (o propiedades de origen).
Por ejemplo, en la tabla siguiente se presentan propiedades rastreadas de ejemplo para un conector del sistema de vales de trabajo.
| Propiedad | Tipo |
|---|---|
| ticketId | String |
| title | Cadena |
| createdBy | String |
| assignedTo | Cadena |
| lastEditedDate | DateTime |
| lastEditedBy | String |
| workItemType | String |
| priority | Int64 |
| tags | StringCollection |
| status | Cadena |
| url | Cadena |
| resolved | Booleano |
Nota:
- Para los conectores creados por Microsoft, las propiedades rastreadas se seleccionan en el paso 4 del artículo Configuración del conector de Graph .
Atributos de búsqueda
Content (propiedad)
Esta propiedad se usa para la indexación de texto completo del contenido, la generación de fragmentos de código de página de resultados de búsqueda, la participación del clúster de resultados , la detección de idioma, la compatibilidad con HTML/texto, la clasificación y la relevancia, y la formulación de consultas.
Si selecciona una propiedad de contenido, tiene la opción de usar la propiedad generada por el sistema ResultSnippet al crear el tipo de resultado. Esta propiedad actúa como marcador de posición para los fragmentos de código dinámicos que se generan a partir de la propiedad de contenido en tiempo de consulta. Si usa esta propiedad en el tipo de resultado, los fragmentos de código se generan en los resultados de la búsqueda.
Permite la búsqueda
Si una propiedad se puede buscar, su valor se agrega al índice de texto completo. Cuando un usuario lleva a cabo una búsqueda, devolvemos resultados si el término se encuentra en alguno de los campos que se pueden buscar o en su contenido.
Una búsqueda de "diseño" que muestra los resultados de los aciertos en la propiedad ( title ) y el contenido.
Consultable
Si una propiedad es consultable, puede realizar consultas en ella mediante el lenguaje de consulta de conocimiento (KQL). KQL consta de una o varias palabras clave de texto libre (palabras o frases) o restricciones de propiedad. El nombre de la propiedad debe incluirse en la consulta, sea especificado en la consulta misma o incluido en la consulta por programación. Puede usar la coincidencia de prefijos con el operador comodín(*).
Nota:
No se admite la coincidencia de sufijos.
Búsqueda de "search ba*" que muestra los resultados que coinciden con este prefijo.
Búsqueda de "tags:design" que establece el ámbito de los resultados en elementos con "diseño" en la propiedad tags.
Recuperable
Si una propiedad es recuperable, se puede devolver su valor en los resultados de la búsqueda. Cualquier propiedad que quiera agregar en la plantilla para mostrar o que se devuelva de la consulta y sea relevante en los resultados de la búsqueda se debe poder recuperar. Marcar propiedades grandes o excesivas como recuperables aumenta la latencia de búsqueda. Sea selectivo y elija propiedades relevantes.
Un conjunto de propiedades recuperables (title y lastEditedBy) que se representan como resultado.
Se puede restringir
Si una propiedad se puede restringir, el administrador puede configurarla como filtro personalizado en la página de resultados de Búsqueda de Microsoft. Una refinable propiedad no puede ser searchable.
Restringir los resultados por tags, una propiedad restringible.
Nota:
- En el caso de los conectores creados por Microsoft, los atributos de búsqueda se seleccionan en el paso 7 del artículo Configuración del conector de Graph .
Etiquetas semánticas
Una etiqueta semántica es una etiqueta conocida publicada por Microsoft que puede agregar en una propiedad del esquema. Agregar una etiqueta semántica ayuda a varios productos de Microsoft a comprender la propiedad y proporcionar una mejor experiencia.
Las etiquetas semánticas proporcionan un enfoque independiente del dominio para asignar propiedades de diferentes dominios de contenido a un conjunto de clases conocidas. Encuentran aplicaciones en muchas experiencias de contenido diferentes y proporcionan compatibilidad automatizada con tareas como son:
- Integración de datos en experiencias heterogéneas
- Creación de gráficos de conocimiento comunes (por ejemplo, temas)
- Plantillas predeterminadas para experiencias de usuario
Las etiquetas proporcionan significado semántico y permiten integrar los datos del conector en experiencias de Microsoft 365.
| Etiqueta | Description |
|---|---|
| title | El título del elemento que desea que se muestre en la búsqueda y otras experiencias. |
| url | Dirección URL de destino del elemento en el origen de datos. |
| createdBy | Nombre de la persona que creó el elemento en el origen de datos. |
| lastModifiedBy | Nombre de la persona que editó el elemento más recientemente en el origen de datos. |
| authors | Los nombres de todas las personas que han participado o colaborado en el elemento en el origen de datos. |
| createdDateTime | Fecha y hora en que se creó el elemento en el origen de datos. |
| lastModifiedDateTime | Fecha y hora en que el elemento se modificó por última vez en el origen de datos. |
| fileName | En el caso de un archivo, el nombre del archivo en el origen de datos. |
| fileExtension | En el caso de un archivo, la extensión del archivo en el origen de datos. |
| iconUrl | Dirección URL de un icono. |
Por ejemplo, la propiedad rastreada lastEditedBy tiene el mismo significado que la etiqueta de Microsoft lastModifiedBy.
Importante
Todas las propiedades que asigne a las etiquetas deben ser recuperables.
El título de la etiqueta es la etiqueta más importante. Asegúrese de asignar una propiedad a esta etiqueta para permitir que la conexión participe en la experiencia del clúster de resultados. La asignación incorrecta de etiquetas degrada la experiencia de búsqueda. Es correcto que algunas etiquetas no tengan una propiedad asignada.
Nota:
- Para los conectores creados por Microsoft, las etiquetas semánticas se seleccionan en el paso 6 del artículo Configuración del conector de Graph .
Alias
Los alias son nombres descriptivos para las propiedades que usted asigna. Se usan en consultas y selecciones en filtros de propiedades refinables.
Nota:
- En el caso de los conectores creados por Microsoft, los alias se definen en el paso 7 del artículo Configuración del conector de Graph .
Capacidades de actualización de esquema
En esta sección se incluye información sobre las funcionalidades de actualización para el esquema de búsqueda de conectores de Graph creados por Microsoft.
Nota:
Se recomienda ejecutar un rastreo completo después de una actualización para llevarlos al esquema más reciente. Sin un rastreo completo, el comportamiento de los elementos será incoherente.
Administrar esquema
- En el Centro de administración de Microsoft 365, vaya a la página Esquema de la sección Personalización.
- Haga clic en Ver detalles en Esquema de conectores de Graph.
- Seleccione la conexión para la que desea actualizar el esquema y haga clic en Personalizar esquema.
- Después de realizar los cambios de esquema necesarios, haga clic en Publicar cambios de esquema para publicar el nuevo esquema.
Adición de una propiedad rastreada
Puede agregar una propiedad al esquema. Al agregar una propiedad, puede incluir todos los atributos de búsqueda que necesite.
Adición de una nueva propiedad de origen a partir de la lista de propiedades admitidas por conector
Importante
No se puede eliminar una propiedad existente para una conexión publicada. Para quitar una propiedad, debe eliminar y volver a crear una conexión.
Agregar o quitar una funcionalidad de búsqueda
Puede agregar o quitar atributos de búsqueda específicos a una propiedad. Agregar una funcionalidad de búsqueda requiere un rastreo completo.
Actualización de las anotaciones de búsqueda para las propiedades rastreadas
Importante
- No se puede quitar un atributo de búsqueda recuperable de una propiedad.
- No se puede agregar o quitar el atributo de búsqueda refinable a una propiedad.
Agregar o quitar una etiqueta semántica
Puede agregar o actualizar la asignación de etiquetas semánticas de las propiedades rastreadas.
Actualización de etiquetas semánticas para propiedades rastreadas
Agregar o quitar un alias
Puede agregar o quitar alias y usarlos para las consultas de búsqueda.
Adición o eliminación de un alias para las propiedades rastreadas