Introducción al programa de instalación de los conectores de Graph en MicrosoftSetup overview for Graph connectors by Microsoft

En este artículo se resume el proceso básico necesario para usar el centro de administración de microsoft 365 para configurar cualquiera de los conectores de Graph por parte de Microsoft.This article summarizes the basic process required to use the Microsoft 365 admin center to setup any of the Graph connectors by Microsoft. El proceso básico incluye los pasos siguientes:The basic process includes the following steps:

  1. Agregue un conector de Graph en el centro de administración de Microsoft 365.Add a Graph connector in the Microsoft 365 admin center.
  2. Asigne un nombre a la conexión.Name the connection.
  3. Configure las opciones de conexión.Configure the connection settings.
  4. Administrar permisos de búsqueda.Manage search permissions.
  5. Asignar etiquetas de propiedades.Assign property labels.
  6. Administrar esquema.Manage schema.
  7. Elija Actualizar configuración.Choose refresh settings.
  8. Revise la conexión.Review the connection.

Es importante tener en cuenta que el proceso de instalación es muy similar para todos los conectores de Graph de Microsoft, pero no es exactamente el mismo.It is important to note that the setup process is very similar for all the Graph connectors by Microsoft but is not exactly the same. Además de leer este artículo, asegúrese de leer el conector específico para su origen de datos.In addition to reading this article, be sure to read the connector-specific for your data source.

Paso 1: agregar un conector de Graph en el centro de administración de Microsoft 365Step 1: Add a Graph connector in the Microsoft 365 admin center

Complete los pasos siguientes para configurar cualquiera de los conectores creados por Microsoft.Complete the following steps to configure any of the Microsoft-built connectors.

  1. Inicie sesión en su cuenta de administrador en el centro de administración de Microsoft 365Sign into your admin account in the Microsoft 365 admin center
  2. En el panel de navegación, seleccione configuración y, a continuación, seleccione búsqueda & inteligencia.In the navigation pane, select Settings, and then select Search & intelligence. Seleccione la pestaña conectores.Select the Connectors tab.
  3. Seleccione + Agregar y, a continuación, seleccione el origen de datos que desee en el menú de opciones disponibles.Select +Add, and then select the data source of your choice from the menu of available options.

Los orígenes de datos disponibles son: ADLS, sitios web de la empresa, Microsoft SQL Server, Azure SQL, base de datos SQL de Oracle, ServiceNow, recurso compartido de archivos, Azure DevOps y MediaWiki.

[! Nota:] puede Agregar un máximo de diez conexiones de Graph a cada inquilino.[!Note:] You can add a maximum of ten Graph connections to each tenant.

Paso 2: asignar un nombre a la conexiónStep 2: Name the connection

Tendrá que especificar estos atributos:You will need to specify these attributes:

  • NombreName
  • IDENTIFICADOR de conexiónConnection ID
  • Descripción (opcional)Description (optional)

El identificador de conexión crea propiedades implícitas para el conector.The connection ID creates implicit properties for your connector. Debe contener solo caracteres alfanuméricos y tener un máximo de 32 caracteres.It must contain only alphanumeric characters and be a maximum of 32 characters.

Paso 3: configurar las opciones de conexiónStep 3: Configure the connection settings

El proceso para configurar las opciones de conexión varía en función del tipo de origen de datos.The process to configure the Connection settings varies based on the type of data source. Vea la información específica del conector para el tipo de origen de datos que desee agregar al inquilino para completar este paso en el proceso de instalación.See the Connector-specific information for the type of data source you want to add to your tenant to complete this step in the setup process.

Para obtener más información acerca de cómo conectarse a un origen de datos local, vea instalar una puerta de enlace de datos local.To learn more about connecting to an on-premises data source, see Install an on-premises data gateway.

Paso 4: administrar los permisos de búsquedaStep 4: Manage search permissions

Las listas de control de acceso (ACL) determinan qué usuarios de la organización pueden tener acceso a cada elemento de datos.Access Control Lists (ACLs) determine which users in your organization can access each item of data.

Algunos conectores como Microsoft SQL y Azure Data Lake Storage alterno admiten de forma nativa Azure Active Directory (Azure ad) ACLs.Some connectors like Microsoft SQL and Azure Data Lake Storage Gen2 natively support Azure Active Directory (Azure AD) ACLs.

