Importe elementos de lista de SharePoint Online a SAP Analytics Cloud a través del servicio OData (solución en la nube sin conectores abiertos)

Con las crecientes demandas de los usuarios de SAC que desean conectarse a la Lista de SharePoint para la visualización y el análisis de datos, descubrí una solución para la conectividad de importación de SAC contra los elementos de la Lista de SharePoint Online a través de BTP Cloud Integration. Para lograrlo, implementé un artefacto de la API de OData para recuperar elementos de la lista de SharePoint sin conectores abiertos y un marco de entidad de mapa. Compare con el método con Open Connectors, simplificó los flujos de trabajo y no necesitamos configurar los archivos EDMX o XSD manualmente. Este blog es para proporcionar una guía de conectividad de extremo a extremo desde el registro del complemento de lista de SharePoint hasta la configuración de la conexión SAC a través de SAP Integration Suite. Actualmente, no podemos usar el método de autenticación de credenciales de cliente de OAuth2 directamente en SAC contra la lista de SharePoint Online, ya que hay un par clave-valor más (recurso: 00000003-0000-0ff1-ce00-000000000000/@TenantID) es requerido por SharePoint Online al obtener access_token y SAC no proporcionó un lugar para ingresar este valor en el cuadro de diálogo de conexión. Por lo tanto, el siguiente método se puede tratar como una solución alternativa sin modificar el emisor de OAuth de SharePoint.

1. Registrar complemento de SharePoint
2. Asignar permiso al complemento
3. Obtener ClientID@TenantID
4. Use Postman para obtener/probar el token de acceso y las credenciales
5. Crear credenciales OAuth2 en Cloud Integration Suite
6. Crear un artefacto de la API de OData en un paquete
7. Vincular fuente de datos
8. Configurar receptor OData
9. Configurar asignación de mensajes
10. Implementar la API de OData
11. Crear instancia y credenciales
12. Probar la API de OData implementada en Postman
13. Crear/Probar Conexión de Servicio OData en SAC

1. Ir a https:///sites/205434/_layouts/15/appregnew.aspx
2. Haga clic en «Generar» tanto para la identificación del cliente como para el secreto del cliente
3. Dar un nombre amistoso
4. Agregar dominio y redirigir URI
5. Haga clic en «Crear» y anote la información.
   

   Identificación del cliente: 5d57…8bac Secreto del cliente: bbc7…TTA= Título: WuTestList2App Dominio de la aplicación: localhost URI de redirección: https://localhost

1. Ir a https:///sites/205434/_layouts/15/appinv.aspx
2. Copie la identificación del cliente en la identificación de la aplicación archivada
3. Haga clic en «Buscar»
4. Copie el siguiente XML en el XML de solicitud de permiso. Consulte también learn.microsoft.com “Tabla 2. Derechos disponibles y URI de ámbito de permiso de complemento de SharePointY reduzca el permiso de acuerdo con la política de seguridad de la organización.. En este ejemplo, los copiaré todos para brindar información sobre cómo afecta los permisos.

5. <AppPermissionRequests AllowAppOnlyPolicy="true">
   
     <AppPermissionRequest Scope="http://sharepoint/content/sitecollection/web/list"
       Right="FullControl" />
     <AppPermissionRequest Scope="http://sharepoint/content/sitecollection/web/list" Right="Manage" />
     <AppPermissionRequest Scope="http://sharepoint/content/sitecollection/web/list" Right="Read" />
     <AppPermissionRequest Scope="http://sharepoint/content/sitecollection/web/list" Right="Write" />
   
     <AppPermissionRequest Scope="https://sharepoint/content/tenant" Right="FullControl" />
     <AppPermissionRequest Scope="https://sharepoint/content/tenant" Right="Manage" />
     <AppPermissionRequest Scope="https://sharepoint/content/tenant" Right="Read" />
     <AppPermissionRequest Scope="https://sharepoint/content/tenant" Right="Write" />
   
     <AppPermissionRequest Scope="http://sharepoint/content/sitecollection" Right="FullControl" />
     <AppPermissionRequest Scope="http://sharepoint/content/sitecollection" Right="Manage" />
     <AppPermissionRequest Scope="http://sharepoint/content/sitecollection" Right="Read" />
     <AppPermissionRequest Scope="http://sharepoint/content/sitecollection" Right="Write" />
   
     <AppPermissionRequest Scope="http://sharepoint/content/sitecollection/web" Right="FullControl" />
     <AppPermissionRequest Scope="http://sharepoint/content/sitecollection/web" Right="Manage" />
     <AppPermissionRequest Scope="http://sharepoint/content/sitecollection/web" Right="Read" />
     <AppPermissionRequest Scope="http://sharepoint/content/sitecollection/web" Right="Write" />
   
   </AppPermissionRequests>
   

