Supervisión y seguimiento de transacciones B2B en flujos de trabajo Estándar para Azure Logic Apps (Versión preliminar)

Se aplica a: Azure Logic Apps (Estándar)

Para asegurarse de que las operaciones empresariales se ejecutan sin problemas, mantener el cumplimiento y solucionar problemas en escenarios de integración empresarial B2B, debe realizar un seguimiento preciso y confiable de las transacciones B2B que fluyen a través de las soluciones de integración. Si tiene flujos de trabajo de aplicaciones lógicas Estándar que funcionan con transacciones X12, EDIFACT o AS2, tiene acceso a funcionalidades de seguimiento sólidas que le ayudan a supervisar los intercambios B2B de forma eficaz.

Con una cuenta de integración de nivel Premium, puede configurar el seguimiento B2B para flujos de trabajo Estándar mediante Azure Data Explorer. Esta funcionalidad realiza un seguimiento preciso de todas las transacciones B2B, ya que Azure Data Explorer almacena todas las transacciones de un clúster y una base de datos, lo que proporciona un seguimiento sin pérdida junto con las funcionalidades de visualización y consulta.

Por ejemplo, obtendrá un panel de seguimiento para que pueda supervisar, buscar y analizar transacciones B2B de forma eficaz. Para un análisis más detallado, puede crear consultas avanzadas en la base de datos del clúster. Con los datos de seguimiento almacenados en Azure Data Explorer, puede ampliar los paneles de Microsoft Power BI o crear paneles personalizados con los datos.

En esta guía se proporciona información general breve sobre cómo funciona el seguimiento de B2B, cómo configurar esta funcionalidad para el recurso y los flujos de trabajo de la aplicación lógica Estándar y cómo abrir el panel de seguimiento.

Limitaciones y problemas conocidos

• En esta versión preliminar, el seguimiento actualmente controla solo las transacciones X12 y AS2.

Cómo funciona el seguimiento B2B

En la tabla siguiente se describe cómo funcionan conjuntamente varios componentes para admitir el seguimiento B2B:

Prerrequisitos

• Una cuenta y una suscripción de Azure. Si no tiene una suscripción, registrarse para obtener una cuenta gratuita de Azure.

• Una cuenta de integración de nivel Premium. Si no tiene esta cuenta de integración, consulte Creación y administración de cuentas de integración para flujos de trabajo B2B en Azure Logic Apps.

• Flujo de trabajo Estándar que usa acciones integradas AS2 o X12

  Actualmente, el seguimiento B2B solo admite transacciones procesadas por estas acciones.

• Un clúster y una base de datos de Azure Data Explorer para almacenar los registros de transacciones y los datos de seguimiento.

  Si no tiene un clúster y una base de datos existentes, consulte Inicio rápido: Creación de un clúster y una base de datos de Azure Data Explorer y Qué es Azure Data Explorer

Configuración del seguimiento B2B

Para esta tarea, debe crear un almacén de seguimiento en la cuenta de integración. Actualmente, una cuenta de integración solo admite un almacén de seguimiento predeterminado.

Creación de un almacén de seguimiento para la cuenta de integración

1. En Azure Portal, abra la cuenta de integración de nivel Premium.

2. En el menú de la cuenta de integración, en Configuración, seleccione Almacenes de seguimiento.

3. En la barra de herramientas, seleccione Agregar. En el panel Agregar almacén de seguimiento, proporcione la siguiente información:

   Propiedad	Valor
   Suscripción	La suscripción de Azure para el clúster de Azure Data Explorer.
   Azure Data Explorer	Nombre del clúster en Azure Data Explorer.
   Base de datos	Nombre de la base de datos del clúster.

   Por ejemplo:

   

4. Cuando finalice, seleccione Aceptar.

Deshabilitar o habilitar el seguimiento B2B en el nivel de contrato

Si tiene acuerdos existentes entre socios comerciales en su cuenta de integración, puede deshabilitar o volver a habilitar el seguimiento de cada contrato. De forma predeterminada, el seguimiento está habilitado para los contratos. Actualmente, puede deshabilitar o volver a habilitar el seguimiento de un contrato solo a través de la vista JSON.

1. En Azure Portal, abra la cuenta de integración de nivel Premium.

2. En el menú de la cuenta de integración, en Configuración, seleccione Contratos. Seleccione un contrato.

3. En la barra de herramientas de la página Contratos, seleccione Editar como JSON.

4. En el contrato, busque los sendAgreement objetos y receiveAgreement.

5. Para deshabilitar el seguimiento, cambie trackingState a Disabled. Para volver a habilitar el seguimiento, cambie trackingState a o Enabled.