Otros conectores como ServiceNow, Azure DevOpsy Salesforce admiten la sincronización de usuarios y grupos que no son de Azure ad.Other connectors like ServiceNow, Azure DevOps, and Salesforce support syncing of non-Azure AD users and groups.

Paso 5: asignar etiquetas de propiedadStep 5: Assign property labels

Puede asignar etiquetas semánticas a las propiedades de origen en la página "asignar etiquetas de propiedad".You can assign semantic labels to your source properties on the "Assign property labels" page. Las etiquetas son etiquetas conocidas que proporciona Microsoft y que proporcionan el significado semántico.Labels are well known tags provided by Microsoft that provide semantic meaning. Permiten a Microsoft integrar los datos de los conectores en experiencias de Microsoft 365 como búsquedas mejoradas, tarjetas de contactos, detección inteligente y mucho más.They allow Microsoft to integrate your connector data into Microsoft 365 experiences such as enhanced search, people cards, intelligent discovery, and more.

En la siguiente tabla se enumeran las etiquetas admitidas actualmente y sus descripciones.The following table lists the currently supported labels and their descriptions.

EtiquetaLabel DescriptionDescription
titletitle El título del elemento que quiere mostrar en la búsqueda y en otras experienciasThe title for the item that you want shown in search and other experiences
urlurl La dirección URL de destino del elemento en el sistema de origenThe target url of the item in the source system
createdBycreatedBy Nombre de la persona que creó el elementoName of the person who created the item
lastModifiedBylastModifiedBy Nombre de la persona que editó recientemente el elementoName of the person who most recently edited the item
susauthors Nombre de las personas que participaron o colaboraron en el elementoName of the people who participated/collaborated on the item
createdDateTimecreatedDateTime Cuándo se creó el elementoWhen was the item created
lastModifiedDateTimelastModifiedDateTime ¿Cuándo se modificó el elemento más recientemente?When was the item most recently edited
fileNamefileName Nombre del elemento de archivoName of the file item
fileExtensionfileExtension Tipo de elemento de archivo como. pdf o. WordType of file item such as .pdf or .word

Las propiedades de esta página están preseleccionadas según el origen de datos, pero puede cambiar esta selección si hay una propiedad distinta que sea más adecuada para una etiqueta en particular.The properties on this page are pre-selected based on your data source, but you can change this selection if there is a different property that is better suited for a particular label.

El título de la etiqueta es la etiqueta más importante.The label title is the most important label. Se recomienda encarecidamente tener una propiedad asignada a esta etiqueta para que la conexión participe en la experiencia de clúster de resultados.It is strongly recommended that you have a property assigned to this label in order for your connection to participate in the result cluster experience.

La asignación incorrecta de etiquetas hará que se produzca una experiencia de búsqueda deteriorada.Incorrectly mapping labels will cause a deteriorated search experience. No es correcto que algunas etiquetas tengan asignada una propiedad.It is okay for some labels to not have a property assigned to it.

Paso 6: administrar esquemaStep 6: Manage schema

Propiedad ContentContent property

Se recomienda encarecidamente seleccionar una propiedad de contenido * * "en el menú desplegable de opciones, o bien mantener el valor predeterminado si hay alguno presente.It is strongly recommended that you select a **Content Property" from the drop-down menu of options, or keep the default if one is present. Esta propiedad se usa para la indizació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 en clústeres de resultados , la detección de idiomas, la compatibilidad con texto y HTML, la clasificación y relevancia, y la formulación de consultas.This property is used for full-text indexing of content, search results page snippet generation, result cluster participation, language detection, HTML/text support, ranking and relevance, and query formulation.

Si selecciona una propiedad de contenido, tendrá la opción de usar la propiedad generada por el sistema ResultSnippet al crear el tipo de resultado.If you select a content property, you will have the option of using the system-generated property ResultSnippet when you create your result type. Esta propiedad actúa como un marcador de posición para los fragmentos de código dinámico que se generan a partir de la propiedad de contenido en el momento de la consulta.This property serves as a placeholder for the dynamic snippets that are generated from the content property at query time. Si usa esta propiedad en el tipo de resultado, los fragmentos de código se generarán en los resultados de la búsqueda.If you use this property in your result type, snippets will be generated in your search results.

Crear alias para propiedades de origenCreating aliases for source properties

