Crear una aplicación de exportación de datos periódica

Artículo
12/11/2024

Se aplica a estas aplicaciones de Dynamics 365:
Human Resources

En este artículo se describe cómo crear una Microsoft Azure aplicación lógica que exporte datos de Microsoft Dynamics 365 Human Resources forma periódica. El tutorial aprovecha la interfaz de programación de aplicaciones (API) REST del paquete DMF de Human Resources para exportar los datos. Después de exportar los datos, la aplicación lógica guarda el paquete de datos exportados en la carpeta de Microsoft OneDrive for Business.

Escenario empresarial

En un escenario empresarial típico para integraciones de Microsoft Dynamics 365, los datos deben exportarse a un sistema descendente según una programación periódica. En este tutorial se muestra cómo exportar todos los registros de Microsoft Dynamics 365 Human Resources trabajadores y guardar la lista de trabajadores en una OneDrive carpeta para la Empresa.

Sugerencia

Los datos específicos que se exportan en este tutorial y el destino de los datos exportados son solo ejemplos. Puede cambiarlos fácilmente para satisfacer sus necesidades comerciales.

Tecnologías utilizadas

Este tutorial utiliza las siguientes tecnologías:

Dynamics 365 Human Resources : el origen de datos maestros de los trabajadores que se exportará.
Azure Logic Apps : la tecnología que proporciona orquestación y programación de la exportación periódica.
- Conectores: tecnología que se utiliza para Conectar la aplicación lógica a los puntos de conexión necesarios .
  - Conector HTTP con Microsoft Entra id .
  - OneDrive Conector para la Empresa
DMF API de REST del paquete: la tecnología que se utiliza para Gatillo la exportación y supervisar su progreso.
OneDrive para la Empresa : el destino de los trabajadores exportados.

Requisitos previos

Antes de comenzar el ejercicio en este tutorial, debe tener los siguientes elementos:

Un entorno de Human Resources que tiene permisos de nivel de administrador en el entorno.
Una suscripción a Azure para hospedar la aplicación lógica

El ejercicio

Al final de este ejercicio, tendrá una aplicación lógica conectada a su entorno de Human Resources y su cuenta de OneDrive for Business. La aplicación lógica exportará un paquete de datos de Human Resources, esperará a que se complete la exportación, descargará el paquete de datos exportado y guardará el paquete de datos en la carpeta de OneDrive for Business que especificó.

La aplicación lógica completada se parecerá a la siguiente ilustración.

Visión general de las aplicaciones lógicas.

Paso 1: crear un proyecto de exportación de datos en Human Resources

En Human Resources, cree un proyecto de exportación de datos que exporte trabajadores. Asigne al proyecto el nombre Exportar trabajadores y asegúrese de que la opción Generar paquete de datos está establecida en Sí. Agregue una sola entidad (Trabajador) al proyecto y seleccione el formato para exportar. (En este tutorial se usa el formato de Microsoft Excel).

Exportar el proyecto de datos de trabajadores.

Importante

Recuerde el nombre del proyecto de exportación de datos. Lo necesitará cuando cree la aplicación lógica en el siguiente paso.

Paso 2: crear la aplicación lógica

La mayor parte del ejercicio implica la creación de la aplicación lógica.

En Azure Portal, cree una aplicación lógica.
En Logic Apps Designer, comience con una aplicación lógica en blanco.
Agregue un desencadenador de programación periódica para ejecutar la aplicación lógica cada 24 horas (o de acuerdo con un horario de su elección).
Llame a la API REST DMF ExportToPackage para programar la exportación del paquete de datos.
1. Utilice la acción Invocar una solicitud HTTP desde el conector HTTP con Microsoft Entra.
  - URL del recurso base: la URL de su ambiente de Human Resources (no incluya información de ruta de acceso/espacio de nombres).
  - Microsoft Entra URI del recurso:http://hr.talent.dynamics.com
  Nota
  
  El servicio Human Resources aún no proporciona un conector que exponga todas las API que componen la API REST de paquetes DMF, como ExportToPackage. En su lugar, debe llamar a las API utilizando solicitudes HTTPS sin procesar a través del conector HTTP con Microsoft Entra. Este conector usa Microsoft Entra ID para la autenticación y autorización en Human Resources.
2. Inicie sesión en el entorno de Human Resources a través del conector HTTP con Microsoft Entra.
3. Configure una solicitud HTTP POST para llamar a la API REST DMF ExportToPackage.
  - Método: POST
  - URL de la solicitud: https://< nombre> de host/espacios de nombres/<namespace_guid>/data/DataManagementDefinitionGroups/Microsoft.Dynamics.DataEntities.ExportToPackage
  - Cuerpo de la solicitud:
