Añadir metadatos para encontrar artefactos B2B en los flujos de trabajo de Azure Logic Apps

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

Para ayudar al flujo de trabajo a encontrar rápidamente los elementos de empresa a empresa (B2B) correctos para usar en tiempo de ejecución, puede agregar metadatos personalizados como pares clave-valor a elementos como socios comerciales, acuerdos, esquemas y mapas. Los metadatos personalizados para artefactos le ayudan a lograr los siguientes objetivos o tareas:

• Aplicar convenciones de nomenclatura.
• Admitir la reutilización y evitar definiciones duplicadas.
• Dirigir las cargas a los pasos correctos de codificación o decodificación.
• Proporcionar más control sobre cómo mover artefactos a través del desarrollo, la prueba y la producción.
• Aplique la validación o transformación correctas sin lógica codificada.
• Facilitar el seguimiento, la rastreabilidad, la gobernanza y la auditoría.
• Facilitar la migración de BizTalk Server a Azure Logic Apps.

En la lista siguiente se describen metadatos útiles de ejemplo, en función del tipo de artefacto:

Con fines de seguimiento y alimentación de tablas o paneles de seguimiento B2B, los metadatos útiles incluyen propiedades de correlación, como el número de intercambio, el número de grupo, el identificador del conjunto de transacciones, así como el identificador de ejecución del flujo de trabajo, los identificadores de asociado y de contrato, el estado y las marcas de tiempo.

En esta guía se muestra cómo agregar metadatos a un artefacto en una cuenta de integración, buscar el artefacto mediante la acción integrada Cuenta de integración denominada Búsqueda de artefactos de la cuenta de integración y hacer referencia a los metadatos del artefacto en el flujo de trabajo.

Prerrequisitos

• Una cuenta y una suscripción de Azure. Obtenga una cuenta gratuita de Azure.

• Recurso y flujo de trabajo de la aplicación lógica donde desea obtener y usar los metadatos del artefacto.

  El flujo de trabajo puede comenzar con cualquier desencadenador y necesita una acción que funcione con los metadatos después de la recuperación. En este ejemplo se usa el desencadenador Solicitud denominado Cuando se recibe una solicitud HTTP, que puede pasar dinámicamente el nombre del artefacto desde una solicitud HTTPS entrante.

  Para obtener más información, consulte:

  • Creación de un flujo de trabajo de consumo en Azure Logic Apps

  • Creación de un flujo de trabajo estándar en Azure Logic Apps

• Un recurso de cuenta de integración que contiene los artefactos en los que desea agregar metadatos.

  Puede agregar metadatos personalizados a los siguientes artefactos:

  • Asociado
  • Acuerdo
  • Esquema
  • Map

  En el ejemplo de esta guía se utiliza un artefacto de socio denominado TradingPartner1 (entidad comercial 1).

  • Tanto la cuenta de integración como el recurso de aplicación lógica deben existir en la misma suscripción de Azure y en la misma región de Azure.

  • Antes de empezar a trabajar con la acción de búsqueda de artefactos de la cuenta de integración, debe vincular la aplicación lógica de consumo o vincular la aplicación lógica estándar a la cuenta de integración. Puede vincular una cuenta de integración a varios recursos de aplicaciones lógicas de tipo Consumo o Estándar para compartir los mismos artefactos.

Adición de metadatos a un artefacto

Siga estos pasos para agregar metadatos personalizados para un artefacto B2B en la cuenta de integración.

1. En Azure Portal, vaya al recurso de la cuenta de integración.

2. En la barra lateral del recurso, en Configuración, seleccione la categoría de artefacto.

   En este ejemplo se agregan metadatos a un artefacto de un socio comercial, por lo que en este tipo de escenario, el ejemplo selecciona Partners.

3. En la página categoría de artefacto, seleccione el artefacto y, a continuación, seleccione Editar.

   En el ejemplo siguiente se muestra la página de edición de un artefacto asociado denominado TradingPartner1.

   

4. En Metadatos, en las columnas Clave y Valor , escriba los metadatos personalizados como un par clave-valor. Cuando finalice, seleccione Aceptar.

   En el ejemplo siguiente se muestran los metadatos de ejemplo como pares clave-valor:

   

5. Para ver estos metadatos en la definición de notación de objetos JavaScript (JSON) para el artefacto, junto a Editar, seleccione Editar como JSON en su lugar.

   

Búsqueda del artefacto

Siga estos pasos para buscar el artefacto y los metadatos asociados en la cuenta de integración. En el ejemplo se busca un artefacto de socio comercial específico.

1. En el portal de Azure, abra su recurso de aplicación lógica. Abra el flujo de trabajo en el diseñador.

2. En el diseñador, siga estos pasos generales para agregar la acción integrada cuenta de integración denominada Búsqueda de artefactos de la cuenta de integración, que busca el artefacto y los metadatos especificados.