Para más información, consulte la siguiente documentación:

• Adición de acuerdos entre asociados en cuentas de integración
• Incorporación de socios comerciales a cuentas de integración

Solución de problemas de configuración de seguimiento

Para que el seguimiento funcione correctamente, asegúrese de que se cumplen todas las condiciones siguientes:

• Existe un almacén de seguimiento en la cuenta de integración.
• En un contrato, el trackingState atributo se establece en Enabled.

Abrir el panel de seguimiento

1. Antes de usar el panel de seguimiento, asegúrese de que el flujo de trabajo ejecuta algunas acciones integradas X12, EDIFACT o AS2 para que el almacén de seguimiento contenga datos.

2. En el menú de la cuenta de integración, en Supervisión, seleccione Seguimiento B2B, que abre el panel.

   De forma predeterminada, la pestaña Información general está seleccionada y muestra un resumen de alto nivel con gráficos para todos los tipos de mensajes admitidos, estados de mensaje, asociados con la mayoría de los errores y un resumen de mensajes para cada asociado.

   Pestaña	Descripción
   Información general	Vea un resumen de alto nivel para todos los tipos de mensajes admitidos.
   AS2	Vea los detalles de todas las transacciones AS2 recopiladas.
   X12	Vea los detalles de todas las transacciones X12 recopiladas.

   Por ejemplo:

   

3. Para cambiar el intervalo de tiempo del panel del valor predeterminado, en la lista TimeRange, seleccione el intervalo que desee.

4. Para ver los detalles de los mensajes recopilados, seleccione la pestaña AS2 o X12.

   La pestaña seleccionada muestra los mensajes recopilados junto con sus propiedades y valores.

   En el ejemplo siguiente se muestran los detalles disponibles para los mensajes X12 recopilados:

   

Tablas de base de datos

En el clúster de Azure Data Explorer, la base de datos almacena los datos de transacción en un formato estructurado por tabla. Esta estructura de tabla proporciona la capacidad de consultar y recuperar datos de seguimiento B2B de forma eficaz, proporcionar información estructurada sobre el flujo de mensajes, el estado de procesamiento y solucionar problemas.

• La tabla denominada AS2TrackRecords almacena transacciones AS2.
• La tabla denominada EdiTrackRecords almacena transacciones X12 y EDIFACT.

Administración de almacenes de seguimiento con la API de REST

Puede usar la API de REST de Azure Logic Apps para crear, actualizar, eliminar y recuperar el almacén de seguimiento mediante programación.

Crear o actualizar un almacén de seguimiento

Cree un almacén de seguimiento o actualice uno existente.

PUT https://management.azure.com/subscriptions/{subscription-ID}/resourceGroups/{resource-group-name}/providers/Microsoft.Logic/integrationAccounts/{integration-account-name}/groups/default/trackingstores/{tracking-store-name}?api-version=2016-06-01

Cuerpo de la solicitud

{ 
  "properties": {
    "adxClusterUri": "https://{cluster-name}.kusto.windows.net",
    "databaseName": "{database-name}"
  }
}

Respuesta

Devuelve los detalles del almacén de seguimiento creado o actualizado.

Obtener un almacén de seguimiento específico

Obtenga los detalles sobre un almacén de seguimiento específico.

GET https://management.azure.com/subscriptions/{subscription-ID}/resourceGroups/{resource-group-name}/providers/Microsoft.Logic/integrationAccounts/{integration-account-name}/groups/default/trackingstores/{tracking-store-name}?api-version=2016-06-01

Parámetros:

Respuesta

Devuelve los detalles sobre el almacén de seguimiento especificado.

Obtener todos los almacenes de seguimiento

Obtenga todos los almacenes de seguimiento de la cuenta de integración.

GET https://management.azure.com/subscriptions/{subscription-ID}/resourceGroups/{resource-group-name}/providers/Microsoft.Logic/integrationAccounts/{integration-account-name}/groups/default/trackingstores?api-version=2016-06-01

Respuesta

Devuelve una lista de almacenes de seguimiento asociados a su cuenta de integración.

Eliminar un almacén de seguimiento

Elimine un almacén de seguimiento existente de la cuenta de integración.

DELETE https://management.azure.com/subscriptions/{subscription-ID}/resourceGroups/{resource-group-name}/providers/Microsoft.Logic/integrationAccounts/{integration-account-name}/groups/default/trackingstores/{tracking-store-name}?api-version=2016-06-01

Respuesta

Devuelve una respuesta correcta para un almacén de seguimiento eliminado correctamente.

Contenido relacionado

• Esquemas para el seguimiento de transacciones B2B: Flujos de trabajo Estándar