Conector csv de Microsoft Graph

El conector csv de Microsoft Graph permite a su organización ingerir contenido de archivos CSV almacenados en bibliotecas de SharePoint y Azure Data Lake Storage (ADLS). Después de configurar el conector y el contenido de índice de estos orígenes, los usuarios finales pueden encontrar archivos CSV en Microsoft Search y Microsoft 365 Copilot.

Este artículo está destinado a cualquier persona que configure, ejecute y supervise un conector csv de Microsoft Graph. Complementa el proceso de configuración general y muestra instrucciones que se aplican solo a este conector.

Antes de empezar

  • Asegúrese de que no haya espacios en blanco en los encabezados CSV.

  • Para un origen de datos de SharePoint, puede autenticarse con cualquiera de los dos proveedores de OAuth: Microsoft Entra ID (próximamente) o proveedor de SharePoint (retirarse pronto).

    • Para autenticarse mediante Microsoft Entra ID deberá crear y registrar una aplicación en Microsoft Entra ID.
    • Para autenticarse con el proveedor de SharePoint, deberá crear una aplicación de SharePoint con la configuración de OAuth.

Sugerencia

Podrá cambiar el proveedor de OAuth para la conexión publicada de SharePoint a Microsoft Entra ID, una vez disponible.

  • Para un origen de datos de ADLS, deberá crear una cuenta de almacenamiento de ADLS.

Origen de datos de SharePoint

Carga de los archivos CSV

Compruebe que los archivos .csv que desea indexar se hayan cargado en una biblioteca de documentos de SharePoint. Puede usar un sitio de SharePoint existente o crear uno nuevo.

Creación de una aplicación en Microsoft Entra ID

  1. Vaya al Azure Portal e inicie sesión con las credenciales de administrador del inquilino.

  2. Vaya a Microsoft Entra ID ->Manage ->Registros de aplicaciones en el panel de navegación y seleccione Nuevo registro.

  3. Proporcione un nombre para la aplicación y seleccione Registrar.

  4. Anote el identificador de la aplicación (cliente).

  5. Abra permisos de API en el panel de navegación y seleccione Agregar un permiso.

  6. Seleccione SharePoint y, a continuación, Permisos delegados.

  7. Busque los permisos siguientes y seleccione Agregar permisos.
    a. AllSites.Read
    b. User.Read.All

  8. Seleccione Conceder consentimiento de administrador para [TenantName] y confirme seleccionando .

  9. Compruebe que los permisos están en el estado "concedido".

  10. Abra Autenticación en el panel de navegación y seleccione Agregar una plataforma. Seleccione Web en Aplicaciones web y agregue lo siguiente en URI de redirección (URI de devolución de llamada de autorización):

    • Para M365 Enterprise: https://gcs.office.com/v1.0/admin/oauth/callback
    • Para M365 Government: https://gcsgcc.office.com/v1.0/admin/oauth/callback

Configuración del secreto de cliente para la autenticación

  1. Vaya al Azure Portal e inicie sesión con las credenciales de administrador del inquilino.

  2. Abra Registro de aplicaciones en el panel de navegación y vaya a la aplicación adecuada. En Administrar, seleccione Certificados y secretos.

  3. Seleccione Nuevo secreto de cliente y seleccione un período de expiración para el secreto. Copie el secreto generado y guárdelo porque no se muestra de nuevo.

  4. Use este secreto de cliente y el identificador de aplicación para configurar el conector.

Crear una aplicación de SharePoint con la configuración de OAuth (retirarse pronto)

  1. Ve a https://Org-Name.sharepoint.com/sites/mysite/_layouts/15/appregnew.aspx.
  2. En los campos Id. de cliente y Secreto de cliente, seleccione Generar.
  3. En Título, escriba un nombre de aplicación.
  4. En el campo Dominio de aplicación, escriba www.gcs.com.
  5. En el campo Url de redireccionamiento, escriba https://www.gcs.com.
  6. Seleccione Crear.
  7. Copie la información de configuración de la aplicación, incluidos el identificador de cliente y el secreto de cliente. Lo necesitará al configurar el conector CSV.

Habilitación de permisos de aplicación para permitir customAppAuthentication

En PowerShell (Shell de administración de SharePoint Online), ejecute estos comandos en modo administrativo. Use la dirección de correo electrónico del administrador que configura el conector y el nombre de la organización. Cuando aparezca la ventana emergente de contraseña, el administrador debe escribir su contraseña.

Install-Module -Name Microsoft.Online.SharePoint.PowerShell
$adminUPN=”<admin@contoso.onmicrosoft.com>”
$orgName=“<contoso>”
$userCredential = Get-Credential -UserName $adminUPN -Message "Enter your password."
Connect-SPOService -Url https://$orgName-admin.sharepoint.com -Credential $userCredential
Set-spotenant –DisableCustomAppAuthentication $false

Nota

Si usa PowerShell 7, use primero este comando. Import-Module microsoft.online.sharepoint.powershell -UseWindowsPowerShell

Nota

Si usa la autenticación multifactor, use Connect-SPOService -Url https://$orgName-admin.sharepoint.com.

Completar la configuración de la aplicación

  1. Ve a https://Org-Name.sharepoint.com/sites/mysite/_layouts/15/appinv.aspx.
  2. En el campo Id. de aplicación, pegue el identificador de cliente de la aplicación de SharePoint y seleccione Búsqueda.
  3. En el campo SOLICITAR XML de permiso, pegue este código y seleccione Crear.
<AppPermissionRequests AllowAppOnlyPolicy="true">
    <AppPermissionRequest Scope="http://sharepoint/content/sitecollection/web" Right="Read" />
</AppPermissionRequests>
  1. Seleccione Confiar en él.