6. Haga clic en «Crear»
7. Seleccione la Lista de SharePoint de destino de la lista desplegable
8. Haga clic en «Confiar en él»

1. Ir a Configuración del sitio
2. Seleccione «Permiso de la aplicación del sitio» como se muestra a continuación
3. Busque la aplicación y anote Clientid@Tenantid (lo usaremos más adelante). Clientid@Tenantid es
   5d57…8bac@42f7…1af7

Consulte también code2care.org “Cómo acceder a los datos de SharePoint Online mediante la API REST de Postman y el token de portador”

1. CORREO https://cuentas.accesscontrol.windows.net/[Tenant ID]/fichas/OAuth/2 ([Tenant ID] = Tenantid obtenido en el paso 3-3)
   

   Agregar encabezado de solicitud	Tipo de contenido: aplicación/x-www-form-urlencoded
   Agregar cuerpo de solicitud	Seleccione: x-www-form-urlencoded grant_type:client_credentials client_id:Clientid@Tenantid (obtenido en el paso 3-3) client_secret: Secreto del cliente (obtenido en el paso 1-5) recurso: 00000003-0000-0ff1-ce00-000000000000/@Tenantid
   Ejemplo	grant_type:client_credentials id_cliente:5d57…8bac@42f7…1af7 secreto_cliente:bbc7…TTA= recurso:00000003-0000-0ff1-ce00-000000000000/@42f7…1af7

2. Haga clic en «Enviar»
3. Copie access_token del cuerpo de respuesta
4. CONSEGUIR http:///sites/205434/_api/web/lists/GetByTitle(‘WuTestList2’)/items
   

   Agregar encabezados de solicitud

   Autorización: Portador (pegar encima de access_token) Aceptar: aplicación/json; odata = detallado

Si tiene éxito, devolverá todos los elementos de la lista con metadatos.

1. Navegar a Material de seguridad
2. Haga clic en «Crear» y luego seleccione «Credenciales de cliente OAuth2»
3. Dé un nombre, luego ingrese exactamente las mismas credenciales cuando obtenga access_token en Postman
4. Haga clic en «Implementar»

1. Haga clic en «Editar» -> Seleccione «API OData»
2. Seleccione «Crear usando el asistente» y proporcione un nombre significativo.
3. Luego haga clic en «Crear»
4. Haga clic en «Eidt» -> Haga clic en «Asistente de importación de modelos»
5. Seleccione «ODATA», luego importe el archivo EDMX preparado
6. Solo seleccione la lista de destino con las propiedades de destino
7. Podemos dejar la Estructura de Revisar y Finalizar EDMX por defecto
8. Haga clic en «Finalizar» y luego haga clic en «Guardar»

1. Seleccione ODATA como fuente de datos y haga clic en el botón «enlace»
2. Deje «Cargar modelo OData» como predeterminado porque lo hemos cargado al principio y no es necesario cambiarlo, luego seleccione los Conjuntos de entidades de la lista. Luego coloque el punto final del servicio de datos https:///sites/205434/_vti_bin/listdata.svc/
3. Haga clic en «Aceptar» y luego haga clic en «Guardar»