Puede Agregar alias a sus propiedades en la columna "alias" en la página "administrar esquema".You can add aliases to your properties under the "Alias" column on the "Manage schema" page. Los alias son nombres descriptivos de las propiedades.Aliases are friendly names for your properties. Se usan en consultas y en la creación de filtros.They are used in queries and in the creation of filters. También se usan para normalizar las propiedades de origen de varias conexiones, de modo que tengan el mismo nombre.They are also used to normalize source properties from multiple connections such that they have the same name. De este modo, puede crear un filtro único para un valor vertical con varias conexiones.That way you can create a single filter for a vertical with multiple connections. Para obtener más información, vea personalizar la página de resultados de búsqueda .See Customize the search results page for more information.

Atributos de esquema de búsquedaSearch schema attributes

Puede establecer los atributos del esquema de búsqueda para controlar la funcionalidad de búsqueda de cada propiedad de origen.You can set the search schema attributes to control search functionality of each source property. Un esquema de búsqueda ayuda a determinar los resultados que se muestran en la página de resultados de búsqueda y la información que los usuarios finales pueden ver y a los que se accede.A search schema helps determine what results display on the search results page and what information end users can view and access.

Los atributos de esquema de búsqueda incluyen búsquedas, consultas, recuperables y refinables.Search schema attributes include searchable, queryable, retrievable, and refinable. En la siguiente tabla se enumeran todos los atributos compatibles con los conectores de Microsoft Graph y se explican sus funciones.The following table lists each of the attributes that Microsoft Graph connectors support and explains their functions.

Atributo de esquema de búsquedaSearch schema attribute FunciónFunction EjemploExample
QUE permiten búsquedasSEARCHABLE Hace que el contenido de texto de una propiedad permita la búsqueda.Makes the text content of a property searchable. El contenido de la propiedad se incluye en el índice de texto completo.Property contents are included in the full-text index. Si la propiedad es title, una consulta de Enterprise devuelve respuestas que contienen la palabra Enterprise en cualquier texto o título.If the property is title, a query for Enterprise returns answers that contain the word Enterprise in any text or title.
CONSULTABLEQUERYABLE Busca una coincidencia para una propiedad determinada en la consulta.Searches by query for a match for a particular property. A continuación, se puede especificar el nombre de la propiedad en la consulta, ya sea mediante programación o literalmente.The property name can then be specified in the query either programmatically or verbatim. Si la propiedad title es consultable, el título de la consulta : Enterprise es compatible.If the Title property is queryable, then the query Title: Enterprise is supported.
RECUPERABLERETRIEVABLE Solo se pueden usar propiedades recuperables en el tipo de resultado y se muestran en los resultados de la búsqueda.Only retrievable properties can be used in the result type and display in the search result.
PARA restricciónREFINABLE Las propiedades refinables se pueden usar como en la página de resultados de la búsqueda de Microsoft.Refinable properties can be used as in the Microsoft Search results page. Los usuarios de la organización pueden filtrar por lastModifiedDateTime en la página de resultados de búsqueda si la propiedad se marca como refinable durante la configuración de la conexión.Users in your organization can filter by lastModifiedDateTime in the search results page if the property is marked refinable during connection setup

Para todos los conectores excepto el conector de recursos compartidos de archivos, los tipos personalizados deben establecerse manualmente.For all connectors except the File share connector, custom types must be set manually. Para activar las capacidades de búsqueda para cada campo, necesita un esquema de búsqueda asignado a una lista de propiedades.To activate search capabilities for each field, you need a search schema mapped to a list of properties. El Asistente para la conexión selecciona automáticamente un esquema de búsqueda en función del conjunto de propiedades de origen que elija.The connection wizard automatically selects a search schema based on the set of source properties you choose. Puede modificar este esquema activando las casillas de verificación de cada propiedad y atributo en la página esquema de búsqueda.You can modify this schema by selecting the check boxes for each property and attribute in the search schema page.

El esquema de un conector se puede personalizar agregando o quitando funciones de consulta, búsqueda y recuperación.