Origen de datos de ADLS

Creación de una cuenta de almacenamiento de ADLS

Para obtener instrucciones paso a paso, consulte Creación de una cuenta de almacenamiento. Para permitir funcionalidades de almacenamiento de archivos, en la pestaña Opciones avanzadas, seleccione Habilitar espacio de nombres jerárquico y Crear un contenedor para este sitio.

Al configurar el conector csv de Microsoft Graph, deberá proporcionar una cadena de conexión de almacenamiento principal. Para encontrarla, abra la cuenta de almacenamiento que creó y seleccione Claves de acceso. Seleccione Mostrar claves y copie el cadena de conexión de Key1.

Paso 1: Agregar un conector de Microsoft Graph en el Centro de administración de Microsoft 365

Incorporación del conector csv de Microsoft Graph

Siga las instrucciones generales de configuración.

Paso 2: Asignar un nombre a la conexión

Siga las instrucciones generales de configuración.

Paso 3: Configurar las opciones de conexión

La configuración del origen de datos es diferente para SharePoint y ADLS.

Nota

Asegúrese de que el archivo csv no tiene ningún formato o espacios (' ') presentes en las filas de encabezado.

Para un origen de SharePoint

  1. En la configuración del origen de datos, seleccione SharePoint como origen de datos.

  2. En el sitio de SharePoint, escriba la dirección URL del sitio, https://Org-Name.sharepoint.com/Site-Name, por ejemplo.

  3. En Biblioteca de documentos, escriba el nombre de la biblioteca donde se almacenan los archivos .csv.

  4. En el proveedor de OAuth, puede seleccionar Proveedor de SharePoint (retirarse pronto) o Microsoft Entra ID

    a. Para Microsoft Entra ID (próximamente):
    1. Tipo de autenticación, seleccione Oauth2.0(código de autorización).
    2. Escriba el id. de cliente y el secreto de cliente que copió al crear la aplicación de Microsoft Entra ID.
    3. Seleccione Iniciar sesión. Debería obtener un mensaje conexión correcta .

    b. Para el proveedor de SharePoint (retirarse pronto):
    1. En Tipo de autenticación, seleccione Oauth2.0(credenciales de cliente).
    2. Escriba el id. de cliente y el secreto de cliente que copió al crear la aplicación de SharePoint.
    3. Seleccione Probar conexión. Debería obtener un mensaje conexión correcta .

Para controlar el acceso en un nivel de archivo, escriba Microsoft Entra usuarios o grupos.

Lista de control de acceso con usuario y grupo incluidos.

Para un origen de ADLS

  1. En la configuración del origen de datos, seleccione Azure Data Lake Storage(ADLS) como origen de datos.
  2. En Almacenamiento principal cadena de conexión, escriba el cadena de conexión que copió.
  3. Escriba el nombre del contenedor y el nombre de archivo.
  4. Seleccione Probar conexión. Debería obtener un mensaje The connection is successful (La conexión es correcta ).

Conector CSV con configuración de origen de datos para un origen de Azure Data Lake Storage.

Nota

Si el origen de datos contiene varios archivos .csv con los mismos encabezados, seleccione Incluir todos los archivos CSV en la ubicación.

Para controlar el acceso en un nivel de archivo, escriba Microsoft Entra usuarios o grupos.

Lista de control de acceso con usuario y grupo incluidos.

Paso 4: Delimitador de varios elementos (opcional)

Si las columnas de origen pueden tomar varios valores, escriba un delimitador de varios elementos, un punto y coma (;) por ejemplo.

Paso 5: Configuración de propiedades analizadas

Esta página devuelve la primera fila del archivo .csv como Propiedades de origen. Para modificar el tipo de datos, en la lista Identificador único , seleccione al menos una opción.

Para controlar el acceso en un nivel de elemento, seleccione las columnas asignadas a usuarios permitidos y grupos permitidos. Debe incluir dos columnas, AllowedUsers y AllowedGroups, en el archivo .csv. Cada fila debe contener los identificadores de Microsoft Entra.

Configuración del control de acceso de nivel de elemento.

Nota

El conector csv de Microsoft Graph admite el control de acceso de nivel de archivo o elemento. Si ambos están habilitados, solo se aplica el control de acceso de nivel de archivo.

Paso 6: Asignar etiquetas de propiedad

Siga las instrucciones generales de configuración.

Nota

La etiqueta IconURL se rellena de forma predeterminada y no se puede cambiar la asignación.

Paso 7: Administrar esquema

Siga las instrucciones generales de configuración.

Paso 8: Administrar permisos de búsqueda

  • Para el control de acceso a nivel de archivo o elemento, seleccione Solo las personas con acceso a este origen de datos.
  • Al seleccionar Todos , todos los usuarios de la organización pueden ver los resultados de búsqueda de este origen de datos.

Configuración de permisos de búsqueda con solo personas con acceso a este origen de datos seleccionado.

Paso 9: Elegir la configuración de actualización

Siga las instrucciones generales de configuración.

Paso 10: Revisión de la conexión

Siga las instrucciones generales de configuración.

Limitaciones

A continuación se indican las limitaciones conocidas del conector csv de Microsoft Graph:

  • En este momento no se admiten escenarios de enriquecimiento de perfiles.

Solución de problemas

Después de publicar la conexión, puede revisar el estado en la pestaña Orígenes de datos del Centro de administración. Para obtener información sobre cómo realizar actualizaciones y eliminaciones, consulte Administración del conector.

Puede encontrar pasos de solución de problemas para los problemas más vistos aquí.

Si tiene problemas o desea proporcionar comentarios, póngase en contacto con [Microsoft Graph | Compatibilidad con (https://developer.microsoft.com/en-us/graph/support).