```
{
    "definitionGroupId":"Export Workers",
    "packageName":"talent_package.zip",
    "executionId":"",
    "reExecute":false,
    "legalEntityId":"USMF"
}
```
Sugerencia

Es posible que desee cambiar el nombre de cada paso para que sea más significativo que el nombre predeterminado, Invocar una solicitud HTTP. Por ejemplo, puede cambiar el nombre de este paso ExportToPackage.
Inicializar una variable para almacenar el estado de ejecución de la solicitud ExportToPackage .
Espere hasta que el estado de ejecución de la exportación de datos sea Correcto.
1. Agregar un bucle Until que se repite hasta que el valor de la variable ExecutionStatus sea Correcto.
2. Agregue una acción Retrasar que espere cinco segundos antes de sondear el estado de ejecución actual de la exportación.
  
  Nota
  
  Establezca el recuento límite en 15 para esperar un máximo de 75 segundos (15 iteraciones × 5 segundos) a que se complete la exportación. Si su exportación lleva más tiempo, ajuste el recuento de límites según corresponda.
3. Agregue una acción Invocar solicitud HTTP para llamar a la API REST DMF GetExecutionSummaryStatus y establezca la variable ExecutionStatus en el resultado de la respuesta GetExecutionSummaryStatus.
  
  Este ejemplo no realiza la comprobación de errores. La API GetExecutionSummaryStatus puede devolver estados terminales no exitosos (es decir, estados distintos de Correcto). Para obtener más información, consulte la documentación de la API.
  - Método: POST
  - URL de la solicitud: https://< nombre> de host/espacios de nombres/<namespace_guid>/data/DataManagementDefinitionGroups/Microsoft.Dynamics.DataEntities.GetExecutionSummaryStatus
  - Cuerpo de la solicitud:body( 'Invoke_an_HTTP_request')?[' valor']
    
    Nota
    
    Puede que tenga que introducir el valor de Cuerpo de la solicitud en la vista de código o en el editor de funciones del diseñador.
  Importante
  
  El valor para la acción Establecer variable (body('Invoke_an_HTTP_request')?['value']) diferirá del valor del cuerpo de Invocar una solicitud HTTP 2, aunque el diseñador mostrará los valores de la misma manera.
Obtenga la URL de descarga del paquete exportado.
- Agregue una acción Invocar solicitud HTTP para llamar a la API REST DMF GetExportedPackageUrl.
  - Método: POST
  - URL de la solicitud: https://< nombre> de host/espacios de nombres/<namespace_guid>/data/DataManagementDefinitionGroups/Microsoft.Dynamics.DataEntities.GetExportedPackageUrl
  - Cuerpo de la solicitud: {"executionId": body('GetExportedPackageURL')?[' valor']}
Descargue el paquete exportado.
- Agregue una solicitud HTTP GET (una acción del conector HTTP incorporada) para descargar el paquete desde la URL que se devolvió en el paso anterior.
  - Método: GET
  - URI: body('Invoke_an_HTTP_request_3').value
    
    Nota
    
    Puede que tenga que introducir el valor de URI en la vista de código o en el editor de funciones del diseñador.
  Nota
  
  Esta solicitud no requiere ninguna autenticación adicional, porque la URL que devuelve la API GetExportedPackageUrl incluye un token de firmas de acceso compartido que otorga acceso para descargar el archivo.
Guarde el paquete descargado utilizando el conector de OneDrive for Business.
- Agregue una acción Crear archivo en OneDrive for Business.
- Conéctese a su cuenta de OneDrive for Business según sea necesario.
  - Ruta de acceso de la carpeta: una carpeta de su elección
  - Nombre del archivo: worker_package.zip
  - Contenido del archivo: El cuerpo del paso anterior (contenido dinámico)

Paso 3: probar la aplicación lógica

Para probar la aplicación lógica, seleccione el botón Ejecutar en el diseñador. Verá que los pasos de la aplicación lógica comienzan a ejecutarse. Después de 30 a 40 segundos, la aplicación lógica debería terminar de ejecutarse y la carpeta de OneDrive for Business debe incluir un nuevo archivo de paquete que contenga los trabajadores exportados.

Si se informa una falla para cualquier paso, seleccione el paso fallido en el diseñador y examine los campos Entradas y Salidas para ello. Depure y ajuste el paso según sea necesario para corregir los errores.

La siguiente ilustración muestra cómo se ve el Logic Apps Designer cuando todos los pasos de la aplicación lógica se ejecutan correctamente.

Ejecución exitosa de la aplicación lógica.

Resumen

En este tutorial, aprendió a usar una aplicación lógica para exportar datos de Human Resources y guardar los datos exportados en una carpeta de OneDrive for Business. Puede modificar los pasos de este tutorial según sea necesario para satisfacer las necesidades de su negocio.

Compartir a través de