send
Ruta completa: /system/ as2/send
La función as2/send envía un mensaje AS2 a un servidor AS2 remoto. Para poder llamar a esta función desde un trabajo, primero debe configurar los detalles del socio AS2 en FlowForce Server. Para obtener información general sobre la integración con AS2 y su uso, consulte Integración con AS2.
La función devuelve un objeto MDN AS2 que contiene la notificación MDN propiamente dicha que devuelve el servidor, así como información adicional del protocolo. Para obtener información adicional del objeto AS2 MDN (por ejemplo, el estado HTTP o el MDN del mensaje original), añada un paso de ejecución que llame a las funciones de expresión AS2 necesarias.
Para obtener más información sobre cómo se utiliza la función as2/send en los trabajos, consulte Enviar mensajes AS2.
Encabezados HTTP
Al enviar un mensaje AS2, FlowForce Server configura los encabezados HTTP de acuerdo con la especificación AS2. Los encabezados reales dependen de la configuración de la función send, la configuración del socio y otros parámetros (detalles abajo).
Encabezados fijos:
MIME-Version: 1.0
AS2-Version: 1.2
EDIINT-Features: multiple-attachments
From: as2@example.com
Subject: AS2 Request
Dependiendo de la configuración del socio en /system/as2/send:
AS2-From: P2 (desde la página de configuración del socio AS2, Local Side Settings/AS2 Name)
AS2-To: P1 (desde la página de configuración del socio AS2, Local Side Settings/AS2 Name)
Desde el parámetro /system/as2/send o generado automáticamente si no se da:
Message-ID: <20201123192334591017-31ca0d9e1b654f7294b10624d1ab5075@DEV-abc>
Dependiendo de la configuración del socio (cifrado y/o firma), se añaden los encabezados MIME necesarios:
Content-Type: application/pkcs7-mime; smime-type=enveloped-data; name="message.p7m"
Content-Disposition: attachment; filename="message.p7m"
Si la opción Notificación de disposición del mensaje/Solicitar MDN firmada) está marcada en la página socio AS2, se agrega el siguiente encabezado:
Disposition-Notification-To: as2dummy@example.com
Con el parámetro Encabezados HTTP (ver tabla siguiente), puede establecer encabezados adicionales antes de enviar el mensaje y sobrescribir el valor predeterminado del encabezado Asunto.
Parámetros
Nombre | Tipo | Descripción |
|---|---|---|
Socio | Socio AS2 | Parámetro obligatorio. Hace referencia al objeto Socio AS2 (ver Configurar socios AS2). |
Mensaje | secuencia | Parámetro obligatorio. El contenido del mensaje AS2 que se debe enviar como objeto de secuencia. La secuencia que exige este campo se puede convertir desde un archivo (p. ej. archivo XML o EDI file) con ayuda de una expresión de FlowForce. Por ejemplo:
stream-open("C:\archivos\miarchivo.edi", "application/EDIFACT")
Observe que la función stream-open anterior también suministra el encabezado Content-Type del mensaje en el segundo parámetro. También se pueden usar los demás valores para Content-Type si es necesario.
Para ver una introducción a las expresiones de FlowForce, consulte Expresiones. |
ID del mensaje: | cadena de texto | Parámetro opcional. Este campo da el valor para el campo del encabezado Message-ID en forma de cadena de texto. Para generar este valor, llame a la función de expresión new-message-id. |
Encabezados HTTP | secuencia de (cadena, cadena) | Parámetro opcional. Este parámetro le permite sobrescribir el valor predeterminado del encabezado Asunto (Solicitud AS2 ) y definir encabezados adicionales más allá de los exigidos por la especificación AS2. Por ejemplo, es posible que desee incluir un encabezado como X-Cyclone-Metadata-FdaCenter para enviar mensajes a la FDA.
Este parámetro no se puede usar para sobrescribir los encabezados que exige la especificación AS2, excepto el encabezado Asunto. |
Anular en caso de error | booleano | Parámetro opcional. Este parámetro determina el resultado de un trabajo si ocurre un error. Si el parámetro de Anular en caso de error es true, la ejecución del trabajo se anula. Si el parámetro es false, FlowForce Server ignora los errores y sigue ejecutando el trabajo. El valor predeterminado es true. |
Ejemplos
Consulte estos ejemplos:
•Ejemplo: intercambio completo de mensajes AS2 (Simple)
•Ejemplo: intercambio completo de mensajes AS2 (Avanzado)