Restricciones y recomendaciones para la configuración del esquema de búsquedaRestrictions and recommendations for search schema settings

  • La propiedad Content sólo se pueden buscar.The content property is searchable only. Una vez seleccionada en la lista desplegable, esta propiedad no se puede marcar como recuperable o consultable.Once selected in the dropdown, this property cannot be marked retrievable or queryable.

  • Se producen problemas de rendimiento significativos cuando los resultados de la búsqueda se representan con la propiedad Content .Significant performance issues occur when search results render with the content property. Un ejemplo es el campo de contenido de texto de un artículo de base de conocimiento de ServiceNow .An example is the Text content field for a ServiceNow knowledge-base article.

  • Solo las propiedades marcadas como representables recuperables en los resultados de búsqueda y se pueden usar para crear tipos de resultado modernos (MRTs).Only properties marked as retrievable render in the search results and can be used to create modern result types (MRTs).

  • Solo las propiedades de cadena se pueden marcar como buscables.Only string properties can be marked searchable.

Nota

Después de crear una conexión, no puede modificar el esquema.After you create a connection, you can't modify the schema. Para ello, debe eliminar la conexión y crear una nueva.To do that, you need to delete your connection and create a new one.

Paso 7: Actualizar configuraciónStep 7: Refresh settings

El intervalo de actualización determina la frecuencia con la que los datos se sincronizan entre el origen de datos y Microsoft Search.The refresh interval determines how often your data is synced between the data source and 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.Each type of data source has a different set of optimal refresh schedules based on how often data is modified and the type of modifications.

Hay dos tipos de intervalos de actualización, que son la actualización completa y la actualización incremental, pero las actualizaciones incrementales no están disponibles para algunos orígenes de datos.There are two types of refresh intervals, which are Full refresh and Incremental refresh, but incremental refreshes are not available for some data sources.

Con una actualización completa, el motor de búsqueda procesa e indiza todos los elementos del origen de contenido, independientemente de los rastreos anteriores.With a full refresh, the search engine processes and indexes every item in the content source, regardless of previous crawls. Una actualización completa funciona mejor en estas situaciones:A full refresh works best for these situations:

  • Detección de eliminaciones de datos.Detecting deletions of data.
  • La actualización incremental no pudo actualizar el contenido debido a errores.The incremental refresh failed to update content due to errors.
  • Las ACL se modificaron.ACLs were modified.
  • Se modificaron las reglas de rastreo.Crawl rules were modified.
  • Cuándo se actualizó el esquema para la conexión (las actualizaciones de esquema aún no son compatibles)When schema for the connection has been updated (schema updates are not yet supported)

Con una actualización incremental, el motor de búsqueda puede procesar e indizar sólo los elementos que se crearon o modificaron desde el último rastreo correcto.With an Incremental refresh, the search engine can process and index only the items that were created or modified since the last successful crawl. Por lo tanto, no todos los datos en el origen de contenido se vuelven a indizar.Therefore, not all the data in the content source is re-indexed. La actualización incremental funciona mejor para detectar contenido, metadatos, permisos y otras actualizaciones.Incremental refreshes work best to detect content, metadata, permission, and other updates.

Las actualizaciones incrementales son mucho más rápidas que las actualizaciones completas porque no se procesan los elementos que no han cambiado.Incremental refreshes are much faster than full refreshes because unchanged items aren’t processed. Sin embargo, si elige ejecutar actualizaciones incrementales, aún tendrá que ejecutar actualizaciones completas de forma periódica para mantener una sincronización de datos precisa entre el origen de contenido y el índice de búsqueda.However, if you choose to run incremental refreshes, you will still need to run full refreshes periodically to maintain an accurate data sync between the content source and the search index.

El rastreo incremental y la configuración de intervalo de rastreo completo muestran una incremental a los 15 minutos y un rastreo completo a una semana.

Paso 8: revisar la conexiónStep 8: Review connection

Puede revisar toda la configuración y editar la configuración según sea necesario antes de completar la conexión.You can review your entire configuration and edit settings as needed before completing the connection. Si aún no lo ha hecho, asegúrese de leer la información específica del conector para su origen de datos.Be sure to read the connector-specific information for your data source if you have not already done so. Seleccione Finalizar actualización cuando esté listo para completar la conexión.Select Finish updating when you are ready to complete the connection.

¿Cómo sé si funcionó la configuración de la conexión?How do I know the connection setup worked?

Vaya a la lista de las conexiones publicadas en la ficha conectores del centro de administración.Go to the list of your published connections under the Connectors tab in the admin center. Para obtener información sobre cómo realizar actualizaciones y eliminaciones, consulte administrar el conector.To learn how to make updates and deletions, see Manage your connector.