3. Proporcione la siguiente información para el artefacto, en función del tipo de flujo de trabajo:

   Parámetro	Obligatorio	Importancia	Description
   - Consumo: artifactName - Estándar: nombre del artefacto	Sí	< artifact-name>	El nombre del artefacto, que puede ingresar como un nombre codificado o bien como salida dinámica del desencadenador o de la acción anterior en el flujo de trabajo.
   - Consumo: artifactType - Estándar: tipo de artefacto	Sí	Contrato, Mapa, socio o esquema	El tipo de artefacto.

   1. Para proporcionar el nombre del artefacto como salida del desencadenador o la acción anterior, siga estos pasos:

      1. Haga clic dentro del cuadro artifactName o Nombre del artefacto, y a continuación, seleccione el icono de rayo para abrir la lista de contenido dinámico.

      2. En la lista dinámica, en el nombre del desencadenador o de la acción, seleccione la salida que especifica el nombre del artefacto.

   2. En artifactType o Artifact type (Tipo de artefacto), seleccione el tipo de artefacto. En este ejemplo, el tipo es Partner.

      

4. Guarde el flujo de trabajo.

Referenciar metadatos de artefacto en el flujo de trabajo

Siga estos pasos para usar los metadatos de artefacto recuperados en el flujo de trabajo. En el ejemplo se hace referencia a los metadatos del artefacto recuperado en la sección anterior.

1. En el diseñador, en la acción búsqueda de artefactos de la cuenta de integración, siga estos pasos generales para agregar la acción que desee.

   Este ejemplo continúa con la acción integrada HTTP , que envía una solicitud HTTP desde el flujo de trabajo a un destino especificado.

2. En el panel de acciones, proporcione información sobre cómo desea usar los metadatos del artefacto.

   En este ejemplo se usan los routingUrl metadatos como destino de la solicitud HTTP. En la tabla siguiente se especifican valores de ejemplo para la acción HTTP en este ejemplo:

   Parámetro	Obligatorio	Importancia	Description	Valor de ejemplo
   URI	Sí	< destination-URL>	Dirección URL del punto de conexión para el que desea enviar la solicitud.	Para hacer referencia a los metadatos del routingUrl socio, siga estos pasos: 1. Seleccione dentro del cuadro URI . 2. Seleccione el icono de función para abrir el editor de expresiones. 3. En el editor, escriba una expresión como en el ejemplo siguiente, en función del tipo de flujo de trabajo: Consumo outputs('Integration_Account_Artifact_Lookup')?['properties']?['metadata']['routingUrl'] Standard outputs('Integration_account_artifact_lookup')?['properties']?['metadata']['routingUrl'] 4. Cuando haya terminado, seleccione Agregar.
   Método	Sí	< Método HTTP>	Operación HTTP que se va a ejecutar.	En este ejemplo se usa la operación GET .
   Headers	No	< header-values>	Todas las salidas de encabezado del desencadenador deben pasar a través de la acción HTTP.	Para transferir el valor Content-Type desde el encabezado del desencadenador, en Encabezados, siga estos pasos para la primera fila: 1. En la primera columna, escriba Content-Type como nombre de encabezado. 2. En la segunda columna, use el editor de expresiones para escribir la siguiente expresión como valor de encabezado: triggeroutputs()?['headers']['Content-Type'] Para transferir el valor Host desde el encabezado del desencadenador, en Encabezados, siga estos pasos para la segunda fila: 1. En la primera columna, escriba Host como nombre de encabezado. 2. En la segunda columna, use el editor de expresiones para escribir la siguiente expresión como valor de encabezado: triggeroutputs()?['headers']['Host']
   Cuerpo	No	< body-content>	Cualquier otro contenido que se deba pasar a través de la propiedad body de la acción HTTP.	Para pasar los valores del properties artefacto a la acción HTTP , siga estos pasos: 1. Seleccione dentro del cuadro Cuerpo y, a continuación, seleccione el icono de rayo para abrir la lista de contenido dinámico. Si no aparecen salidas, seleccione Ver más. 2. En la lista de contenido dinámico, en Búsqueda de artefactos de la cuenta de integración, seleccione Propiedades.

   En el escenario de ejemplo, la acción HTTP usa los siguientes valores de ejemplo:

   

3. Para confirmar la información de la acción HTTP, vea la definición JSON subyacente del flujo de trabajo. En la barra de herramientas del diseñador, seleccione Vista Código.

   Aparece la definición JSON subyacente del flujo de trabajo, por ejemplo:

   

4. Regrese al diseñador. En la barra de herramientas de la vista de código, seleccione Diseñador.

   Expresiones que introdujiste en el diseñador ahora aparecen resueltas, por ejemplo:

   

Contenido relacionado

• Adición de acuerdos entre asociados