AS2 Sender

 

In this article

Overview

You can use this Snap to send/reply to a message to an endpoint server in plain text and HTML format. AS2 messages can be compressed, signed, encrypted, and sent over an SSL tunnel, making AS2 a very secure option for transferring files.

Snap Type

The AS2 Sender Snap is a Write-type Snap that writes AS2 messages to an endpoint server.

Prerequisites

None.

Limitations and Known Issues

None.

Snap Views

Type

Format

Number of Views

Examples of Upstream and Downstream Snaps

Description

Type

Format

Number of Views

Examples of Upstream and Downstream Snaps

Description

Input 

Document

  • Min: 1

  • Max: 1

  • AS2 Receiver

  • SMIME Encoder

Each document contains data in the form of JSON.

Output

Document

  • Min: 1

  • Max: 1

  • MDN Parser

  • AES Decrypt

Each document contains a corresponding response in the form of JSON

Error

Error handling is a generic way to handle errors without losing data or failing the Snap execution. You can handle the errors that the Snap might encounter when running the pipeline by choosing one of the following options from the When errors occur list under the Views tab:

  • Stop pipeline Execution: Stops the current pipeline execution if the Snap encounters an error.

  • Discard Error Data and Continue: Ignores the error, discards that record, and continues with the remaining records.

  • Route Error Data to Error View: Routes the error data to an error view without stopping the Snap execution.

Learn more about Error handling in pipelines.

Snap Settings

  • Asterisk ( * ): Indicates a mandatory field.

  • Suggestion icon (): Indicates a dynamically populated list based on the configuration.

  • Expression icon ( ): Indicates the value is an expression (if enabled) or static (if disabled). Learn more about Using Expressions in SnapLogic.

  • Add icon ( ): Indicates that you can add fields in the field set.

  • Remove icon ( ): Indicates that you can remove fields from the field set.

  • Upload icon ( ): Indicates that you can upload files.

Field Name

Field Type

Description

Field Name

Field Type

Description

Label*

 

Default ValueAS2 Sender
ExampleAS2 Sender

String

The name for the Snap. You can modify this to be more specific, especially if you have more than one of the same Snap in your pipeline.

 

Service URL*

 

Default Value: N/A
Example: https://www.example.com/slm/webservice/v2.0/defect/%s".replace("%s", $.widg et.id)

String/Expression

Specify the service endpoint URL of AS2 REST API. You can provide the URL in one of the following ways:

  • As a JavaScript expression in the expression language.

For example: http://coresnapsqa-v4.s3.us-east 2.amazonaws.com/S3Account/'+encodeURIComponent("Special_char_owner_!3)12.json")

  • As a plain string that you should enclose in double quotes ("").

For example: "https://www.example.com/slm/webservice/v2.0/defect/%s".replace("%s", $.widg et.id)

Certificate

 

 

 

Default Value: N/A
Example$853764$Certificate of Insurance - 6.cert

String/Expression

Specify the relative path of the X.509 certificate in the SLDB. You can upload the certificate to the SLDB by clicking . An X.509 certificate is a standard format for public key certificates that securely associates cryptographic key pairs with identities such as websites, individuals, or organizations.

The X.509 certificate should be in any one of the following formats:

  • cert: The certificate file is a public-key certificate following the x.509 standard.

  • pem: pem file is a container format that may just include the public certificate or the entire certificate chain (private Key, public Key, root certificates):

  • crt: The certificates may be encoded as binary DER or ASCII PEM.

Encrypt Algorithm*

Default Value: 3des
Example: AES_256

String/Expression/Suggestion

Specify the algorithm to encrypt the data.

Sign

Default ValueDeselected

Checkbox

Select this checkbox to enable the digital signing of the data

Signer Algorithm

Default Valuesha1
Example: AES_256

String/Expression/Suggestion

Please select the digest to sign the data. A signer algorithm is a cryptographic algorithm used in digital signatures to generate and verify the integrity and authenticity of electronic documents or messages.

Content Transfer Encoding

 

Default Valuesha1
Example: AES_256

String/Expression/Suggestion

Please select Content Transfer Encoding from the suggestions list. Content Transfer Encoding is a mechanism used in email communication and other protocols to encode the content of a message for transmission.

HTTP Headers

Use this field set to create the HTTP header key-value pairs required for defining the headers for different input types (JSON, PDF, DOCX, and so on). If you want to specify only content-type headers, you can configure the Multipart Content-Type property instead. 

Key

 

Default Name: N/A
Example:
APIKey
content-type

String/Expression/Suggestion

Specify the name of the Key for the HTTP header.

Value

Default Value: N/A 
Example: uyfikhEugk2iKnJWPvG8Rv8sL73BgM2C
application/JSON

String/Expression

Specify the value of the Key for the HTTP header.

Snap Execution

Default ValueExecute Only
Example: Validate & Execute

 

Dropdown

Select one of the following three modes in which the Snap executes:

  • Validate & Execute: Performs limited execution of the Snap and generates a data preview during pipeline validation. Subsequently, it performs complete execution of the Snap (unlimited records) during pipeline runtime.

  • Execute only: Performs full execution of the Snap during pipeline execution without generating preview data.

  • Disabled: Disables the Snap and all Snaps that are downstream from it.

Snap Pack History