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.

Registrar complemento de SharePoint
Asignar permiso al complemento
Obtener ClientID@TenantID
Use Postman para obtener/probar el token de acceso y las credenciales
Crear credenciales OAuth2 en Cloud Integration Suite
Crear un artefacto de la API de OData en un paquete
Vincular fuente de datos
Configurar receptor OData
Configurar asignación de mensajes
Implementar la API de OData
Crear instancia y credenciales
Probar la API de OData implementada en Postman
Crear/Probar Conexión de Servicio OData en SAC

Ir a https:///sites/205434/_layouts/15/appregnew.aspx
Haga clic en «Generar» tanto para la identificación del cliente como para el secreto del cliente
Dar un nombre amistoso
Agregar dominio y redirigir URI
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

Ir a https:///sites/205434/_layouts/15/appinv.aspx
Copie la identificación del cliente en la identificación de la aplicación archivada
Haga clic en «Buscar»
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.

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

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

Ir a Configuración del sitio
Seleccione «Permiso de la aplicación del sitio» como se muestra a continuación
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”

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

Haga clic en «Enviar»
Copie access_token del cuerpo de respuesta
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.

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

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

Seleccione ODATA como fuente de datos y haga clic en el botón «enlace»
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/
Haga clic en «Aceptar» y luego haga clic en «Guardar»

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)
Vaya a la pestaña Procesamiento, cambie el Tipo de contenido a JSON.
Deje el resto de configuraciones como predeterminadas

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

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

Ir a la subcuenta donde creamos la API de OData
Vaya a Instancia y suscripciones
Haga clic en «Crear» en la esquina superior derecha
Ingrese la información como se muestra a continuación
Haga clic en «Siguiente», deje la información como predeterminada
Haga clic en «Siguiente» para obtener una vista previa de la información
Haga clic en «Crear»
Luego veremos que se creó la instancia y crearemos una clave de servicio dentro de esta instancia
Haga clic en «Crear clave de servicio» y proporcione un nombre significativo en el cuadro de diálogo.
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
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.

Use la URL de la API de OData desarmada en Postman. CONSEGUIR https://…/odata/SAP/WUTESTLIST2ODATA;v=1/$metadatos
Para Autorización, elija «Autenticación básica» e ingrese las credenciales obtenidas del paso 11-12
Copie el nombre de EntitySet de en el cuerpo de la respuesta
Entonces mi nombre EntitySet es WuTestList2ItemSet
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.

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

Navegue hasta Modelo y seleccione la conexión de lista de SharePoint recién creada de la lista desplegable
Seleccione el conjunto de entidades
Cree una consulta de servicio OData y haga clic en «Crear».
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.