1. Seleccione «Receptor OData». En la pestaña Conexión, cambie la Autenticación a las credenciales del cliente OAuth2 e ingrese el nombre de las credenciales: WuTestList2Credentials (que creamos en el paso 5-3 para obtener el token de acceso)
2. Vaya a la pestaña Procesamiento, cambie el Tipo de contenido a JSON.
3. Deje el resto de configuraciones como predeterminadas

1. Haga clic en el componente Mapeo de mensajes, luego navegue a la pestaña Procesamiento
2. Haga clic en el enlace de asignación predeterminado
3. Deje el origen y el destino como predeterminados (no cambie el archivo aquí), luego asigne el nodo principal y los nodos secundarios.
4. Haga clic en Aceptar»

1. Navegue a la siguiente interfaz y guarde la configuración. Luego haga clic en «Implementar»
2. Vaya a Administrar contenido de integración
3. Actualice el estado, luego obtendremos el punto final de la API OData implementada.
4. Copie el punto final de WuTestList2OData:

1. Ir a la subcuenta donde creamos la API de OData
2. Vaya a Instancia y suscripciones
3. Haga clic en «Crear» en la esquina superior derecha
4. Ingrese la información como se muestra a continuación
5. Haga clic en «Siguiente», deje la información como predeterminada
6. Haga clic en «Siguiente» para obtener una vista previa de la información
7. 
8. Haga clic en «Crear»
9. Luego veremos que se creó la instancia y crearemos una clave de servicio dentro de esta instancia
10. Haga clic en «Crear clave de servicio» y proporcione un nombre significativo en el cuadro de diálogo.
11. Deje el resto de la configuración como predeterminada y luego haga clic en «Crear». Luego veremos la tecla Servicio como en la pantalla de abajo. Haga clic en «…» para ver las credenciales en esta clave
12. Luego vemos todas las credenciales en el cuadro de diálogo. Anote el ID de cliente y el secreto de cliente. Los usaremos en Postman y SAC. Y los llamaré Instance-clientid e instance-clientsecret en los siguientes pasos para evitar confusiones con el ID de cliente del complemento de SharePoint y el secreto del cliente.

1. Use la URL de la API de OData desarmada en Postman. CONSEGUIR https://…/odata/SAP/WUTESTLIST2ODATA;v=1/$metadatos
2. Para Autorización, elija «Autenticación básica» e ingrese las credenciales obtenidas del paso 11-12
3. Copie el nombre de EntitySet de en el cuerpo de la respuesta
   Entonces mi nombre EntitySet es WuTestList2ItemSet
4. Cambiar CONSEGUIR URL a https://…/odata/SAP/WUTESTLIST2ODATA;v=1/WuTestList2ItemSet
   Al mismo tiempo, podemos actualizar los elementos de la lista en SharePoint y probar las actualizaciones en el cuerpo de la respuesta.

1. Seleccione Servicios OData del área de conexión en SAC. Proporcione un nombre significativo e información de entrada en la siguiente tabla. Y haga clic en «Aceptar»
   

   URL del servicio de datos	URL de la API de OData implementada https://…/gw/odata/SAP/WUTESTLIST2ODATA;v=1
   tipo de autenticación	Autenticación básica
   Nombre de usuario	ID de cliente de instancia
   Contraseña	Instancia-clientesecreto

   

2. Navegue hasta Modelo y seleccione la conexión de lista de SharePoint recién creada de la lista desplegable
3. Seleccione el conjunto de entidades
4. Cree una consulta de servicio OData y haga clic en «Crear».
5. Si la conexión y el flujo de integración de la API de OData son correctos. Luego, los datos se importan en SAC con éxito. También podemos programar las actividades de importación como se muestra en la siguiente captura de pantalla.

Como se describe en el contexto, esta solución se ajusta a SharePoint Online y es una configuración única. Pero tenga en cuenta que