Configuración de conectores de Microsoft Graph en el Centro de administración de Microsoft 365
En este artículo se muestra el proceso básico necesario para configurar conectores de Microsoft Graph en el Centro de administración de Microsoft 365. El proceso básico incluye los pasos siguientes:
- Agregar un conector de Microsoft Graph en el Centro de administración de Microsoft 365
- Asignar un nombre a la conexión
- Establecer la configuración de conexión
- Seleccionar propiedades
- Administrar los permisos de búsqueda
- Asignar etiquetas de propiedad
- Administrar esquema
- Actualizar configuración
- Revisar la conexión
- Administrar los resultados de la conexión
- Personalizar la página de resultados de búsqueda
En este artículo también se incluye la siguiente información:
Nota:
El proceso de instalación es similar para todos los conectores de Microsoft Graph, pero no es exactamente el mismo. Además de leer este artículo, asegúrese de leer la información específica del conector para el origen de datos.
Paso 1: Agregar un conector de Microsoft Graph en el Centro de administración de Microsoft 365
Complete los pasos siguientes para configurar cualquiera de los conectores de Microsoft Graph (o haga clic aquí para acceder directamente al catálogo de conectores):
Inicie sesión en la cuenta de administrador en el Centro de administración de Microsoft 365.
En el panel de navegación, seleccione Configuración y, a continuación, seleccione Buscar & inteligencia. Seleccione la pestaña Orígenes de datos.
Seleccione +Agregar y, a continuación, seleccione el origen de datos de su elección en el menú de opciones disponibles.
Nota:
Puede agregar un máximo de treinta (30) conexiones de Microsoft Graph a cada inquilino.
Paso 2: Asignar un nombre a la conexión
Especifique estos atributos:
- Name (obligatorio)
- Identificador de conexión (obligatorio)
- Descripción (opcional)
- Active la casilla (obligatorio)
El identificador de conexión crea propiedades implícitas para el conector. Solo debe contener caracteres alfanuméricos y tener un máximo de 32 caracteres.
Paso 3: Configurar las opciones de conexión
El proceso para configurar las opciones de conexión varía en función del tipo de origen de datos. Para ver el tipo de origen de datos que se va a agregar al inquilino para completar este paso en el proceso de instalación, consulte la información específica del conector.
Para más información sobre cómo conectarse a un origen de datos local, consulte Configuración del agente del conector de Microsoft Graph.
Paso 4: Seleccionar propiedades
Puede elegir las propiedades indizadas por Microsoft Search.
Nota:
Para actualizar las propiedades rastreadas después de crear una conexión, consulte el artículo Administrar esquema de búsqueda .
Paso 5: Administrar permisos de búsqueda
Las listas de control de acceso (ACL) determinan qué usuarios de su organización pueden acceder a cada elemento.
Algunos conectores, como Microsoft SQL y Azure Data Lake Storage Gen2 admiten de forma nativa Microsoft Entra ACL de identificador.
Otros conectores como ServiceNow Knowledge, ServiceNow Catalog, Azure DevOps Work Items y Salesforce admiten la sincronización de usuarios y grupos que no son de Azure AD.
La selección de todos permite a todos los usuarios de su organización ver los resultados de búsqueda de este origen de datos.
Paso 6: Asignar etiquetas de propiedad
Puede asignar etiquetas semánticas a las propiedades de origen en la página "Asignar etiquetas de propiedad". Las etiquetas son etiquetas conocidas proporcionadas por Microsoft que proporcionan significado semántico. Permiten a Microsoft integrar los datos del conector en experiencias de Microsoft 365, como búsqueda mejorada, tarjetas de personas, detección inteligente, etc.
En la tabla siguiente se enumeran las etiquetas admitidas actualmente y sus descripciones.
| Etiqueta | Descripción |
|---|---|
| title | 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 sistema de origen |
| Creado por | Nombre de la persona que creó el elemento |
| Última modificación | Nombre de la persona que editó el elemento más recientemente |
| Authors | Nombre de las personas que participaron o colaboraron en el elemento |
| Fecha y hora de creación | Hora en que se creó el elemento |
| Fecha de la última modificación | Hora en que se editó el elemento más recientemente |
| Nombre de archivo | Nombre del elemento de archivo |
| Extensión de archivo | Tipo de elemento de archivo, como .pdf o .word |
Las propiedades de esta página se seleccionan previamente en función del origen de datos, pero puede cambiar esta selección si hay una propiedad diferente que sea más adecuada para una etiqueta determinada.
El título de la etiqueta es la etiqueta más importante. Se recomienda encarecidamente que tenga una propiedad asignada a esta etiqueta para que la conexión participe en la experiencia del clúster de resultados.
La asignación incorrecta de etiquetas provoca una experiencia de búsqueda deteriorada. Está bien que algunas etiquetas no tengan una propiedad asignada.
Paso 7: Administrar esquema
Content (propiedad)
Se recomienda seleccionar una propiedad de contenido en el menú desplegable de opciones o mantener el valor predeterminado si está presente. 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.
Alias para propiedades de origen
Puede agregar alias a las propiedades en la columna "Alias" de la página "Administrar esquema". Los alias son nombres descriptivos para las propiedades. Se usan en consultas y en la creación de filtros. También se usan para normalizar las propiedades de origen de varias conexiones de modo que tengan el mismo nombre. De este modo, puede crear un único filtro para un vertical con varias conexiones. Para obtener más información, vea Personalizar la página de resultados de búsqueda.
Atributos de esquema de búsqueda
Puede establecer los atributos del esquema de búsqueda para controlar la funcionalidad de búsqueda de cada propiedad de origen. Un esquema de búsqueda ayuda a determinar qué resultados se muestran en la página de resultados de búsqueda y qué información pueden ver y acceder los usuarios finales.
Los atributos de esquema de búsqueda incluyen opciones para consultar, buscar, recuperar y refinar. En la tabla siguiente se enumeran cada uno de los atributos que admiten los conectores de Microsoft Graph y se explican sus funciones.
| Atributo de esquema de búsqueda | Función | Ejemplo |
|---|---|---|
| BÚSQUEDA | Hace que el contenido de texto de una propiedad pueda buscarse. El contenido de la propiedad se incluye en el índice de texto completo. | Si la propiedad es title, una consulta de Enterprise devuelve respuestas que contienen la palabra Enterprise en cualquier texto o título. |
| CONSULTA | Busca por consulta una coincidencia de una propiedad determinada. A continuación, el nombre de la propiedad se puede especificar en la consulta mediante programación o textual. | Si se puede consultar la propiedad Title , se admite la consulta Title: Enterprise . |
| RECUPERAR | Solo se pueden usar propiedades recuperables en el tipo de resultado y mostrarse en el resultado de la búsqueda. | |
| REFINAR | La opción refinar se puede usar como en la página de resultados de Búsqueda de Microsoft. | Los usuarios de su organización pueden filtrar por dirección URL en la página de resultados de búsqueda si la propiedad refine está marcada durante la configuración de la conexión. |
Para todos los conectores excepto el conector de recurso compartido de archivos, los tipos personalizados se deben establecer manualmente. Para activar las funcionalidades de búsqueda de cada campo, necesita un esquema de búsqueda asignado a una lista de propiedades. La configuración de conexión asistente selecciona automáticamente un esquema de búsqueda basado en el conjunto de propiedades de origen que elija. Para modificar este esquema, active las casillas de cada propiedad y atributo de la página de esquema de búsqueda.
Restricciones y recomendaciones para la configuración del esquema de búsqueda
La propiedad de contenido solo se puede buscar. Después de seleccionarla en la lista desplegable, esta propiedad no se puede usar con las opciones recuperar o consultar.
Se producen problemas de rendimiento significativos cuando los resultados de la búsqueda se representan con la propiedad de contenido . Un ejemplo es el campo Contenido de texto de un artículo de base de conocimiento de ServiceNow .
Solo las propiedades marcadas como representación recuperable en los resultados de búsqueda y se pueden usar para crear tipos de resultados modernos (MRT).
Solo las propiedades de cadena se pueden marcar como búsquedas.
Nota:
Para actualizar el esquema después de crear una conexión, consulte el artículo Administrar esquema de búsqueda .
Paso 8: Actualizar configuración
El intervalo de actualización determina la frecuencia con la que se sincronizan los datos entre el origen de datos y Microsoft Search. Cada tipo de origen de datos tiene un conjunto diferente de programaciones de actualización óptimas en función de la frecuencia con la que se modifican los datos y el tipo de modificaciones.
Hay dos tipos de intervalos de actualización: Actualización completa y Actualización incremental, pero las actualizaciones incrementales no están disponibles para algunos orígenes de datos.
Con una actualización completa, el motor de búsqueda procesa e indexa los elementos que han cambiado en el origen de contenido, independientemente de los rastreos anteriores. Una actualización completa funciona mejor para estas situaciones:
- Detección de eliminaciones de datos.
- La actualización incremental encontró errores y produjo un error.
- Se modificaron las ACL.
- Se modificaron las reglas de rastreo.
- Se ha actualizado el esquema de la conexión.
Con una actualización incremental, el motor de búsqueda puede procesar e indexar solo los elementos que se crearon o modificaron desde el último rastreo correcto. Como resultado, no todos los datos del origen de contenido se vuelven a indexar. Las actualizaciones incrementales funcionan mejor para detectar contenido, metadatos y otras actualizaciones.
Nota:
Los rastreos incrementales no admiten actualmente el procesamiento de actualizaciones de permisos.
Las actualizaciones incrementales son mucho más rápidas que las actualizaciones completas porque no se procesan los elementos sin cambios. Sin embargo, si decide ejecutar actualizaciones incrementales, deberá ejecutar actualizaciones completas periódicamente para mantener la sincronización de datos correcta entre el origen de contenido y el índice de búsqueda.
Programación de rastreo
Puede configurar rastreos completos e incrementales en función de las opciones avanzadas de programación presentes en la página Actualizar configuración. Algunos conectores no admiten rastreos incrementales y la opción para configurar rastreos incrementales no estará disponible para esos conectores. Para otros, el rastreo incremental es un rastreo opcional y está habilitado de forma predeterminada. De forma predeterminada, se selecciona una programación de rastreo en función del tipo de conector. Esta configuración predeterminada se puede cambiar durante la creación o edición de la conexión después de publicar una conexión desde el flujo "Editar" de una conexión. Puede elegir entre estos campos:
- Periodicidad: puede optar por ejecutar los rastreos cada día, semana, segunda o cuarta semana.
- Día(s): esta opción está habilitada cuando elige ejecutar rastreos solo en días específicos de la semana.
- La casilla Ejecutar una vez al día le permite elegir la hora de inicio del rastreo en un día. Si no está seleccionado, los rastreos se repetirán en un día de forma predeterminada. Puede elegir el intervalo de repetición en la lista desplegable.
- Frecuencia: seleccione esta opción si desea repetir rastreos en un día después de determinados intervalos de tiempo. La frecuencia de repetición más pequeña es de 15 minutos y la mayor es de 12 horas.
- Hora de inicio: seleccione la hora a la que desea que se inicie el rastreo.
- Restablecer: esto restablecerá la programación a la programación predeterminada del conector.
Estos son algunos puntos a tener en cuenta al configurar la programación de rastreo:
- Si deja alguno de los campos vacíos o no seleccionados, los conectores de Graph elegirán el mejor momento para iniciar un rastreo. Por ejemplo, si elige una periodicidad de rastreo como "Día" y no selecciona la hora de inicio, los conectores de Graph elegirán la hora en función del último rastreo para iniciar el nuevo rastreo. Si no desea especificar una hora de inicio del rastreo, se recomienda permitir que el conector decida cuándo iniciar el rastreo.
- Incluso si se menciona la hora de inicio, el inicio del rastreo puede retrasarse una hora. Esto puede deberse a motivos como la carga de red, etc.
- Si el rastreo anterior se satura a la hora del siguiente rastreo, no se detiene el rastreo en curso y se pone en cola el siguiente rastreo. Una vez completado el rastreo en curso, ejecutamos el rastreo en cola solo si es de un tipo diferente (completo o incremental) que el rastreo anterior. Por ejemplo, si un rastreo incremental satura el siguiente rastreo completo, no suspenderemos el rastreo incremental y poneremos en cola el rastreo completo. Después de completar el rastreo incremental, dado que el rastreo en cola es de otro tipo (completo), iniciaremos el rastreo completo inmediatamente.
Estos son algunos de los escenarios:
- Ejecución del rastreo incremental diario después de cada 15 minutos
Aquí, al seleccionar la casilla "Ejecutar una vez al día", podrá elegir la "Hora de inicio" para ejecutar el rastreo incremental solo una vez al día a partir de la hora especificada. Sin embargo, al anular la selección, podrá elegir la frecuencia de repeticiones de rastreo en un día. Si desea que los datos se actualicen continuamente, puede optar por ejecutar rastreos incrementales con frecuencia en un día. Pero si el número de elementos del origen de datos es grande y los rastreos tienden a ser más largos, o si no se necesitan actualizaciones frecuentes para el contenido, puede elegir el rastreo incremental para que se ejecute una vez al día.
- Ejecute el rastreo incremental cada semana los miércoles, sábados y domingos repitiendo cada 15 minutos y a partir de la 1:00 a.m.
- Ejecutar rastreo completo todos los días a la 1:00 AM
- Ejecutar rastreo completo cada semana el viernes a las 8:00 p.m.
Paso 9: Revisión de la conexión
Puede revisar toda la configuración y editar la configuración según sea necesario antes de completar la conexión. Asegúrese de leer la información específica del conector para el origen de datos si aún no lo ha hecho. Cuando esté listo para completar la conexión, seleccione Publicar.
Lanzamiento preconfigurado
El lanzamiento provisional es una característica que le permite introducir gradualmente conectores de Microsoft Graph a un grupo selecto de usuarios en el entorno de producción. Seleccione Publicar en usuarios limitados para implementar el conector en una audiencia limitada. Para obtener más información, vea Lanzamiento provisional para conectores de Microsoft Graph.
Paso 10: Administrar los resultados de la conexión
Los resultados de la conexión se incluirán en la vertical Todo de forma predeterminada después de su publicación. Si no desea que los resultados de la conexión estén disponibles inmediatamente en Todo después de que se haya publicado, puede optar por no participar en este paso.
Paso 11: Personalizar la página de resultados de búsqueda
Después de publicar la conexión, es posible que desee personalizar la página de resultados de búsqueda con verticales y tipos de resultados. Para obtener información sobre cómo personalizar los resultados de la búsqueda, revise cómo administrar los tipos de resultados y verticales.
Paso 12: Confirmar si la configuración de conexión funcionó
Vaya a la lista de las conexiones publicadas en la pestaña Conectores del Centro de administración. Para obtener información sobre cómo realizar actualizaciones y eliminaciones, consulte Supervisión de las conexiones.
Solución de problemas
Lea la información específica del conector para el origen de datos.
Nota:
Actualmente, no todos los artículos específicos del conector incluyen recomendaciones de solución de problemas.
Limitaciones
Para obtener información sobre las limitaciones que se aplican a todos los orígenes de datos, consulte el artículo Información general de los conectores de Microsoft Graph .
Consulte la información específica del conector del origen de datos para averiguar si se aplican otras limitaciones a ese conector de Microsoft Graph concreto.