Conector CSV

El conector de CSV 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.

Nota:

Lea el artículo Configuración del conector de Graph para conocer las instrucciones generales de configuración de los conectores de Graph.

Este artículo está destinado a cualquier persona que configure, ejecute y supervise un conector CSV. 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, deberá crear una aplicación de SharePoint con la configuración de Oauth. Para un origen de datos de ADLS, deberá crear una cuenta de almacenamiento de ADLS.

Creación de una aplicación de SharePoint con la configuración de Oauth

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 de SharePoint

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 Id. de cliente de la aplicación de SharePoint y seleccione Búsqueda.
3. En el campo XML de solicitud de permiso, pegue este código y seleccione Crear.

<AppPermissionRequests AllowAppOnlyPolicy="true">
    <AppPermissionRequest Scope="http://sharepoint/content/sitecollection/web" Right="Read" />
</AppPermissionRequests>

4. Seleccione Confiar.

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, 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 para Key1.

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

Agregar conector CSV

Siga las instrucciones generales de configuración.

Paso 2: Seleccionar experiencias

Actualmente, el conector CSV solo admite experiencias de búsqueda.

Paso 3: Asignar un nombre a la conexión

Siga las instrucciones generales de configuración.

Paso 4: 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 Tipo de autenticación, seleccione Oauth2.0(credenciales de cliente).
5. Escriba el identificador de cliente y el secreto de cliente que copió al crear la aplicación de SharePoint.
6. Seleccione Probar conexión. Debería obtener un mensaje The connection is successful (La conexión es correcta ).

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

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 ).

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.

Paso 5: 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 6: 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.

Nota:

El conector CSV 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 7: 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 8: Administrar esquema

Siga las instrucciones generales de configuración.

Paso 9: 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.

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

Siga las instrucciones generales de configuración.

Paso 11: Revisión de la conexión

Siga las instrucciones generales de configuración.

Limitaciones

Las siguientes son limitaciones conocidas del conector CSV:

• Los escenarios de enriquecimiento de perfiles no se admiten en este momento.