Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Se aplica a: Azure Logic Apps (Consumo + Estándar)
Para enviar y recibir mensajes de RosettaNet en flujos de trabajo que cree mediante Azure Logic Apps, use el conector RosettaNet . Este conector proporciona acciones que admiten y administran la comunicación que sigue los estándares de RosettaNet. Estos estándares se usan habitualmente en procesos de la cadena de suministro y están muy extendidos en el sector de los semiconductores, la electrónica y la logística. RosettaNet se basa en el lenguaje XML y define directrices de mensajería, interfaces para procesos comerciales y marcos de implementación para la comunicación entre compañías.
El conector de RosettaNet proporciona las siguientes funcionalidades:
- Recibir y descodificar mensajes de RosettaNet.
- Enviar y codificar mensajes de RosettaNet.
- Esperar la respuesta y la generación de una notificación de error.
En esta guía se proporciona información general breve sobre RosettaNet y se muestra cómo agregar las acciones de codificación y descodificación de RosettaNet a un flujo de trabajo de aplicación lógica existente. El conector de RosettaNet no proporciona ningún desencadenador, por lo que puede usar cualquier desencadenador para iniciar el flujo de trabajo. En los ejemplos de esta guía se usa el desencadenador de solicitud.
Descripción de los conceptos de RosettaNet
RosettaNet es una organización que estableció procesos estándar para compartir información empresarial. Esta organización crea y mantiene procesos de interfaz de asociados (PIP), que proporcionan definiciones de proceso de negocio comunes para todos los intercambios de mensajes de RosettaNet. Para obtener más información, visite el sitio web de RosettaNet.
El conector de RosettaNet se basa en la versión 2.0.01 de RosettaNet Implementation Framework (RNIF) y admite todos los PIP definidos por esta versión. RNIF es un marco de aplicaciones de red abierto que facilita a los asociados empresariales la ejecución colaborativa de PIP de RosettaNet. Este marco de trabajo define la estructura del mensaje, la necesidad de confirmaciones, la codificación de extensiones multipropósito de correo Internet (MIME) y la firma digital. La comunicación entre asociados puede ser sincrónica o asincrónica.
En la tabla siguiente se describen los conceptos y términos de RosettaNet:
| Concepto | Descripción |
|---|---|
| PIP | Un PIP proporciona definiciones de proceso de negocio comunes para todos los intercambios de mensajes de RosettaNet. Los PIP se clasifican por una función empresarial de alto nivel, o clúster, y una subfunción o segmento. Por ejemplo, "3A4" es el PIP para el pedido de compra, mientras que "3" es la función de administración de pedidos y "3A" es la subfunción de cotización y entrada de pedidos. Cada especificación de PIP proporciona un archivo de definición de tipo de documento (DTD) y un documento de guía de mensajes. El archivo DTD define la estructura del mensaje de contenido del servicio. El documento de instrucciones de mensaje es un archivo HTML legible que especifica restricciones de nivel de elemento. Juntos, los archivos PIP y DTD proporcionan una definición completa del proceso de negocio. Para obtener más información, visite el sitio web de RosettaNet. |
| Acción | Los mensajes de acción forman parte de un PIP y son mensajes empresariales que los socios intercambian entre sí. |
| Signal | Los mensajes de señal forman parte de un PIP y son confirmaciones enviadas en respuesta a los mensajes de acción. |
| Acción única y acción doble | Para un PIP con una sola acción, la única respuesta es un mensaje de señal de confirmación. Para una PIP de doble acción, el iniciador recibe un mensaje de respuesta y responde con una confirmación, además del flujo de mensajes de acción única. |
Referencia técnica del conector
El conector de RosettaNet tiene versiones diferentes, basadas en el tipo de aplicación lógica y el entorno de host.
| Aplicación lógica | Entorno | Versión del conector |
|---|---|---|
| Consumo | Azure Logic Apps multiinquilino | Conector administrado de RosettaNet, que aparece en la galería de conectores en Compartido. El conector de RosettaNet solo proporciona acciones. Puede usar cualquier desencadenador que funcione para su escenario. Para obtener más información, consulte: - Operaciones de RosettaNet - Límites del protocolo B2B para tamaños de mensaje |
| Standard | Implementación híbrida, Azure Logic Apps de un solo inquilino y App Service Environment v3 (solo planes de Windows) | Conector integrado de RosettaNet, que aparece en la galería de conectores bajo "Built-in". El conector de RosettaNet solo proporciona acciones. Puede usar cualquier desencadenador que funcione para su escenario. El conector integrado puede acceder directamente a las redes virtuales de Azure. No necesita una puerta de enlace de datos local. Para obtener más información, consulte: - Operaciones de RosettaNet - Límites del protocolo B2B para tamaños de mensaje |
Operaciones de RosettaNet
El conector de RosettaNet no tiene desencadenadores. En la tabla siguiente se describen las acciones que proporciona el conector de RosettaNet para establecer la seguridad y confiabilidad al transmitir mensajes:
Requisitos previos
Una cuenta y una suscripción de Azure. Obtenga una cuenta gratuita de Azure.
El recurso y el flujo de trabajo de la aplicación lógica donde desea usar las operaciones de RosettaNet.
El flujo de trabajo requiere cualquier desencadenador que funcione mejor para su escenario y cualquier otra acción que quiera ejecutar antes de agregar una acción de RosettaNet.
Para obtener más información, consulte:
Un recurso de la cuenta de integración para definir y almacenar artefactos para utilizarlos en flujos de trabajo de integración empresarial y B2B.
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.
Define al menos dos socios comerciales que participan en la operación de RosettaNet usada en el flujo de trabajo. Ambas definiciones de asociados deben usar el mismo calificador de identidad empresarial , que es DUNS.
Importante
Asegúrese de seleccionar DUNS, que puede encontrar cerca de la parte inferior de la lista Calificador , y no 1 - D-U-N-S (Dun & Bradstreet).
Contiene una configuración de proceso PIP que almacena todas las características de configuración de PIP. Esta configuración se usa al crear un contrato entre asociados. Si no tiene una configuración de proceso, agregue una configuración de proceso PIP.
Define un acuerdo de RosettaNet entre los socios comerciales que participan en la operación de RosettaNet. Un contrato requiere un asociado host y un asociado invitado. El contenido de los mensajes entre asociados debe coincidir con el tipo de contrato. Consulte Creación de un contrato de RosettaNet.
Antes de empezar a trabajar con las operaciones de RosettaNet, debe vincular su aplicación lógica de consumo o vincular su aplicación lógica de estándar a la cuenta de integración.
Certificados opcionales para cifrar, descifrar o firmar los mensajes que carga en la cuenta de integración. Los certificados son necesarios solo si usa firmas o cifrado.
Añadir una configuración de proceso PIP
Si tu cuenta de integración no tiene una configuración de proceso PIP, sigue estos pasos para añadirla:
En Azure Portal, vaya al recurso de la cuenta de integración.
En la barra lateral del recurso, en Configuración, seleccione RosettaNet PIP. En la barra de herramientas de la página PIP de RosettaNet , seleccione Agregar.
En el panel Agregar proceso de interfaz de asociado, escriba la siguiente información de PIP:
Parámetro Obligatorio Descripción Nombre Sí Nombre del PIP Código de PIP Sí Código PIP de tres caracteres. Para más información, consulte PIP de RosettaNet. Versión de PIP Sí La versión de PIP, que depende del código PIP seleccionado. Para obtener más información, visite el sitio web de RosettaNet.
En el ejemplo siguiente se muestra información de ejemplo para una configuración de proceso PIP:
Cuando haya terminado, seleccione Aceptar para crear la configuración de PIP.
Para ver o editar la configuración del proceso, seleccione pip. En la barra de herramientas de la página PIP de RosettaNet , seleccione Editar como JSON.
Todos los valores de configuración de procesos provienen de las especificaciones de PIP. De forma predeterminada, Azure Logic Apps rellena la mayoría de la configuración con valores predeterminados en función de los valores más usados.
Confirme que los valores de configuración corresponden a los valores de la especificación PIP adecuada y satisfagan sus necesidades empresariales. Si es necesario, actualice los valores en el editor JSON y guarde los cambios.
Cuando finalice, seleccione Aceptar.
Creación de un contrato de RosettaNet
Si la cuenta de integración no tiene contrato de RosettaNet, siga estos pasos para crear el contrato:
En Azure Portal, vaya al recurso de la cuenta de integración.
En la barra lateral del recurso, en Configuración, seleccione Contratos. En la barra de herramientas de la página Contratos , seleccione Agregar.
En el panel Agregar , escriba la siguiente información de contrato:
Parámetro Obligatorio Descripción Nombre Sí Nombre del contrato. Tipo de contrato Sí Tipo de protocolo para el contrato. Seleccione RosettaNet. Asociado host Sí Nombre del asociado host, que representa la organización. Un contrato requiere un asociado anfitrión y uno invitado. Identidad del host Sí Identificador del socio del host. Asociado invitado Sí El nombre del asociado invitado, que hace negocios con el asociado host. Un contrato requiere un asociado anfitrión y uno invitado. Identidad del invitado Sí Identificador del asociado invitado. Configuración de recepción Varía Propiedades que se aplican a todos los mensajes recibidos por el asociado host del asociado invitado. Configuración de envío Varía Propiedades que se aplican a todos los mensajes enviados por el asociado host al asociado invitado. Referencias de PIP de RosettaNet Sí Las referencias de PIP para el acuerdo. Todos los mensajes de RosettaNet requieren configuraciones de PIP. En el ejemplo siguiente se muestra información de ejemplo para un contrato de RosettaNet:
Para especificar cómo el asociado host recibe mensajes del asociado invitado, en el panel Agregar , seleccione Configuración de recepción.
El panel Configuración de recepción muestra la siguiente configuración:
Configuración Obligatorio Descripción Debe firmarse el mensaje No Firme los mensajes entrantes con el certificado seleccionado. Certificado Sí, si la firma está habilitada Certificado que se va a usar para firmar. Habilitar el cifrado de mensajes No Cifre los mensajes entrantes con el certificado seleccionado. Certificado Sí, si el cifrado está habilitado Certificado que se va a usar para el cifrado. Para habilitar la firma, el cifrado o ambos para los mensajes entrantes, en Mensaje, seleccione Mensaje debe estar firmado, El mensaje debe cifrarse o ambos.
En cada configuración seleccionada, en la lista Certificado , seleccione el certificado de la cuenta de integración que se usará para firmar, cifrar o ambos.
En el ejemplo siguiente se muestra la configuración de firma y cifrado en el panel Configuración de recepción :
Cuando finalice, seleccione Aceptar.
Para especificar cómo el asociado host envía mensajes al asociado invitado, en el panel Agregar , seleccione Enviar configuración.
El panel Configuración de envío muestra la siguiente configuración:
Configuración Obligatorio Descripción Habilitar la firma de mensajes No Firme los mensajes salientes con el algoritmo de firma y el certificado seleccionados. Algoritmo de firma Sí, si la firma está habilitada Algoritmo de firma que se va a usar, en función del certificado seleccionado. Certificado Sí, si la firma está habilitada Certificado que se va a usar para firmar. Habilitar el cifrado de mensajes No Cifre los mensajes salientes con el algoritmo de cifrado y el certificado seleccionados. Algoritmo de cifrado Sí, si el cifrado está habilitado Algoritmo de cifrado que se va a usar, en función del certificado seleccionado. Certificado Sí, si el cifrado está habilitado Certificado que se va a usar para el cifrado. Para habilitar la firma, el cifrado o ambos para los mensajes salientes, en Mensajes, seleccione Habilitar firma de mensajes, Habilitar cifrado de mensajes o ambos.
En cada configuración seleccionada, en la lista de algoritmos, seleccione el algoritmo que se va a usar. En la lista Certificado , seleccione el certificado de la cuenta de integración que se usará para firmar, cifrar o ambos.
En la sección Puntos de conexión , especifique las direcciones URL necesarias para enviar mensajes de acción y confirmaciones:
Parámetro Obligatorio Descripción URL de acción Sí La dirección URL que se usará para enviar mensajes de acción. Esta dirección URL es necesaria para los mensajes sincrónicos y asincrónicos. URL de confirmación Sí La dirección URL que se usará para enviar mensajes de confirmación. Esta dirección URL es necesaria para los mensajes asincrónicos. En el ejemplo siguiente se muestra la configuración de firma, cifrado y dirección URL del punto de conexión en el panel Configuración de envío con algunos valores de ejemplo:
Cuando finalice, seleccione Aceptar.
Para especificar las referencias pip de RosettaNet para el contrato, en el panel Agregar , seleccione Referencias pip de RosettaNet.
La página referencias de PIP de RosettaNet muestra la configuración del proceso PIP que creó y agregó anteriormente.
En la columna Nombre de PIP , abra la lista y seleccione el PIP.
La selección rellena las demás propiedades, que se basan en el PIP de su cuenta de integración.
Si es necesario, puede cambiar el Rol de PIP.
Continúe con la sección siguiente para recibir mensajes de RosettaNet.
Recepción y descodificación de mensajes de RosettaNet
En el portal de Azure, abra su recurso de aplicación lógica. Abra el flujo de trabajo en el diseñador.
El flujo de trabajo ya debe tener un desencadenador y cualquier otra acción que quiera ejecutar antes de agregar la acción RosettaNet.
Siga estos pasos generales para agregar la acción de descodificación de RosettaNet al flujo de trabajo.
En el panel de información de acciones, proporcione los siguientes valores:
Parámetro Obligatorio Descripción Mensaje Sí Mensaje de RosettaNet que se va a descodificar. Encabezados Sí Los encabezados HTTP que proporcionan los valores de la versión y el tipo de respuesta como pares de clave y valor. La versión es RNIF. El tipo de respuesta describe el tipo de comunicación del asociado y puede ser sincrónico o asincrónico.Rol Sí El rol de socio anfitrión en el PIP. 
La salida de la acción de descodificación de RosettaNet incluye un valor de señal de salida. Puede codificar y devolver esta salida al asociado invitado, o bien puede realizar una acción diferente en esta salida.
Envío y codificación de mensajes de RosettaNet
En el portal de Azure, abra su recurso de aplicación lógica. Abra el flujo de trabajo en el diseñador.
El flujo de trabajo ya debe tener un desencadenador y cualquier otra acción que quiera ejecutar antes de agregar la acción RosettaNet.
Siga estos pasos generales para agregar la acción de codificación de RosettaNet al flujo de trabajo.
En el panel de información de acciones, proporcione los siguientes valores:
Parámetro Obligatorio Descripción Identidad de instancia de proceso de RosettaNet (PIP) Sí Identificador de instancia del mensaje que se va a codificar. Asociado host Sí Nombre del socio anfitrión. Asociado invitado Sí Nombre del asociado invitado. Código de PIP Sí Código PIP. Versión de PIP Sí La versión de PIP. Identidad de instancia de PIP Sí Identificador único de este mensaje PIP. Tipo de mensaje Sí Tipo del mensaje que se va a codificar. Rol Sí Rol de socio anfitrión. 
Esta acción ahora está configurada para codificar y enviar el mensaje de RosettaNet al asociado invitado.
Para enviar el mensaje rosettaNet codificado, siga estos pasos generales para agregar la acción adecuada para su escenario. Proporcione los valores que la acción necesita para enviar el mensaje.
En este ejemplo se usa la acción HTTP, que se renombra a HTTP: enviar un mensaje codificado al socio. Los valores son salidas de la acción de codificación de RosettaNet y se agregan a través de la lista de contenido dinámico.
En función de los estándares de RosettaNet, las transacciones empresariales solo se completan después de que se completen todos los pasos definidos por el PIP. Después de que el asociado host envíe el mensaje codificado al asociado invitado, el host espera la señal y la confirmación.
En el flujo de trabajo, agregue la acción RosettaNet que espera una respuesta. En el panel de información de acciones, proporcione los siguientes valores:
Parámetro Obligatorio Descripción Cuerpo Sí Mensaje codificado original. Identidad de instancia de PIP Sí Identificador de instancia del mensaje codificado. Número de reintentos Sí Número de reintentos para codificar y enviar el mensaje. Rol Sí Rol de socio anfitrión. La duración de espera y el recuento de reintentos de la acción RosettaNet se basan en la configuración de PIP.
Si la acción RosettaNet no recibe una respuesta, la acción genera una notificación de error.
Para controlar los reintentos, coloque siempre las acciones de RosettaNet para enviar el mensaje codificado y esperar una respuesta dentro de un bucle Until , por ejemplo:
