4.2.4. Gateway types
Chorus Pro Gateway In:Here is the list of all the gateway types used in the application, with some more information about their specific uses and parameters.
Gateway In
-
Email Gateway In: Incoming messages are attached to email messages and sent to a specific Babelway email address and processed as soon as they arrive.
-
IMAP mail client Gateway In: This new gateway allows the customer to connect his own mailbox to Babelway, and Babelway poll in a folder of the mailbox. We use the IMAP protocol to connect and fetch mail.
-
FTP Client Gateway In: Incoming messages are polled and retrieved from a remote ftp server using a login and password.
-
SFTP Client Gateway In: Incoming messages are polled and retrieved from a remote sftp server using a login and password.
-
FTP Server Gateway In: Incoming messages are transferred to a specific Babelway Ftp server and processed as soon as they arrive.
-
SFTP Server Gateway In: Incoming messages are transferred to a specific Babelway sftp server and processed as soon as they arrive.
-
AS2 Gateway In: A communication standard largely used in retail environment to secure communications over the Internet.
-
Internal Gateway In: A gateway used to transfer messages between 2 channels within Babelway.
-
Message record Gateway In: Used to export the messages details from the Monitoring in a message processed by the channel.
-
Lookup table Gateway In: Used to create a message using values present in a lookup table.
-
OFTP Server Gateway In: Incoming messages are transferred to a Babelway specific OFTP server and processed as soon as they arrive.
-
OFTP client Gateway In: Incoming messages are polled and retrieved from a remote OFTP server using login and password.
-
Http Client Gateway In: Incoming messages are polled and retrieved from a remote Http server.
-
Http Client Gateway In (Deprecated): Incoming messages are polled and retrieved from a remote Http server.
-
Web Scraping Gateway In: Incoming messages are polled using a scenario mimicking a browser navigating the web.
-
Http Gateway In: Incoming messages are transferred to a Babelway specific Http server and processed as soon as they arrive and it is using synchronous request.
-
Rest Gateway In: Allows you to implement a REST API and it is using synchronous request.
-
X.400 Gateway In: Incoming messages are transferred to a Babelway specific X.400 server and processed as soon as they arrive.
-
Scheduler Gateway In: Create new messages based on time triggers.
-
NFS Gateway In: Incoming messages are polled and retrieved from a remote NFS server using login and password.
-
SAP Gateway In: Incoming messages are pushed to Babelway from an SAP server and processed as soon as they arrive.
-
Dropbox Gateway In: Incoming messages are polled from a Dropbox account.
-
Tradeshift Gateway In: Incoming messages are polled from a Tradeshift account.
-
E-conomic Gateway In: Incoming messages are pushed to Babelway from an E-conomic account and processed as soon as they arrive.
-
VAN Gateway In: Incoming messages are polled from ECGrid VAN.
-
PEPPOL Gateway In: Incoming messages are received from the PEPPOL network.
-
RosettaNet Gateway In: Incoming messages are received from a RosettaNet server.
-
ePrior Gateway In: Incoming messages are received from ePrior requests.
-
Simpl.ePrior Gateway In: Incoming messages are received from Simpl.ePrior requests.
-
Amazon Marketplace Gateway In: Incoming messages are polled from an Amazon marketplace account.
-
NemHandel Gateway In: Incoming messages are received from the NemHandel network.
- Chorus Pro Gateway In:This gateway allows you to get information from the Chorus Pro platform, the French administration network.
-
Oracle Fusion Gateway In: Incoming messages are received from the Oracle Fusion CMK.
- Database Gateway IN: pulls rows out (gateway IN) of a table and converts them to an XML file
-
Email Gateway Out: With an Email Gateway Out, outgoing messages are attached to an email and sent to a specific email address.
-
FTP Client Gateway Out: With a Ftp Client Out Gateway, outgoing messages are transferred to an external Ftp server.
-
SFTP Client Gateway Out: With a SFTP Client Out Gateway, outgoing messages are transferred to an external SFTP server.
-
FTP Server Gateway Out:With a Ftp Server Out Gateway, outgoing messages are available from a Babelway FTP server.
-
SFTP Server Gateway Out:With a Sftp Server Out Gateway, outgoing messages are available from a Babelway SFTP server.
-
AS2 Gateway Out: A communication standard largely used in retail environment to secure communications over the Internet.
-
Internal Gateway Out: The internal gateways in / out are used to transfer messages between 2 channels inside the same Babelway environment.
-
Null Gateway Out: The outgoing messages are not sent anywhere.
-
Splitter Gateway Out: A gateway used to split your messages and pass them to other gateways.
-
Aggregator Gateway Out: The aggregator allows you to merge messages into one larger file. The resulting messages are forwarded to another channel in the same environment.
-
Lookup Table Gateway Out: Used to fill a lookup table automatically from a message.
-
OFTP Server Gateway Out: With an OFTP Server Out Gateway, outgoing messages are available from a Babelway OFTP server.
-
OFTP Client Gateway Out: With an OFTP Client Out Gateway, outgoing messages are transferred to an external OFTP server.
-
Http Gateway Out: With a HTTP out Gateway, outgoing messages are available from a Babelway HTTP server.
- Http Client Gateway Out: With an Http Client Out Gateway, outgoing messages are sent using an Http connection.
-
Http Client Gateway Out (Deprecated): With an Http Client Out Gateway, outgoing messages are sent using an Http connection.
-
SOAP Client Gateway Out: With a Soap Client Out Gateway, outgoing messages are sent using a SOAP call and it is using synchronous request.
-
ePrior Gateway Out: With ePrior Out Gateway, outgoing messages are made available on Babelway ePrior server.
-
Simpl.ePrior Gateway Out: With Simpl.ePrior Out Gateway, outgoing messages are made available on Babelway ePrior server.
-
X.400 Gateway Out: With an X.400 Gateway, outgoing messages are sent to a specific trading partner address using an X.400 network.
-
NFS Gateway Out: Outgoing messages are pushed from Babelway to an NFS server.
-
SAP Gateway Out: Outgoing messages are pushed from Babelway to an SAP server.
-
Dropbox Gateway Out: Outgoing messages are pushed from Babelway to a Dropbox account.
-
Exact Postbox Gateway Out: Outgoing messages are pushed from Babelway to an Exact POSTBOX account.
-
Tradeshift Gateway Out: Outgoing messages are pushed from Babelway to a Tradeshift account.
-
Billtrust Gateway Out: Outgoing messages are pushed from Babelway to a Billtrust API.
-
VAN Gateway Out: Outgoing messages are pushed from Babelway to ECGrid VAN.
-
PEPPOL Gateway Out: Outgoing messages are sent to the PEPPOL network.
-
RosettaNet Gateway Out: Outgoing messages are sent to a RosettaNet server.
-
Amazon Marketplace Gateway Out: Outgoing messages are sent to Amazon marketplace account.
- Chorus Pro Gateway out:This gateway allows you to send invoices and credit note to the french administration network.
-
NemHandel Gateway Out: Outgoing messages are sent to the NemHandel network.
- Database Gateway OUT: pushes content from an XML file (gateway OUT) into table rows.
Email gateway in allows you to receive incoming messages sent to a specific Babelway email address, as attachments. The messages are processed as soon as they arrive.
The specific settings are:
The email address to which the incoming messages are sent as email attachment. If the address already exists, you will have to enter a new address. Remember that this email address will only be created at channel deployment. |
|
By default we will process all files received. Unselect this box if you wish to define a specific rule. |
|
Pattern (regular expression) for the file name in the email of the file that will become your input message. First match is used. |
|
Allows you to save other files of the email for future use. For every file that you want to save, you have to specify the pattern of the file name in the email and the name of the metadata in which you want to save the content. If one pattern matches multiple files, it is possible to save them all if you guarantee to generate a different metadata name for each. This can be achieved by using the capturing groups of the regex in the metadata names. Ex: if your pattern is (.*\.csv) and your metadata name is attachment-$1, processing with files file1.csv and file2.csv will result in two metadata as follows attachment-file1.csv and attachment-file2.csv . |
Note:
- This "Gateway In" filters out images in the attachment with the formats (bmp, gif, jpg, jpeg, png, eml, vcf) .
- In Babelway, we're using the standard Java version of REGEX, and it's the same used all over the system.
- If there is a file name provided in the "Message In" or "Message Out" which contain ~ tilde character, All browser based on Chromium will replace the ~ tilde character by the _ underscore character when you try to download the file from the Babelway interface, For more details you can check this link https://bugs.chromium.org/p/chromium/issues/detail?id=479419
- The maximum file size accepted by this gateway is 20 MB.
Email IMAP client Gateway In
This new gateway allows the customer to connect his own mailbox to Babelway, and Babelway poll in a folder of the mailbox. We use the IMAP protocol to connect and fetch mail.
The messages are processed as soon as they arrive.
The specific settings are:
Email provider |
The email provider that will allow the system to fetch the mails from |
|
Connection type |
The authentication type that will allow the system to connect the customer mail |
|
Host |
The email provider host |
|
Username |
The username of the customer’s email |
|
Password |
The password of the customer’s email in case you are using the credentials connection type |
|
Folder to fetch |
The folder that will allow the system to fetch the mails from |
|
OAuth2 provider |
In case the OAuth2 connection type, you should select the Microsoft or the Custom |
|
Authorization code URL |
The URL of the OAuth2 provider |
|
Access token URl |
The URL of the access token |
|
Application ID |
The client ID for the access token |
|
Client secret |
The secret of the client ID to get the access token |
|
Process all files |
By default, we will process all files received. Unselect this box if you wish to define a specific rule. |
|
File name pattern |
Pattern (regular expression) for the file name in the email of the file that will become your input message. First match is used. |
|
Other files to save |
Allows you to save other files of the email for future use. For every file that you want to save, you have to specify the pattern of the file name in the email and the name of the metadata in which you want to save the content. If one pattern matches multiple files, it is possible to save them all if you guarantee to generate a different metadata name for each. This can be achieved by using the capturing groups of the regex in the metadata names. Ex: if your pattern is (.*\.csv) and your metadata name is attachment-$1, processing with files file1.csv and file2.csv will result in two metadata as follows attachment-file1.csv and attachment-file2.csv . |
|
Here are the steps to configure such gateway.
Firstly, you should select to use the IMAP mail client and select the mail provider either to be Microsoft or custom mail as seen below:
Then you can connect with your credentials directly in Babelway OR via OAuth2 with an access_token.
And in case you select the mail provider to be “Custom”, you should fill the required fields like the host, port, username and the folder to fetch the mails from as seen below:
For the Microsoft mail provider, the fields should be filled as seen below:
If you change “CONNECTION TYPE” by credentials instead of oauth2, you need to put you email and password as seen below:
FTP Client Gateway In
With an Ftp Client In Gateway, incoming messages are transferred from an external Ftp server. Babelway polls files from this server at regular intervals. You may need this gateway to integrate with Wayfair for example.
The specific settings are:
External ftp server address where Babelway should fetch messages, e.g. ftp.example.com |
|
Login or username to access files on this external ftp server. |
|
Password associated to the username. |
|
Indicates that the ftp connection is in passive. Ticking this means the ftp client will establish 2 connections to the ftp server. |
|
Directory where files are to be fetched on the server. |
|
The file pattern is a regex used to filter files to import (ex: '.*\.csv' for all files ending with '.csv' or '(?!proc_).*\.csv' for all csv files that don't start with 'proc_'. If left empty, all files will be transferred. |
|
Select FTP, FTPS (Explicit mode) or FTPS (Implicit mode) protocol. |
|
The private key associated with the previous username to access your account. This can be left empty if you choose to only use the password authentication mechanism. |
|
Suffix that will be appended to the file name when a file is being transferred. This mechanism is used to prevent that a file is transferred twice. |
|
What will happen to your file after we have read it. This behavior is important so that your file is not read again at next poll. The possible values are :
|
|
Suffix that will be appended to the file name when a file has been completely transferred. |
|
Directory where transferred files will be moved. |
|
Cron expression. Allows you to define complex time expressions like every weekday night at 23:00 (0 0 23 ? * MON-FRI *) and the time zone for the polling. If left empty, the system will check at least once every 15 minutes. For easy creation of your cron expression, you can use the online cron maker tool available at http://www.cronmaker.com/. For more information, please refer to the page:http://www.quartz-scheduler.org/documentation/quartz-2.x/tutorials/tutorial-lesson-06.html |
When a message is transferred to the ftp server, it is processed immediately then the original file is removed from the server.
Note:
- In the "General" page for this Gateway In you can see the "Poll now" button. When clicking on this button this will poll all of the messages immediately (and will not wait for the next defined moment).
- In Babelway, we're using the standard Java version of REGEX, and it's the same used all over the system.
- If there is a file name provided in the "Message In" or "Message Out" which contain ~ tilde character, All browser based on Chromium will replace the ~ tilde character by the _ underscore character when you try to download the file from the Babelway interface, For more details you can check this link https://bugs.chromium.org/p/chromium/issues/detail?id=479419
- You can check bunch of info like last success date, last message date …etc. by pressing on Run Info button.
- The maximum file size accepted by this gateway is 100/250 MB.
With a Ftp Server In Gateway, incoming messages are received on a Babelway specific ftp server and processed as soon as they arrive.
The specific settings are:
Babelway ftp server is the hostname for the ftp server where the files will be fetched. |
|
Login or username to access your account on Babelway ftp server. This username must be unique as it is linked to a specific directory on the ftp server. |
|
Password associated with the username. |
|
The directory on the ftp server on which you wil have to put your files so that they are processed by this gateway. |
After channel deployment, your ftp server will be available to send messages. You can access this ftp server using any ftp client software set up with the previous account settings.
The files sent by FTP commands STOR, STOU, APPE are processed as soon as the command is completed. There is no need to use a temporary file name suffix or other precautions. The FTP server does not support FTP commands RMD, MKD, RNTO.
Babelway FTP gateways are supporting FTP and FTPS (Explicit mode) on port 21. It also support FTPS (Implicit mode) on port 990.
Note:
- The ports used for the FTP connections in Babelway are: (FTP, FTPs explicit : 20020-21020, FTPs implicit : 22021-23020).
- There is no need to use temporary file name suffix when sending files to "Gateway In" of type FTP server, There is no risk of collision because our FTP server does not use a filesystem. Instead, the data are directly sent to the Babelway messaging engine when the upload command is completed.
- If there is a file name provided in the "Message In" or "Message Out" which contain ~ tilde character, All browser based on Chromium will replace the ~ tilde character by the _ underscore character when you try to download the file from the Babelway interface, For more details you can check this link https://bugs.chromium.org/p/chromium/issues/detail?id=479419
- The maximum file size accepted by this gateway is 100/250 MB.
With an SFTP Client Input Gateway, incoming messages are transferred to an external SFTP server. Babelway platform polls this server at regular intervals and retrieves incoming files to process them.
The specific settings are:
Sftp server host name. |
|
Login or username to access files on this external sftp server. |
|
Password associated with the username. |
|
Private key associated with the username. |
|
Directory where files are to be fetched on the server. |
|
The file pattern is a regex used to filter files to import (ex: '.*\.csv' for all files ending with '.csv' or '(?!proc_).*\.csv' for all csv files that don't start with 'proc_'. If left empty, all files will be transferred. |
|
Cron expression. Allows to define complex time expression like every weekday night at 23:00 (0 23 ? * MON-FRI) and the time zone for the polling. If left empty, the system will check at least once every 15 minutes. For easy creation of your cron expression, you can use the online cron maker tool available at http://www.cronmaker.com/. For more information, please refer to the page:http://www.quartz-scheduler.org/documentation/quartz-2.x/tutorials/tutorial-lesson-06.html |
|
Suffix that will be appended to the file name when a file is being transferred. This mechanism is used to prevent that a file is transferred twice. |
|
What will happen to your file after we have read it. This behavior is important so that your file is not read again at next poll. The possible values are :
|
|
Suffix that will be appended to the file name when a file has been completely transferred. |
|
Directory where transferred files will be moved. |
Note:
-
Babelway By default connect to the remote SFTP server on port 22 but if you want to connect to this remote SFTP server using different port then use the below.
In the Server field add the port number you want to use it, For example if use X.X.X.X:1722 in the Server field which means connect to the remote SFTP server X.X.X.X on port 1722.
-
In the "General" page for this Gateway In you can see the "Poll now" button. When clicking on this button this will poll all of the messages immediately (and will not wait for the next defined moment).
- In Babelway, we're using the standard Java version of REGEX, and it's the same used all over the system.
- If there is a file name provided in the "Message In" or "Message Out" which contain ~ tilde character, All browser based on Chromium will replace the ~ tilde character by the _ underscore character when you try to download the file from the Babelway interface, For more details you can check this link https://bugs.chromium.org/p/chromium/issues/detail?id=479419
- You can check bunch of info like last success date, last message date …etc. by pressing on Run Info button.
- The maximum file size accepted by this gateway is 100/250 MB.
Using the SFTP Server In Gateway, incoming messages are received on a Babelway specific server and processed as soon as they arrive. The SFTP server gateway supports SFTP version 3 and password and/or public key user authentication mechanisms.
The specific settings are:
Babelway sftp server is the hostname for the sftp server where the files will be fetched. |
|
Login or username to access your account on the Babelway SFTP server. This username must be unique as it is linked to a specific directory on the SFTP server. |
|
The password associated with the username. This can be left empty if you choose to only use the public key authentication mechanism. |
|
The public key associated with the username. This can be left empty if you choose to only use the password authentication mechanism. The supported formats are RSA public key (OpenSSH, Putty or DER format). More information about generating such a key can be found at the end of this page. |
|
The directory on the ftp server on which you wil have to put your files so that they are processed by this gateway. |
You can set both password and public key fields. Therefore, you will be able to connect to your account either by using a password or by using your private key associated with the uploaded public key.
After channel deployment, your SFTP server will be available to send messages. You can access this SFTP server using any SFTP (version 3) client software set up with the previous account parameters.
When a message is received by the SFTP server, it is directly processed. After processing, the file is removed from the server.
The public key is expected to be in an RSA format (OpenSSH, Putty or DER). If you don’t already have a public/private key, you can generate one using ssh-keygen from OpenSSH :
ssh-keygen.exe Generating public/private rsa key pair. Enter file in which to save the key (/.ssh/id_rsa): /tmp/identity Enter passphrase (empty for no passphrase): Enter same passphrase again: Your identification has been saved in /tmp/identity. Your public key has been saved in /tmp/identity.pub. The key fingerprint is: f0:e4:2f:(...) user@computer
PUBLIC KEY AUTHENTICATION FOR SSH
The SSH protocol supports many authentication methods. Arguably one the most important of these is public key authentication for interactive and automated connections.
Public key authentication over simple passwords is used for security. It provides cryptographic strength that even extremely long passwords can not offer. With SSH, public key authentication improves security considerably as it frees the users from remembering complicated passwords (or worse yet, writing them down).
In addition to security public key authentication also offers usability benefits - it allows users to implement single sign-on across the SSH servers they connect to. Public key authentication also allows automated, passwordless login that is a key enabler for the countless secure automation processes that execute within enterprise networks globally.
Public key cryptography revolves around a couple of key concepts. The sections below explain these briefly.
ASYMMETRIC CRYPTOGRAPHY - ALGORITHMS
As with any encryption scheme, public key authentication is based on an algorithm. There are several well-researched, secure, and trustworthy algorithms out there - the most common being the likes of RSA and DSA. Unlike the commonly known (symmetric or secret-key) encryption algorithms the public key encryption algorithms work with two separate keys. These two keys form a pair that is specific to each user.
KEY PAIR - PUBLIC AND PRIVATE
In the SSH public key authentication use case, it is rather typical that the users create (i.e. provision) the key pair for themselves. SSH implementations include easily usable utilities for this (for more information see ssh-keygen and ssh-copy-id).
Each SSH key pair includes two keys:
A public key that is copied to the SSH server(s). Anyone with a copy of the public key can encrypt data which can then only be read by the person who holds the corresponding private key. Once an SSH server receives a public key from a user and considers the key trustworthy, the server marks the key as authorized in its authorized_keys file. Such keys are called authorized keys.
A private key that remains (only) with the user. The possession of this key is proof of the user's identity. Only a user in possession of a private key that corresponds to the public key at the server will be able to authenticate successfully. The private keys need to be stored and handled carefully, and no copies of the private key should be distributed. The private keys used for user authentication are called identity keys.
SETTING UP PUBLIC KEY AUTHENTICATION FOR SSH
The following simple steps are required to set up public key authentication (for SSH):
Key pair is created (typically by the user). This is typically done with ssh-keygen.
Private key stays with the user (and only there), while the public key is sent to the server. Typically with the ssh-copy-id utility.
Server stores the public key (and marks it as authorized).
Server will now allow access to anyone who can prove they have the corresponding private key.
Reference: https://www.ssh.com/ssh/public-key-authentication
Note:
- If there is a file name provided in the "Message In" or "Message Out" which contain ~ tilde character, All browser based on Chromium will replace the ~ tilde character by the _ underscore character when you try to download the file from the Babelway interface, For more details you can check this link https://bugs.chromium.org/p/chromium/issues/detail?id=479419
- The maximum file size accepted by this gateway is 100/250 MB.
AS2 Gateway In
With an AS2 Gateway, incoming messages are received using an AS2 connection. Incoming files are processed as soon as they are received. (see how Walmart, Rite Aid, Wayfair. and Amazon use AS2)
AS2 (Applicability Statement 2) is a specification about how to transport data securely and reliably over the Internet. Security is achieved by using digital certificates and encryption.
The specific settings are:
AS2 ID of the server that sends incoming messages. Provided by your partner. |
|
AS2 ID of the Babelway destination server. You must communicate it to your partner. |
|
URL address used by your partner to send messages to this gateway. It works for both http and https protocol. |
|
File containing instructions and certificates for the installation. You should download it and send it to your AS2 partner. |
|
Should message signature be enforced or not. |
|
Certificate used for message verification. Provided by your partner. |
|
Should message encryption be enforced or not. |
|
Local certificate to use for decrypting the AS2 messages. These certificates are kept in the environment certificates store. |
|
Maximum number of retries if message sending failed. Default is 5 times. |
|
Interval of time before trying to send message again (in seconds). Default is 60 (1 minute) and the maximum is 600 (10 minutes). |
After channel deployment, your AS2 connection will be available to receive messages.
Note: Babelway use Hermes 2 which is Drummond Group certified AS2 software, For more details you can check the below link.
http://hermes.cecid.org/en/latest/
To report AS2 settings to the other party, download the AS2 documentation ZIP file. This file can be sent to the other party to give them all settings they will require to establish a communication with your channel.
Note: The Listening ports for the AS2 Gateway are:
-
When using the HTTPS protocol the Listening port is 443.
-
When using the HTTP protocol the Listening port is 80.
- If there is a file name provided in the "Message In" or "Message Out" which contain ~ tilde character, All browser based on Chromium will replace the ~ tilde character by the _ underscore character when you try to download the file from the Babelway interface, For more details you can check this link https://bugs.chromium.org/p/chromium/issues/detail?id=479419
- The maximum file size accepted by this gateway is 100/250 MB.
- The maximum filename supported for the AS2 "Gateway In" is 255 characters.
With an Oftp server Gateway in, Incoming messages are received on a Babelway specific OFTP server and processed as soon as they arrive.
The specific settings are:
The OFTP ID provided by your partner. |
|
The SFID provided by your partner. If none has been provided, this is probably the same as SSID. |
|
The password of your partner. Provided by your partner. |
|
Babelway is providing an official Odette SSID : O01770000000000X0B5SHARED. Please call support if you want to use a different one. |
|
An SFID is automatically assigned to your Environment: O01770000000000X0B5xxxxxx. Please call support if you want to use a different one. |
|
The value of the password is 'BABELWAY'. |
|
File containing instructions and certificates for the installation. You should download it and send it to your OFTP partner. |
|
Compresses the messages. |
|
Use OFTP2 'Secure Authentication'. This will use the certificates defined for encryption and signature. |
|
Sign outgoing messages using the key selected in "Signature certificate". This allows your partner to verify that you are the one sending the message. This option is only available with OFTP 2.0. |
|
Select signature certificate or go to certificates store. These certificates are also used for decrypting incomming messages. Multiple certificates for decryption are possible, but only first one in the list is used for signing. This option is only available with OFTP 2.0. |
|
Encrypt outgoing messages using the certificate selected in "Encryption certificate". This allows your partner to be the only one able to decrypt the messages sent. This option is only available with OFTP 2.0. |
|
Select encryption certificate or go to certificates store. |
|
Select encryption algorithm or go to certificates store. |
|
This allows you to verify that your partner is the one sending the message using the certificate selected in "Signature verification certificate". This option is only available with OFTP 2.0. |
|
Select certificate for data or go to certificates store. |
|
Requests that incoming acknowledgments are signed. The signature will be verified using the Certificate selected in "EERP verification certificate". This allows you to be sure that only the partner could have signed the incoming messages. This option is only available with OFTP 2.0. |
|
Select certificate for EERP or go to certificates store. |
|
Advanced. Once the connection is open the OFTP gateway will act as both sender and receiver by default. You can control this by setting the following values : BOTH / RECEIVER_ONLY / SENDER_ONLY |
|
Advanced. Babelway is supporting both OFTP1 and OFTP2. When a connection is open, Babelway uses the OFTP built-in mechanism to negotiate the protocol version. The protocol will be the highest possible. Valid values are : OFTP_V12 for version 1.2 / OFTP_V13 for version 1.3 / OFTP_V14 for version 1.4 / OFTP_V20 for version 2.0 |
|
Advanced. Control the OFTP "creditCount" parameter. This is the number of data command ( = CREDIT) that could be exchanged prior to an OFTP confirmation from the partner. Default is 64 |
|
Advanced. Control the OFTP "dataExchangeBufferSize" parameter. This is the size of the OFTP data buffer. It should be smaller than the maxBDataLen for ISDN connection. The minimum is 128 bytes and the maximum is 4096 for ISDN and 65535 for TCP connections. Default is 1024. |
After channel deployment, your Oftp server will be available to send messages. You can access this oftp server using any Oftp client software set up with the previous account settings.
If you require a custom SSID / SFID / PASSWORD, please send a request to support@babelway.com .
When a message is transferred to the Oftp server, it is processed immediately then the original file is removed from the server.
Note:
- If there is a file name provided in the "Message In" or "Message Out" which contain ~ tilde character, All browser based on Chromium will replace the ~ tilde character by the _ underscore character when you try to download the file from the Babelway interface, For more details you can check this link https://bugs.chromium.org/p/chromium/issues/detail?id=479419
- The maximum file size accepted by this gateway is 100 MB.
With an OFTP Client In Gateway, incoming messages are transferred from an external OFTP server. The Babelway platform polls this server at regular intervals and retrieves files to process them.
The specific settings are:
The OFTP ID provided by your partner. |
|
The SFID provided by your partner. If none has been provided, this is probably the same as the SSID. |
|
The password of your partner. Provided by your partner. |
|
Babelway is providing an official Odette SSID : O01770000000000X0B5SHARED. Please call support if you want to use a different one. |
|
An SFID is automatically assigned to your Environment: O01770000000000X0B5xxxxxx. Please call support if you want to use a different one. |
|
The value of the password is 'BABELWAY'. |
|
File containing instructions and certificates for the installation. You should download it and send it to your OFTP partner. |
|
The URL of the server of your partner. It is provided by your partner. |
|
The port to connect onto. It is provided by your partner. |
|
Use TLS (SSL) for communication |
|
Use this certificate to perform client side TLS (SSL) authentication. |
|
Cron expression. Allows to define complex time expressions like every weekday night at 23:00 (0 0 23 ? * MON-FRI *) and the time zone for the polling. If left empty, the system will check at least once every 15 minutes. For easy creation of your cron expression, you can use the online cron maker tool available at http://www.cronmaker.com/. For more information, please refer to the page:http://www.quartz-scheduler.org/documentation/quartz-2.x/tutorials/tutorial-lesson-06.html |
|
Compresses the messages. |
|
Use OFTP2 'Secure Authentication'. This will use the certificates defined for encryption and signature. |
|
Sign outgoing messages using the key selected in "Signature certificate". This allows your partner to verify that you are the one sending the message. This option is only available with OFTP 2.0. |
|
Select signature certificate or go to certificates store. These certificates are also used for decrypting incomming messages. Multiple certificates for decryption are possible, but only first one in the list is used for signing. This option is only available with OFTP 2.0. |
|
Encrypt outgoing messages using the certificate selected in "Encryption certificate". This allows your partner to be the only one able to decrypt the messages sent. This option is only available with OFTP 2.0. |
|
Select encryption certificate or go to certificates store. |
|
Select encryption algorithm or go to certificates store. |
|
This allows you to verify that your partner is the one sending the message using the certificate selected in "Signature verification certificate". This option is only available with OFTP 2.0. |
|
Select certificate for data or go to certificates store. |
|
Requests that incoming acknowledgments are signed. The signature will be verified using the Certificate selected in "EERP verification certificate". This allows you to be sure that only the partner could have signed the incoming messages. This option is only available with OFTP 2.0. |
|
Select certificate for EERP or go to certificates store. |
|
Advanced. Once the connection is open, the OFTP gateway will act as both sender and receiver by default. You can control this by setting the following values : BOTH / RECEIVER_ONLY / SENDER_ONLY |
|
Advanced. Babelway supports both OFTP1 and OFTP2. When a connection is open, Babelway uses the OFTP built-in mechanism to negotiate the protocol version. The protocol will be the highest possible. Valid values are : OFTP_V12 for version 1.2 / OFTP_V13 for version 1.3 / OFTP_V14 for version 1.4 / OFTP_V20 for version 2.0 |
|
Advanced. Control the OFTP "creditCount" parameter. This is the number of data command ( = CREDIT) that could be exchanged prior to an OFTP confirmation from the partner. Default is 64 |
|
Advanced. Control the OFTP "dataExchangeBufferSize" parameter. This is the size of the OFTP data buffer. It should be smaller than the maxBDataLen for ISDN connection. The minimum is 128 bytes and the maximum is 4096 for ISDN and 65535 for TCP connections. Default is 1024 |
After channel deployment, your Oftp server will be available to send messages. You can access this oftp server using any Oftp client software set up with the previous account settings.
If you require a custom SSID / SFID / PASSWORD, please send a request to support@babelway.com .
When a message is transferred to the Oftp server, it is processed immediately then the original file is removed from the server.
Note:
- In the "General" page for this Gateway In you can see the "Poll now" button. When clicking on this button this will poll all of the messages immediately (and will not wait for the next defined moment).
- If there is a file name provided in the "Message In" or "Message Out" which contain ~ tilde character, All browser based on Chromium will replace the ~ tilde character by the _ underscore character when you try to download the file from the Babelway interface, For more details you can check this link https://bugs.chromium.org/p/chromium/issues/detail?id=479419
- You can check bunch of info like last success date, last message date …etc. by pressing on Run Info button.
- The maximum file size accepted by this gateway is 100 MB.
With an Http In Gateway, incoming messages are received as HTTP Post on the Babelway HTTP server and processed as soon as they arrive.
The HTTP Post can use the following encoding method: HTML Form, base64 and urlencode.
Babelway is supporting synchronous processing of messaging. This is available when you submit messages using our HTTP gateway using SOAP and the SOAP operation: "process Message". The response will contain the final result of the execution of the messages. If the messages generate more than one message, the response will contain the full graph of processed messages.
It is also available through the REST of the gateways. There is only a limited available documentation on this topic, but we would be more than happy to understand more your requirements and provide a proof of concepts for you.
The specific settings are:
You can select from BASIC or CERT. BASIC is user/password authentication. CERT is 2-way SSL authentication. OAuth 1a |
|
Login or username to access the service. |
|
Password associated with previous username. |
|
The certificate used to validate the client certificate. |
|
Using the HTTP(S) Post protocols. Support HTTP and HTTPS protocols. The old address http(s)://{URL}/ws/HttpPostIn is still available, where {URL} is the same as the one in the new url http(s)://{URL}/ws/gateways/... |
|
Using the SOAP Post protocols. WSDL. Support HTTP and HTTPS protocols. |
|
Using the HTTPS 2way authentication Post protocols. |
|
Check the message posting was performed using a Http POST submit. |
|
If the option "Submitted using a FORM" is used, this selects the parameter where to find the content of the message. |
Note: The HTTP server Gateway uses the port 80 for HTTP and 443 for HTTPS.
This "Gateway In" allow to provide the username and password in the URL when using the HTTP Post URL, The below print screen shows an example for this configuration.
The URl is http://eu1.babelway.net/ws/gateways/501484 ?userName=test4321&pwd=kM7kqSpFRkSX5nXZ
Note:
- You will need to download the WSDL file for this gateway by using the SOAP URL in the browser then login using the user name and password for this gateway in order to download the WSDL file for this environment as for some environments the SOAP URL and the WSDL file are different from other environments.
- When using OAuth 1a, Then the Authorization header, must be in the request headers, and not in the body.
- If there is a file name provided in the "Message In" or "Message Out" which contain ~ tilde character, All browser based on Chromium will replace the ~ tilde character by the _ underscore character when you try to download the file from the Babelway interface, For more details you can check this link https://bugs.chromium.org/p/chromium/issues/detail?id=479419
- The maximum file size accepted by this gateway is 100 MB.
The Http Client allows to periodically retrieve the content of the Http response to a specific URL.
Configuration file |
If you fill it, only this file is used for the configuration. |
Variables |
Allow you to create variables with the response of the call. |
Authentication Type |
You can select from (Basic, Digest, Ntlm, Any, Cert, Form, OAuth 1a, OAuth 2.0 with Bearer, OAuth 2.0 with Credentials) depend on the server response. |
Login url |
If authentication method is (Form, OAuth 2.0 with Credentials). |
Username |
Username used for (Basic, Digest, Ntlm, Any) authentications. For Ntlm authentication, the username can be prepended by the domain (domain/username). |
Password |
Password used for (Basic, Digest, Ntlm, Any) authentications. |
Preemptive Authentication |
Allows to send authentication information with the first http request (to avoid making a second request). |
Trust Level |
The trust level defines the level of security used in the SSL handshake. Relax = No certificate verification. The default is Standard. |
Valid HTTP return code |
Comma separated list of expected return Http code. |
Certificate Alias |
Alias of an existing key certificate. |
Login URL |
If authentication method is (Form, OAuth 2.0 with Credentials). |
Http Headers |
You can add specific http header(s). |
Form Fields |
When using (Form, OAuth 2.0 with Credentials) authentication, you can add specific authentication form fields to the authentication call. |
Grant Type |
You can select (Client Credentials, Password, Other). Client Credentials (Scope, Username, Password). |
ContentType |
You can select (application/json, FORM_URLENCODED). |
OAuth1 Signature Method |
If OAuth 1a authentication is used, this allows select the signature algorithm to use. Note that if SHA1withRSA is used, a Key alias must be selected. |
OAuth1 Consumer Key |
If OAuth 1a authentication is used, this allows defining the consumer key. This is mandatory. |
OAuth1 Consumer Secret |
If OAuth 1a authentication is used, this allows defining the consumer secret. This is optional. |
OAuth1 Token |
If OAuth 1a authentication is used, this allows defining the token. This is mandatory. |
OAuth1 Token Secret |
If OAuth 1a authentication is used, this allows defining the token secret. This is optional. |
OAuth1 Key Alias |
If SHA1withRSA is used, a Key alias must be selected. |
OAuth1 Realm |
The realm value is a string, generally assigned by the origin server, which may have additional semantics specific to the authentication scheme. |
Bearer |
If OAuth 2.0 with Bearer authentication is used, this allows selecting the OAUTH bearer token to use. |
Calls |
In this section you define one or multiple API calls. |
Name |
Name of a call, used in the next step to go to another call. |
HTTP method |
You can specify the http method to call. |
URL |
URL to call to create a message. |
Use the global authentication |
When enabled the call will be done using the global authentication defined. |
Content |
Content to send, for Gateway out, if no content, we send the message. |
Timeout |
Timeout for connection in milliseconds. Must be between 10000 and 240000. |
Post Action |
In a call you can create a Post Action, to do something with the response of your request. |
Condition |
Condition of the creation of the message. |
Response FileName |
Allow you to define a FileName for the new message. |
Set Metadatas |
Allow you to create metadata in the Babelway context. |
Connected Gateways |
Connected Gateways to send the message. |
Next Step |
Name of the next call to run after this one. |
Validate |
Allow you to validate the content of the call response. |
Error Message |
The error message that will be generated in Babelway when the Validate fails. |
Scheduling |
By default, the gateway will regularly poll the messages from your Dropbox account, so that they come into Babelway a short time (less than 10 minutes) after they have been placed in your Dropbox account. |
Main Information
What is the benefit of using the new HTTP Client "Gateway In" VS old deprecated HTTP Client "Gateway In" ?
- The new HTTP Client "Gateway In" allows to chain multiple HTTP calls.
- For each call the user can manipulate and store part(s) or all of the received response information of the current call to be used in the second call if needed based on the HTTP call specification to be implemented.
- The new HTTP Client "Gateway In" supports scripting language.
Expression
The below print screen shows the expression which the user can select one of the (Constant, Script, Metadata) values, as shown below.
Constant : When selected the user will provide a static text that will be used as a value in this field.
Script : When selected the user will provide a script code which its result will be used in this field to achieve the user logic in this section.
Note:
- For security reasons we use a black box to run the Javascript code and it does not contain many libraries.
- The Script engine is fully compatible with ECMAScript 5.1.
Script Functions
The "HttpClientFunctions" class have the below functions defined that can be used in the Javascript code
- HttpClientFunctions.HmacMD5(String data, String key, Boolean base64Encode)
- HttpClientFunctions.HmacSHA1(String data, String key, Boolean base64Encode)
- HttpClientFunctions.HmacSHA256(String data, String key, Boolean base64Encode)
- HttpClientFunctions.HmacSHA512(String data, String key, Boolean base64Encode)
- HttpClientFunctions.base64Encode(String toEncode)
- HttpClientFunctions.base64Decode(String toDecode)
- HttpClientFunctions.rsaEncrypt(String toEncrypt, String publicKeyAlias)
- HttpClientFunctions.xmlToJson(String data)
The below example shows the use of the HmacSHA256() function from the "HttpClientFunctions" class which will generate the base64 value of the HmacSHA256 of "message" with the key "secret", as shown below.
HttpClientFunctions.HmacSHA256('message','secret',true);
Metadata : When selected the user will provide a metadata name between curly bracket like for example {MetadataName}, This can be a user defined metadata which is generated from the current gateway.
Pattern in metadata : (only available for POST Multipart)
Name = Filename of the attachment in the multipart.
Value = Pattern to match the metadata containing the file to attach.
If one pattern matches multiple files, it is possible to put them all, if you guarantee to generate a different filename name for each one. This can be achieved by using the capturing groups of the regex in the filename. Ex: if your metadata pattern is attachment-(.*) and your filename is $1, processing with two metadata attachment-file1.csv and attachment-file2.csv will result in files, file1.csv and file2.csv.
File section
You can download and upload the configuration in XML format.
- Download the current saved configuration, After configuring HTTP Client "Gateway In" and testing it successfully you can download the current configuration which is saved in XML format.
- Upload the configuration in XML format, This will override the current configuration of the gateway by the provided configuration in the uploaded XML file.
Note: The download button will only download the saved configuration for the gateway, So if you have done some changes to the gateway which is not saved then all of the unsaved information will not be provided in the downloaded XML file.
Global information section
Scripting language is the scrip language used when the "Script" type is selected and the suported scripting language is JavaScript.
Variables
Allow the user to create variables which can be used in a different calls in this gateway when the expression type of "Script" is selected the result of the script will be used, as shown below.
Already defined variables (system variables)
By default Babelway will create the below system variables for each call and there values can be used when selecting the expression of type "Script".
- loginResponseContent : The body of the login response, save as text.
- loginResponseContentBytes : The body of the login response save as byte.
- loginResponseHeaders : The headers of the login response saved as key-value pairs, To get the value of the login response header write loginResponseHeaders.get("header_name")
- loginResponseCode : The status code of the login response.
- responseContent : The body of the response save as text.
- responseContentBytes : The body of the response save as byte.
- messageContent : The content of the message out save as text.
- messageContentBytes : The content of the message out save as byte.
- responseHeaders : The headers of the response saved as key-value pairs, To get the value of the response header write responseHeaders.get("header_name")
- responseCode : The status code of the response.
- responseCookies: The cookies of the response saved as key-value pairs. To get the value of a cookies, write responseCookies.get('sessionId');
Note:
- The response of the call is saved in the script system variable "responseContent" which can be used in the "Post Action" section.
- The expression of type "Script" is case sensitive and you will need to make sure when using the above variables to work properly to provide them using the correct case sensitive as mentioned above.
- For each call the old system variables will be overridden with the new response of the new call, So if you want to use the old system variable in other call(s) then you can save th old system variable in a user variable in the "Post Action - Validate" section.
Global Authentication and call Authentication sections
When a global authentication is defined then it can be used in the calls where the "Use the global authentication" option is enabled, as shown below.
In case for a specific call(s) you will need to use different authentication then you can create the needed authentication type from the "Authentication" section of each call, as shown below.
In case the call will not have any authentications then just make sure to disable the authentication for this call, as shown below.
Note: When using the call authentication of type "OAuth2.0 With Credentials" then you can extract the token from the authentication response and save the token in a metadata which will be used in the "Authorization" header of the call, This can be done by using the "loginResponseContent" variable and set the expression type to "Script", as shown below.
JSON.parse(loginResponseContent).access_token
Calls section
In this section you can create one call or more than one call to connect to a server to receiver or send data based on the logic you want to achieve, as shown below.
Name : This is the name of the call which is mandatory and also this name will be used in the "Post Action - Next Step" section when there are more than one call defined and each call is linked to the other call.
Timeout : Timeout for connection in milliseconds which is by default 90 seconds.
Valid HTTP return code : Comma separated list of expected return HTTP code which evaluates the response HTTP code in the header, If the return code is not in the list, the message is set in error, The default is '200,201,202,204,205'.
Post Action - Validate section
The validate section will allow us to validate the call and generate some user defined variables and user defined metadata to be used in other call(s) or channel(s).
Validate Condition : Allows you to validate the call and the call will be valid when the implemented condition result is true and when the result of condition is false the message will fail in error.
Error Message : When the result of the condition above is false the message will fail in error and the error message will be used from this field in the message details.
Variables : Allow you to create variables to be able to use in the calls in this gateway where supported.
Set metadatas : Allow you to create user defined metadata to be able to use in the calls in this gateway where supported and also will be sent the channel.
Post Action - Create message section
In order to create a message from the received response body from the current HTTP Client "Gateway In" of this channel, It is a must to use "Script" expression with the value of "responseContent" in the "Content" which will be created by default, as shown below.
Note: You can change the "responseContent" with any other system variables and also you can do some manipulation to only extract a part of the received response or even do other manipulation to achieve your request logic.
Condition : Allows you to create a condition to create a message only when the result of the condition is true so only for specific calls the message will be created.
Response FileName : Allow you to define the FileName for the new message created, If this is empty then the default is "httpresponse.txt".
Set metadatas : Allow you to create user defined metadata to be used in the channel when the message is created.
The most important is that all of the user defined metadata created in the "Post Action - Validation" section from all of the previous calls including this call will be sent to this channel and only the user defined metadata created in this "Post Action - Creat Message" section will be sent to this channel.
User Metadata Transfer Strategy : The strategy that will be used to transfer the user metadata to the new message created in the connected gateways.
Post Action - Next Step section
In order to be able to do multiple calls you will need to provide the second call name exactly in the "Next step" as you have already defined the call name in the "Name" field to be able to execute the second call after this call complete.
If the "Next step" has a typo the message will fail in error and when "Next step" is empty the execution will end and not other calls will be executed.
Beware that if you use a script, it must provide a string value for all possibly cases and an empty string for no further action:
if(responseCode == 404) "myNextStep" else ""
Babelway Message Metadata section
Allow you to update the "User comment" and "Gateway out message key" when the gateway execution is completed.
User comment metadata : Allow you to define the "User comment" of the current message, The value will be trimmed after 4096 characters.
Gateway (In/Out) Message Key : Allow you to define the "Gateway in message key" of the current message, The value will be trimmed after 100 characters.
Scheduling
Cron expression : By default, the gateway will regularly poll the messages (typically every 10-15 minutes).
You should usually not change this parameter, as the system will adapt automatically to different situations, but if you need to, you can write here the desired schedule (see http://www.cronmaker.com/ ) and choose the preferred time zone.
If you do this, please keep in mind :
The polling should not happen too often, to avoid putting too much load on your servers (especially if you have 1000s of gateways).
The polling should happen often enough so that
-The messages come quickly to the platform.
-You can recover quickly from errors (ex: if you set only one poll a day, and your server is unavailable during the polling, messages will be delayed of 24 hours, instead of a few minutes with default parameters).
-Poll runs are not too long. If they are, Babelway is allowed to cut the runs after some time, to guarantee fairness between all gateways, and prevent that one is monopolising resources for hours, and preventing others to run.
Message details Call log
To see the complete call log for each call which will help in investigation from the monitoring message details download the "httpClientGatewayFlowIn" ZIP file from the "Files" section.
For security reasons we will not log the "Authorization" header.
Note:
-
In the "General" page for this Gateway In you can see the "Poll now" button. When clicking on this button this will poll all of the messages immediately (and will not wait for the next defined moment).
- If there is a file name provided in the "Message In" or "Message Out" which contain ~ tilde character, All browser based on Chromium will replace the ~ tilde character by the _ underscore character when you try to download the file from the Babelway interface, For more details you can check this link https://bugs.chromium.org/p/chromium/issues/detail?id=479419
- You can check bunch of info like last success date, last message date …etc. by pressing on Run Info button.
- The maximum file size accepted by this gateway is 100 MB.
Http Client Gateway In (Deprecated)
The Http Client allows to periodically retrieve the content of the Http response to a specific URL
You can select from Basic, NTLM or OAuth 2.0 with Credentials depend on the server response. |
|
If authentication method is FORM. |
|
Url to call to create message. Support HTTP and HTTPS protocols. |
|
Username used for BASIC/NTLM/DIGEST authentication. For NTLM authentication, the username can be prepended by the domain (domain/username). |
|
Password used for BASIC/NTLM authentication. |
|
Comma separated list of expected return Http code. If the return code is not in the list, the polling generates an alert. The default is '200,201,202,204,205'. |
|
Timeout for connection in milliseconds. Must be between 10000 and 240000. |
|
You can specify the http method to call. The default is GET. |
|
You can specify the version of the TLS protocol. TLS is the replacement of SSL. The default is TLSv1.2. |
|
You can add specific http header. |
|
The trust level defines the level of security used in the SSL handshake. Relax = No certificate verification, Standard = trusting certificates in environment certificates as well as known CA's, Paranoiac = only trusts certificates defined in the environmnent certificates. The default is Standard |
|
If authentication method is FORM. |
|
When using FORM authentication, you can add specific authentication form fields to the authentication call. This accepts metadata. |
|
You can use data receive by the login request as metadata, which can be used in the data sending after login. |
|
Cron expression. Allows to define complex time expression like every weekday night at 23:00 (0 0 23 ? * MON-FRI *) and the time zone for the polling. If left empty, the system will check at least once every 15 minutes. For easy creation of your cron expression, you can use the online cron maker tool available at http://www.cronmaker.com/. For more information, please refer to the page:http://www.quartz-scheduler.org/documentation/quartz-2.x/tutorials/tutorial-lesson-06.html |
When using the Authentication method of type OAuth 2.0 with Credentials we will do two calls, The first call will be through the URL provided in the "Login url" field then when we receive the response we can use regex to extract the data received in the response body and save them in a user defined metadata in the "Metadata from response" section then this created user defined metadata can be used in the second call in the "HTTP headers" section, as shown below.
Note:
-
The Gateway In of type "HTTP Client (Deprecated)" only supports the BASIC authentication mode.
-
In the "General" page for this Gateway In you can see the "Poll now" button. When clicking on this button this will poll all of the messages immediately (and will not wait for the next defined moment).
- If there is a file name provided in the "Message In" or "Message Out" which contain ~ tilde character, All browser based on Chromium will replace the ~ tilde character by the _ underscore character when you try to download the file from the Babelway interface, For more details you can check this link https://bugs.chromium.org/p/chromium/issues/detail?id=479419
- You can check bunch of info like last success date, last message date …etc. by pressing on Run Info button.
- The maximum file size accepted by this gateway is 100 MB.
The Web scraping allows to periodically retrieve messages using a scenario mimicking a browser navigating the web.
This gateway has to be enabled by Babelway support. For more information or to request the activation, please send a mail to support@babelway.com.
Xml definition of the web scraping scenario. |
|
The scenario will be executed once per iteration lookup table row block. The value of the lookup table will be added to the execution context and available using the VARIABLE::columnName function. The scenario will be executed once without parameters if the lookup table is left empty. |
|
If CERT authentication is used (2-way SSL authentication), this allows to select the key pair to use from the environment certificate. |
|
Cron expression. Allows to define complex time expression like every weekday night at 23:00 (0 0 23 ? * MON-FRI *) and the time zone for the polling. If left empty, the system will check at least once every 15 minutes. For easy creation of your cron expression, you can use the online cron maker tool available at http://www.cronmaker.com/. For more information, please refer to the page:http://www.quartz-scheduler.org/documentation/quartz-2.x/tutorials/tutorial-lesson-06.html |
Note:
- In the "General" page for this Gateway In you can see the "Poll now" button. When clicking on this button this will poll all of the messages immediately (and will not wait for the next defined moment).
- If there is a file name provided in the "Message In" or "Message Out" which contain ~ tilde character, All browser based on Chromium will replace the ~ tilde character by the _ underscore character when you try to download the file from the Babelway interface, For more details you can check this link https://bugs.chromium.org/p/chromium/issues/detail?id=479419
- The maximum file size accepted by this gateway is 100 MB.
This gateway in allows you to easily publish a REST api.
It has the following characteristics:
- It will respond synchronously to the REST api calls with the result of the processing of the message by the channels.
- It injects an xml message in that contains all the elements of the REST call (uri, parameters, expected output format, ...).
- It supports 'json', 'xml' and 'csv' as output format.
- It supports multi-credentials.
The specific settings are:
Part of the url that identifies this gateway. The urls to call the REST api will have the form https://ws.babelway.net/rest/ |
|
Activate this settings if you want to use the body of the API call (also known as the payload of the HTTP call) as message IN content. This only works with POST, PUT and PATCH HTTP methods. If you deactivate this options, your message content will look like the XML example we provided in the help guide. |
|
The URL to call the REST api. |
|
A list of user names/password pairs that are allowed to access this api. The user will have the choice to provide user name and password via http basic authentication, http settings 'user' and 'password' or http headers 'user' and 'password'. |
|
Optional. If filled, the requested url will be checked again. This pattern will be refused if it doesn't match at least one pattern. You can also prefix the pattern with 'PRE:', 'POST:', 'PUT:', ... if you want this pattern to only be accessible via one specific http method. |
Here is an example of message In, that is generated by this gateway if you use the HTTP method POST.
<?xml version="1.0" encoding="UTF-8"?> <restRequest> <uri>/sws/shipmentStatus/BE.json</uri> <identifier>sws</identifier> <action>shipmentStatus</action> <method>GET</method> <format>json</format> <userName>bertrand</userName> <parameters> <param1>BE</param1> <myParam>myValue</youpie> </parameters> <POST>... Payload or body of your HTTP call ... </POST> </restRequest>
xml tags will match the HTTP method you use to perform the call. Those would be if you are using the GET method, etc...
Below is how to use the URL parameters for a REST API Server Gateway IN
For example we have created the REST API Server Gateway IN with the below parameters as a test values for explanation
1-The "Url identifier" as "testurl".
2-Regarding the "Allowed credentials" the "Username" as "usernametest" and the "Password" as "passwordtest".
3-For this test environment the "Url to call" is "http://ws.babelway.net/rest/testurl/message(?URL Params).(json|xml)"
To use the URL settings for a REST API Server Gateway IN, for example, this is the Url to call "http://ws.babelway.net/rest/testurl/message(?URL Params).(json|xml)"
You will replace the (?URL Params) with your URL params you want to use them.
Regarding the (json|xml) here you can determine the format of the data.
Note: If you want to get the input message name then you have to select one of the two below mentioned options. This is due to the fact that, when using the REST API Server Gateway IN there is no file.
- Option one: You will need to include the input file name somewhere in the API call in the body of the HTTP call.
- Option two: You will need to include the input file name somewhere in the URL parameters.
Now you can use the name that you have provided by selecting one of the two above mentioned options to create the output message file name.
Note:
- If there is a file name provided in the "Message In" or "Message Out" which contain ~ tilde character, All browser based on Chromium will replace the ~ tilde character by the _ underscore character when you try to download the file from the Babelway interface, For more details you can check this link https://bugs.chromium.org/p/chromium/issues/detail?id=479419
- You can check bunch of info like last success date, last message date …etc. by pressing on Run Info button.
- The maximum file size accepted by this gateway is 100 MB.
An X.400 In Gateway allow to receive messages from X.400 networks. Your trading partners can reach you via your private X.400 address.
The specific settings are:
The account private address. This is the address to communicate to your trading partners. The formatting may vary from one partner to the other. The most common format is: C=WW; A=400NET; P=BABELWAY; S=HUB-25333 /C=WW/A=400NET/P=BABELWAY/S=HUB-25333. |
After channel deployment, your connection will be available to send messages.
The first time X.400 is used in an account, it has to be enabled by Babelway support. The request is done automatically and you will be notified when the gateway is functional.
Note:
- In the "General" page for this Gateway In you can see the "Poll now" button. When clicking on this button this will poll all of the messages immediately (and will not wait for the next defined moment).
- If there is a file name provided in the "Message In" or "Message Out" which contain ~ tilde character, All browser based on Chromium will replace the ~ tilde character by the _ underscore character when you try to download the file from the Babelway interface, For more details you can check this link https://bugs.chromium.org/p/chromium/issues/detail?id=479419
- The maximum file size accepted by this gateway is 100 MB.
The Scheduler in Gateway allows you to create a message based on a time trigger.
The specific settings are:
Number of seconds between two events. The default value is 90 seconds and cannot be lower. This is the simplest way to define a time event. For more complex needs, use the Cron Expression property instead. |
|
Cron expression. Allows you to define complex time expressions like every weekday night at 23:00 (0 0 23 ? * MON-FRI *) and the time zone for the polling. This takes precedence on the frequency property. For easy creation of your cron expression, you can use the online cron maker tool available at:http://www.cronmaker.com/. For more information, please refer to the following page:http://www.quartz-scheduler.org/documentation/quartz-2.x/tutorials/tutorial-lesson-06.html |
|
Message template that will be sent each time this scheduler is activated. If not filled, a default xml is used (that just contains the time and the gateway id). |
Note:
- In the "General" page for this Gateway In you can see the "Poll now" button. When clicking on this button this will poll all of the messages immediately (and will not wait for the next defined moment).
- If there is a file name provided in the "Message In" or "Message Out" which contain ~ tilde character, All browser based on Chromium will replace the ~ tilde character by the _ underscore character when you try to download the file from the Babelway interface, For more details you can check this link https://bugs.chromium.org/p/chromium/issues/detail?id=479419
- The maximum file size accepted by this gateway is 100 MB.
The internal gateway in / out is used to transfer messages between 2 channels within the same account environment.
There is no setting to define in this template. The internal gateway will be automatically created using the gateway name you entered. You will then be able to select it as an Internal Gateway Out in another channel configuration.
As opposed to most other gateways, the internal gateway is immediately available as the gateway out for other channels configuration without requiring a channel deployment.
Note:
- If there is a file name provided in the "Message In" or "Message Out" which contain ~ tilde character, All browser based on Chromium will replace the ~ tilde character by the _ underscore character when you try to download the file from the Babelway interface, For more details you can check this link https://bugs.chromium.org/p/chromium/issues/detail?id=479419
- The maximum file size accepted by this gateway is 100 MB.
This gateway exports periodically your message records (Messages details from the Monitoring). The export is in CSV, and is exactly the same format that you would have by exporting your messages manually in the interface.
The period with the messages to export. |
|
If selected the period will be applied from the end time of the message, rather than the beginning time (when it reached Babelway system). |
|
In addition to the time criteria, this setting allows you to define additional criteria to filter the messages to export. |
|
The list of gateways for which you want the processed messages. |
|
The list of channels for which you want the processed messages. |
|
Cron expression. Allows you to define complex time expressions like every weekday night at 23:00 (0 0 23 ? * MON-FRI *) and the time zone for the polling. If left empty, the export will be scheduled automatically based on your period criteria. For easy creation of your cron expression, you can use the online cron maker tool available at: http://www.cronmaker.com/. For more information, please refer to the following page: http://www.quartz-scheduler.org/documentation/quartz-2.x/tutorials/tutorial-lesson-06.html |
Note: In the "General" page for this Gateway In you can see the "Poll now" button. When clicking on this button this will poll all of the messages immediately (and will not wait for the next defined moment).
This Gateway In is used to get the Message records from your environment and then for example the channel which has this Gateway In will send to your system a custom statistics every 7 days, The below example show how this is done.
1-Create a Gateway In of type Message Record then set the Cron expression to scheduled every 7 days.
2-For example the Message Out is of type XML that will contain custom statistics structure, In the transformation map all of the field from the "Message In" to the "Message out" to achieve the required information.
3-Every seven days the channel will send a custom statistics XML file to your system, Below is a sample for the generated XML file.
Message Record Output
Note:
- If there is a file name provided in the "Message In" or "Message Out" which contain ~ tilde character, All browser based on Chromium will replace the ~ tilde character by the _ underscore character when you try to download the file from the Babelway interface, For more details you can check this link https://bugs.chromium.org/p/chromium/issues/detail?id=479419
- The maximum file size accepted by this gateway is 100 MB.
This gateway allows you to create a message from the content of a lookup table. The message created is a XML document. It uses the same format as the XML CSV representation used internally by Babelway.
The technical id of the lookup table. |
|
Check this to add the column names as headers of the messages created. |
|
Column used to filter the extract of the lookup tables entries. |
|
Value used to filter the extract of the lookup tables entries. |
|
Column used to filter the extract of the lookup tables entries. |
|
Value used to filter the extract of the lookup tables entries. |
|
Column used to filter the extract of the lookup tables entries. |
|
Value used to filter the extract of the lookup tables entries. |
|
Optional operation to perform on selected entries (NONE, DELETE and UPDATE) after extraction. Default is DELETE |
|
Column to update after the extract of the lookup tables entries, Only used with 'Update' in 'Post extract operation'. |
|
Column to update after the extract of the lookup tables entries, Only used with 'Update' in 'Post extract operation'. |
|
Value to use when updating the column to update. |
|
Maximum number of entries to extract in 1 execution of this gateway. |
|
Maximum number of entries per message. If the overall limit is bigger, several messages will be created for each execution of this gateway. |
|
Cron expression. Allows you to define complex time expressions like every weekday night at 23:00 (0 0 23 ? * MON-FRI *) and the time zone for the polling. If left empty, the system will check at least once every 15 minutes. For easy creation of your cron expression, you can use the online cron maker tool available at: http://www.cronmaker.com/. For more information, please refer to the following page: http://www.quartz-scheduler.org/documentation/quartz-2.x/tutorials/tutorial-lesson-06.html |
Note:
- In the "General" page for this Gateway In you can see the "Poll now" button. When clicking on this button this will poll all of the messages immediately (and will not wait for the next defined moment).
- If there is a file name provided in the "Message In" or "Message Out" which contain ~ tilde character, All browser based on Chromium will replace the ~ tilde character by the _ underscore character when you try to download the file from the Babelway interface, For more details you can check this link https://bugs.chromium.org/p/chromium/issues/detail?id=479419
- The maximum file size accepted by this gateway is 100 MB.
The NFS gateway is used to connect and fetch files from a remote NFS server.
Hostname of the NFS server. |
|
Name of the exported volume. |
|
NFS login method: use PCNFSD for username / password and UGID to directly use UID, GID and GIDS. |
|
Username used for the NFS authentication. Only used with PCNFSD login method. |
|
Password used for the NFS authentication. Only used with PCNFSD login method. |
|
Unix user UID to use during authentication. Only used with UGID login method. |
|
Unix user's group GID to use during authentication. Only used with UGID login method. |
|
Unix user's additional groups GID to use during authentication, encoded as a comma separated list. Only used with UGID login method. |
|
Local NFS path to the folder you want to use. This is relative to the export. |
|
If not empty, only the files whose name matches this pattern will be transferred. |
|
Suffix that will be appended to the file name when a file is being transferred. This mechanism is used to prevent that a file is transferred twice. |
|
What will happen to your file after we have read it. This behaviour is important so that your file is not read again at next poll. The possible values are :
|
|
Suffix that will be appended to the file name when a file has been completely transferred. The use of this mechanism allows you to keep the file after the transfer, with this suffix appended to its name. If left empty, the file will be deleted after the transfer. |
|
Directory where transferred files will be moved. |
|
By default, the gateway will regularly poll the messages from your NFS server, so that they come into Babelway a short time (less than 10 minutes) after they have been placed in your NFS server. You can write here a cron expression to customise the polling schedule and the time zone for the polling. For easy creation of your cron expression, you can use the online cron maker tool available at : http://www.cronmaker.com/. |
Note:
- In the "General" page for this Gateway In you can see the "Poll now" button. When clicking on this button this will poll all of the messages immediately (and will not wait for the next defined moment).
- If there is a file name provided in the "Message In" or "Message Out" which contain ~ tilde character, All browser based on Chromium will replace the ~ tilde character by the _ underscore character when you try to download the file from the Babelway interface, For more details you can check this link https://bugs.chromium.org/p/chromium/issues/detail?id=479419
- You can check bunch of info like last success date, last message date …etc. by pressing on Run Info button.
- The maximum file size accepted by this gateway is 100/250 MB.
The SAP Gateways are based on the SAP RFC protocol and JCo technology. RFC is an SAP interface protocol allowing internal or external systems to communicate with the SAP system. JCo is the Java implementation of RFC distributed by SAP. Babelway leverage the built-in JCo redundancy mechanism to distribute the gateway on our different locations (data centers).
System boundaries, acknowledgment and error management
For Inbound IDoc, Babelway sends the IDoc to SAP. If the message cannot be delivered to SAP, the error will be managed using the traditional Babelway process. Error notifications will be delivered to registered users. When the message is delivered to SAP, Babelway fetches the detailed status and error messages of the IDoc. The messages are always set to 'acknowledged' when the transmission is successfully. However the status could be SUCCESS or ERROR depending the SAP IDOC status code.
For Outbound IDoc, SAP sends IDOC to Babelway. If the message cannot be delivered to Babelway, the IDoc is in error in SAP with a status = 20. Once the message is delivered to Babelway, SAP automatically change the status to 03. In addition of this, we provide a function to explicitly change the status by calling the RFC defined during the setup phase. This allow SAP that the remaining of the IDoc processing will entirely take place in Babelway.
Connectivity Setup
Babelway provides the gateways to communicate in both direction. SAP Gateway In allows to receive outbound IDoc and SAP Gateway Out allows to send inbound IDoc to SAP. The JCo RFC Provider service uses a TCP/IP connection type. In order to secure this connection, Babelway advices one of the following solutions:
- Option 1: A strict firewall rule to allow Babelway public IP addresses to connect to the SAP server
- Option 2: Using SAP router in the DMZ, as well as the firewall configuration like in Option1
- Option 3: You can contact Babelway support to setup a IPSec VPN between the Babelway public IP addresses and the SAP server. Please send a request to support@babelway.com
The Port number used to contact the SAP system range from 3300 to 3399. The exact port number depends on the SAP system you want to reach. The exact port number must be given in the parameters (defined below). Firewall need to allow Babelway server to reach these ports.
SAP configuration
Here is the list of the SAP specific setup to perform in order to make the connector working. This is guide lines
- Create a "RFC destination" (transaction sm59) with the name "BABELWAY". The "Connection Type" is "TCP/IP Connection". Go to "Technical settings" and fill "BABELWAY" in the "Program ID" field. Go next to the "Unicode" tab and in the "Communication Type", select the "Unicode".
- Create a "Ports in IDoc processing" (transaction we21) in the "Transactional RFC" with the name "BABELWAY".
- For inbound IDoc, there is no special configuration. All programs are allowed to delivered IDocs for all partners. For outbound IDoc, Go to "Partner profiles" (transaction we20) then for each partner and each "Message Type" you want to change, go to "Outbound Options" and change the "Receiver port" to "BABELWAY" in the tab "tRFC".
- If you want to leverage the "Update Status" feature, you need to add the specific RFC call. By default the system will call the following function: ZZBABELWAY_IDOC_STATUS_UPD taking 2 input parameters: PI_DOCNUM (IDoc number) and PI_STATUS (the new status = 16). The code for such function is given below.
FUNCTION zzbabelway_idoc_status_upd .
*"----------------------------------------------------------------------
*"*"Local Interface:
*" IMPORTING
*" VALUE(PI_DOCNUM) TYPE EDI_DOCNUM
*" VALUE(PI_STATUS) TYPE EDI_STATUS
*" EXPORTING
*" VALUE(IDOC_CONTROL) LIKE EDIDC STRUCTURE EDIDC
*"----------------------------------------------------------------------
DATA : lv_document_number LIKE edidc-docnum.
DATA : ls_idoc_status LIKE edi_ds.
DATA : lt_idoc_status LIKE edi_ds OCCURS 0 WITH HEADER LINE.
DATA : lv_text(50).
DATA : lv_msg_var1 LIKE balm-msgv1.
WRITE pi_docnum TO lv_msg_var1 NO-ZERO.
CONDENSE lv_msg_var1 NO-GAPS.
ls_idoc_status-docnum = pi_docnum.
ls_idoc_status-status = pi_status.
ls_idoc_status-statyp = 'I'.
ls_idoc_status-stamid = 'ZZBABELWAY'.
ls_idoc_status-stamno = '001'.
ls_idoc_status-stapa1 = lv_msg_var1.
ls_idoc_status-logdat = sy-datum.
ls_idoc_status-logtim = sy-uzeit.
ls_idoc_status-stamqu ='SAP'.
ls_idoc_status-repid = 'ZZBABELWAY_IDOC_STATUS_UPD'.
CALL FUNCTION 'MESSAGE_PREPARE'
EXPORTING
language = 'E'
msg_id = 'ZZBABELWAY'
msg_no = '001'
msg_var1 = lv_msg_var1
* MSG_VAR2 = ' '
* MSG_VAR3 = ' '
* MSG_VAR4 = ' '
IMPORTING
msg_text = lv_text
EXCEPTIONS
function_not_completed = 1
message_not_found = 2
OTHERS = 3.
IF sy-subrc <> 0.
MESSAGE ID sy-msgid TYPE sy-msgty NUMBER sy-msgno
WITH sy-msgv1 sy-msgv2 sy-msgv3 sy-msgv4.
ENDIF.
ls_idoc_status-statxt = lv_text.
APPEND ls_idoc_status TO lt_idoc_status.
CALL FUNCTION 'EDI_DOCUMENT_OPEN_FOR_PROCESS'
EXPORTING
* DB_READ_OPTION = DB_READ
document_number = pi_docnum
* ENQUEUE_OPTION = SYNCHRONOUS
* IMPORTING
* IDOC_CONTROL =
EXCEPTIONS
document_foreign_lock = 1
document_not_exist = 2
document_number_invalid = 3
document_is_already_open = 4
OTHERS = 5
.
IF sy-subrc <> 0.
MESSAGE ID sy-msgid TYPE sy-msgty NUMBER sy-msgno
WITH sy-msgv1 sy-msgv2 sy-msgv3 sy-msgv4.
ENDIF.
CALL FUNCTION 'EDI_DOCUMENT_STATUS_SET'
EXPORTING
document_number = pi_docnum
idoc_status = ls_idoc_status
IMPORTING
idoc_control = idoc_control
EXCEPTIONS
document_number_invalid = 1
other_fields_invalid = 2
status_invalid = 3
OTHERS = 4.
IF sy-subrc <> 0.
MESSAGE ID sy-msgid TYPE sy-msgty NUMBER sy-msgno
WITH sy-msgv1 sy-msgv2 sy-msgv3 sy-msgv4.
ENDIF.
CALL FUNCTION 'EDI_DOCUMENT_CLOSE_PROCESS'
EXPORTING
document_number = pi_docnum
* BACKGROUND = NO_BACKGROUND
* NO_DEQUEUE = ' '
IMPORTING
idoc_control = idoc_control
EXCEPTIONS
document_not_open = 1
failure_in_db_write = 2
parameter_error = 3
status_set_missing = 4
OTHERS = 5.
IF sy-subrc <> 0.
MESSAGE ID sy-msgid TYPE sy-msgty NUMBER sy-msgno
WITH sy-msgv1 sy-msgv2 sy-msgv3 sy-msgv4.
ENDIF.
ENDFUNCTION.
- Here is a list of transactions that could help you during the setup of your connection:
- sm59 : maintenance of "RFC destination"
- we21 : maintenance of "Ports in IDoc processing"
- we20 : maintenance of "Partner profiles"
- we02 : "IDoc List"
- we19 : "Test tool for IDoc processing"
- sm58 : "Transactional RFC". Use this to look for TID = Gateway In message key
- smgw : "Gateway Monitor"
- sm21 : "System Log"
- we63 : "Documentation" usefull to get IDoc parser or XSD to use in Babelway wizard
- su01 : "User Maintenance"
- se37 : "IDoc conversion to xml"
Babelway configuration
Simply create a channel with the SAP gateway and XML IDoc message definition.
The specific parameters are :
SAP client to use. This is the three digit number you use in the first field of the login screen of SAP Gui. It has the name 'Client' and is just above the user and password fields. For instance: 001, 210, 400 ... |
|
The Valid SAP user ID you want to use. Ideally this should be a user specially created for this purpose. For instance: user |
|
Password associated with the user ID. For instance: password |
|
IP or DNS name for SAP application server. For instance: sap.yourcompany.com if using a sap router, use the sap router syntax details here: /H/SAP_ROUTER/S/3300/H/SAP_SERVER/S/3300 if you are using a NAT: put the public address in sm59 |
|
This is the name of the RFC Destination to use. This RFC destination must use TCP/IP connection. See help for more details. For instance: BABELWAY |
|
SAP system number is the last 2 digits of the SAP client. For instance: 01, 10, 00. Default is the last 2 digits of SAP client parameter |
|
IP or DNS name for SAP gateway. It could be the same as jco.client.ashost if no external gateway is used. the For instance: gateway.yourcompany.com. Default is the same as SAP server address parameter. |
|
This is the port number to reach the TCP RFC server. For instance use 3301 to reach system 01 or 3310 to reach system 10. Default is 3300 + the last 2 digits of SAP client parameter. |
|
Should the system call the RFC function to explicitly update the status in SAP. Default is true and it required a RFC to be configured in SAP. Default is false. |
|
The name of the RFC updating the status. For instance: ZZBABELWAY_IDOC_STATUS_UPD |
|
Specify if unicode should be used. Use 0 for false and 1 for true. For instance: 0 |
Note:
- If there is a file name provided in the "Message In" or "Message Out" which contain ~ tilde character, All browser based on Chromium will replace the ~ tilde character by the _ underscore character when you try to download the file from the Babelway interface, For more details you can check this link https://bugs.chromium.org/p/chromium/issues/detail?id=479419
- The maximum file size accepted by this gateway is 100 MB.
Dropbox Gateway In
The Dropbox gateway in allows to retrieve your messages from a Dropbox account.
The specific settings are:
The name of the Dropbox account from which the messages are polled. This information is "read only", and set by the wizard when you allow Babelway to access the Dropbox account. |
|
The folder in your Dropbox account from which the messages are transferred to Babelway. This folder is located under the path /Apps/Babelway/ . |
|
If not empty, only the files whose name matches this pattern will be transferred to Babelway. Otherwise, all files are automatically transferred to Babelway |
|
Suffix that will be appended to the file name when a file is being transferred. This mechanism is used to prevent that a file is transferred twice. |
|
What will happen to your file after we have read it. This behaviour is important so that your file is not read again at next poll. The possible values are :
|
|
Suffix that will be appended to the file name when a file has been completely transferred. The use of this mechanism allows you to keep the file after the transfer, with this suffix appended to its name. If left empty, the file will be deleted after the transfer. |
|
Directory where transferred files will be moved. |
|
By default, the gateway will regularly poll the messages from your Dropbox account, so that they come into Babelway a short time (less than 10 minutes) after they have been placed in your Dropbox account. You can write here a cron expression to customise the polling schedule and the time zone for the polling. For easy creation of your cron expression, you can use the online cron maker tool available at : http://www.cronmaker.com/. |
Note:
- If there is a file name provided in the "Message In" or "Message Out" which contain ~ tilde character, All browser based on Chromium will replace the ~ tilde character by the _ underscore character when you try to download the file from the Babelway interface, For more details you can check this link https://bugs.chromium.org/p/chromium/issues/detail?id=479419
- You can check bunch of info like last success date, last message date …etc. by pressing on Run Info button.
- The maximum file size accepted by this gateway is 250 MB.
Tradeshift Gateway In
This gateway allows to retrieve files directly from an account on Tradeshift. The document retrieved will be marked as 'processed-by-babelway' in Tradeshift. The message will contain 2 metadata, 'document.metadata' containing the document metadatas and 'connection.properties' containing the connection properties, both as a single line JSON string.
URL Prefix to call Tradeshift API. Default is https://api.tradeshift.com/tradeshift/rest/ |
|
Choose 'Document' for regular fetching of document. Choose 'Workflow' to poll workflow document. |
|
The Tradeshift tenantId to use. Use Babelway application in Tradeshift to retrieve this value. |
|
The Tradeshift token to use. Use Babelway application in Tradeshift to retrieve this value. |
|
The Tradeshift token secret to use. Use Babelway application in Tradeshift to retrieve this value. |
|
The Tradeshift consumer key to use to authenticate the Babelway application. This should be left empty in most of the case. |
|
The Tradeshift consumer secret to use to authenticate the Babelway application. This should be left empty in most of the case. |
|
Specify where the document should be retrieved from. Values are 'inbox', 'outbox', 'sales', 'purchases', 'inbox,outbox', 'inbox,outboxsales,purchases', 'draft', 'sent'. Default is 'inbox'. |
|
type of document to retrieve. Values are 'invoice', 'creditnote', 'order', 'despatchadvice', 'invoice,creditnote', 'invoice,creditnote,order,despatchadvice'. Default is 'invoice'. |
|
Parameter list added to the initial 'list documents' api call. |
|
Process the documents in reverse order of retrieval. This option is useful if you query documents with the property 'ascending' set to false, which results in document being polled in the reverse order timewise, to process them in the correct order |
|
Parameters used to build the document query. It is highly recommended to at least set the properties 'withouttag', 'limit', 'type' and 'stag'. |
|
Should document metadata be fetched? |
|
Should network connection properties be fetched? |
|
Poll processed documents by appending '/processed' to the GET document call |
|
Set these tags to the document. It is important to at least set the 'withouttag' to avoid multiple processing of same message |
|
Set these tags to the document. It is important to at least set the 'withouttag' to avoid multiple processing of same message |
|
Set these properties to the document |
|
List of tags you want to remove from the document |
|
List of properties you want to remove from the document |
|
Update document in Tradeshift |
No tags will be added if this box is checked. For example : When the state of the message in babelway is "Delivered", babelway adds tag "processed-by-babelway" and the property "babelway-gatewayOutMeassageKey"(if any). When the state of the message in babelway is "Success", babelway adds the tag "sent-by-babelway" and the properties "sent-by-babelway","babelway-sentTimestamp". When the state of the message in babelway is "Error" or "Error_Closed" babelway add the properties "babelway-errorDescription" and "babelway-getwayOutMessageKey". |
Fetch collaboration messages for every document. Collaboration datas will be saved in message metadatas |
|
Which type of collaborations to fetch |
|
Include attachment into fetched data? |
|
Number of seconds between 2 checks. The default value is 3600 seconds (1 hour) and it can be lowered; the minimum accepted value is 90 seconds. This is the simplest way to define a time event. For more complex need, use the Cron Expression property instead. |
|
By default, the gateway will regularly poll the messages from your Tradeshift account, so that they come into Babelway less than one hour after they have been placed in your Tradeshift account. You can write here a cron expression to customise the polling schedule and the time zone for the polling. For easy creation of your cron expression, you can use the online cron maker tool available at : http://www.cronmaker.com/. |
This Gateway In allow you connect to Tradeshift server to receive specific document base on the configuration of this Gateway In.
By using the Tradeshift API in the configuration in the Gateway In we can control to receive:
-A specific document type (The corresponding parameter is "type").
-Receive document in ascending or descending order (The corresponding parameters is "ascending").
-Receive document issued between a specific period of time (The corresponding parameters are "minissuedate" and "maxissuedate").
-Control the limit of the received document in one call (The corresponding parameter is "limit").
The below link from Tradeshift describes all of the Tradeshift API calls to be used in this Gateway In.
https://api.tradeshift.com/tradeshift/rest/external/doc
- A check box is set "Do not add tags" so no tags are added at all if checked.
Note:
-
When the Tradeshift "Gateway In" is used in the channel and the message is in status "in delivery" (DELIVERED) in the Babelway system then for this tradeshift document the "processed-by-babelway" tag will be added and the "babelway-gatewayOutMessageKey" property will be added with the value of "This text will be replaced by the value of the message key if exists in the Tradeshift server" which is from the "Gateway out message key" which can be found from the Babelway "Message details" page and when the used "Gateway Out" of this channel don't generate a gateway out message key then the "babelway-gatewayOutMessageKey" property will be empty.
-
When the Tradeshift "Gateway In" is used in the channel and the message is in status "Success" (SUCCESS) in the Babelway system then for this tradeshift document the "sent-by-babelway" tag will be added and the "babelway-sentDate" property will be added with the end date of the message in yyyyMMdd format and the "babelway-sentTimestamp" property will be added with the end date of the message as timestamp.
-
When the Tradeshift "Gateway In" is used in the channel and the message is in status "Error" (ERROR) or "Error (closed)" (ERROR_CLOSED) in the Babelway system then for this tradeshift document the "babelway-errorDescription" property will be added with the value of "This text will be replaced by the value of the error message from Babelway" and the "babelway-gatewayOutMessageKey" property will be added with the value of "This text will be replaced by the value of the message key if exists in the Tradeshift server" which is from the "Gateway out message key" which can be found from the Babelway "Message details" page and when the used "Gateway Out" of this channel don't generate a gateway out message key then the "babelway-gatewayOutMessageKey" property will be empty.
For each message retrieved from Tradeshift two metadata are created and stored in the Context in file related to each document separately, This is stored in the "contextIn.xml" file in the "UserMetadatas" tag.
The "document.metadata" metadata contains all of the information related to this document for example (DocumentId, DocumentType, documentProfileId, … etc) stored in a JSON string.
The "connection.properties" metadata contains all of the information related to this connection properties for example (OpenDated, SupplierCategory, CompanyUrl, … etc) stored in a JSON string.
Example 1
We want to only poll documents with specific connection property which is "argtag"="TestInbound".
To accomplish this we will use the two query parameters "propertykey" and "propertyvalue".
In this case the "propertykey" will be "argtag" and the "propertyvalue" will be "TestInbound".
1-Create the Tradeshift Gateway In and configure the connection parameters.
2-From the Gateway In click on "Properties".
3-In the "Tradeshift" section for the "Additional query parameters" we will create the two query parameters with the corresponding values.
Example 2
The default limit for polling is 25 documents, so in this case for example we want to change it to be 70 documents.
To accomplish this we will use the query parameters "limit" which will be set to 70.
In the "Tradeshift" section for the "Additional query parameters" we will create the query parameter "limit" and set its value to "70".
Example 3
The query parameter "tag" is set by default to be interpreted as "OR" in this case we want to change it to be interpreted as "AND" this is done by setting the query parameter "useAndOperatorForTags" to "true".
In the "Tradeshift" section for the "Additional query parameters" we will create the query parameter "useAndOperatorForTags" and set its value to "true".
Example 4
We can use query parameter at the same time, In this we want to only poll documents with specific connection property which is "argtag"="TestInbound" and with limit of 70 documents.
We will use the three query parameters "propertykey" and "propertyvalue" and "limit".
In this case the "propertykey" will be "argtag" and the "propertyvalue" will be "TestInbound" and the "limit" will be "70".
Note:
- In the "General" page for this Gateway In you can see the "Poll now" button. When clicking on this button this will poll all of the messages immediately (and will not wait for the next defined moment).
- If there is a file name provided in the "Message In" or "Message Out" which contain ~ tilde character, All browser based on Chromium will replace the ~ tilde character by the _ underscore character when you try to download the file from the Babelway interface, For more details you can check this link https://bugs.chromium.org/p/chromium/issues/detail?id=479419
- You can check bunch of info like last success date, last message date …etc. by pressing on Run Info button.
- The maximum file size accepted by this gateway is 100 MB.
This gateway allows to retrieve orders from an account on Amazon Marketplace. The gateway will only process orders created after the deployment of the gateway.
Request support@babelway.com for changing this parameter. Type of process. 'PollOrders' is the only one supported at this stage. |
|
Endpoint is the entry point for an Amazon marketplace web service. Default is https://mws.amazonservices.com |
|
Amazon marketplace web services access key ID. |
|
Amazon marketplace web services secret key ID. |
|
Amazon marketplace seller ID. |
|
Amazon marketplace ID. |
|
By default, the gateway will regularly poll the messages from your Amazon Marketplace account, so that they come into Babelway less than one hour after they have been placed in your Amazon Marketplace account. You can write here a cron expression to customise the polling schedule and the time zone for the polling. For easy creation of your cron expression, you can use the online cron maker tool available at : http://www.cronmaker.com/. |
Note: This Gateway In only receive order messages from Amazon Marketplace.
The below link has the complete list for all of the available FeedType in the Amazon MWS Feeds API section.
https://docs.developer.amazonservices.com/en_US/feeds/Feeds_FeedType.html
Below is a link for a list of Amazon Marketplace that will help you to access Amazon Marketplace Web Service (Amazon MWS) through a URL endpoint for your Amazon marketplace.
http://s3.amazonaws.com/devo.docs.developer.amazonservices.com/en_DE/dev_guide/DG_Endpoints.html
Note:
- In the "General" page for this Gateway In you can see the "Poll now" button. When clicking on this button this will poll all of the messages immediately (and will not wait for the next defined moment).
- If there is a file name provided in the "Message In" or "Message Out" which contain ~ tilde character, All browser based on Chromium will replace the ~ tilde character by the _ underscore character when you try to download the file from the Babelway interface, For more details you can check this link https://bugs.chromium.org/p/chromium/issues/detail?id=479419
- You can check bunch of info like last success date, last message date …etc. by pressing on Run Info button.
- The maximum file size accepted by this gateway is 100 MB.
The E-conomic wizard is used to create a gateway that lets you query your e-conomic online account (http://www.e-conomic.com) and retrieve invoice documents based on a specified CVR reference.
The specific settings are:
The generated Token Id by E-conomic that grants Babelway access to your E-conomic account. It can be generated via https://secure.e-conomic.com/secure/api1/requestaccess.aspx?appId=N3m3TyMMqNgwTTso7dnr7f3rGOnXlZwKEeneiL2Uwo0=&role=SuperUser. |
|
Reference to Central Business Register (CVR). Only invoice documents with this reference will be retrieved by Babelway. |
|
Cron expression. Allows to define complex time expression like every weekday night at 23:00 (0 0 23 ? * MON-FRI *) and to define the time zone for the polling. If left empty, the system will check at least once every 15 minutes. For easy creation of your cron expression, you can use the online cron maker tool available at : http://www.cronmaker.com/. For more information, please refer to the following page: http://www.quartz-scheduler.org/documentation/quartz-2.x/tutorials/tutorial-lesson-06.html |
Note:
- In the "General" page for this Gateway In you can see the "Poll now" button. When clicking on this button this will poll all of the messages immediately (and will not wait for the next defined moment).
- If there is a file name provided in the "Message In" or "Message Out" which contain ~ tilde character, All browser based on Chromium will replace the ~ tilde character by the _ underscore character when you try to download the file from the Babelway interface, For more details you can check this link https://bugs.chromium.org/p/chromium/issues/detail?id=479419
- You can check bunch of info like last success date, last message date …etc. by pressing on Run Info button.
- The maximum file size accepted by this gateway is 100 MB.
This gateway allows to retrieve files from specific trading partners on ECGrid VAN. A Trading Partner is the company from whom you are going to receive documents. You may wish to use this gateway for example to integrate with Rite Aid or Wayfair.
The VAN gateway receives the message based on the Identifier / Qualifier pair as determined in the X12 or Edifact data. They look like this:
X12: ISA*00* *00* *ZZ*SENDERID *ZZ*RECEIVERID *010101*0101*U*00401*000000001*0*T*!
EDIFACT: UNB+UNOA:1+ SENDERID:ZZ+RECEIVERID:ZZ +
For the VAN IN Gateway, your ID Is the Receiver ID. Your Trading Partner ID is the Sender ID.
If you are using an already existing ID (on another VAN), your ID must be migrated to Babelway before you can begin receiving documents. To do so you must:
1-Download and complete this letter of authorization, found here
2-Printout on your company letterhead, scan with completed information
3-Send authorization to <support@babelway.com>
along with your desired migration date
Please note that this migration will cause all traffic under this ID to be routed to the Babelway VAN Gateway In. You must be prepared to process all documents that you currently receive through your old VAN before the migration can be completed successfully.
If you would rather use a new ID and have your partners change what they are using, Babelway let’s you create a new ID on the gateway.
Your Names / Identifiers / Qualifiers on VANs. All EDI messages specifying these Id/Qual in recipient will be routed to this gateway. Identifier = The X12 or EDIFACT ID for the ISA and UNB segments. Qualifier = The X12 or EDIFACT Qualifier for the ISA and UNB segments (Maximum is 2 characters). The name should be your company/ entity name and will be used by other EDI partners to find you before sending messages. |
Note:
-
In the "General" page for this Gateway In you can see the "Poll now" button. When clicking on this button this will poll all of the messages immediately (and will not wait for the next defined moment).
-
VAN ID can't be used in two different environments. You can only share it in the same environment with more than one channel, then you will have to set routing conditions.
- If there is a file name provided in the "Message In" or "Message Out" which contain ~ tilde character, All browser based on Chromium will replace the ~ tilde character by the _ underscore character when you try to download the file from the Babelway interface, For more details you can check this link https://bugs.chromium.org/p/chromium/issues/detail?id=479419
- You can check bunch of info like last success date, last message date …etc. by pressing on Run Info button.
- The maximum file size accepted by this gateway is 100 MB.
This gateway allows to receive files from the PEPPOL network.
PEPPOL ?
The PEPPOL project was started in 2008 with the objective to enable businesses to communicate electronically with any European government institution in the procurement process. Seven years later, PEPPOL standard is gaining traction by the European governments but also within the industry (the peppol.eu site lists 99 certified PEPPOL Access Points providers).
The three main components of the PEPPOL architecture are :
-
The Access Point (AP) : responsible to send and receive documents for a PEPPOL participant
-
The Service Metadata Publisher (SMP) : registry containing the Participant AP information. It tells you which access point must be contacted to send document of certain type to a PEPPOL participant
-
The Service Metadata Locator (SML) : the PEPPOL DNS Server. It tells you in which SMP a PEPPOL participant is registered
Participant
An "PEPPOL In Gateway" must be configured for one PEPPOL Participant (the receiver). There can be only one PEPPOL Gateway IN per participant identifier in Babelway.
The identifier value is the value identifying the PEPPOL participant in a given identification scheme. Most of the time this is a national VAT or a GLN number. For easier use, you can, for each identifier, define a user-friendly name that we call a "label".
When you deploy an "PEPPOL In Gateway", the gateway is registered as an Access Point for the receiver and document types in a Babelway SMP and the Babelway SMP is referenced in the SML for this participant.
The participant SML status tells you if the participant is registered in the PEPPOL SML.
Some actions are available depending on the participant status :
-
Prepare migration : Let you start the participant migration to another SMP than Babelway. It will generate a migration key that need to be exchange with the new SMP.
-
Migrate : If the participant is registered to another SMP in the SML, this action lets you migrate him to a Babelway SMP. The migration key received from the old SMP need to be entered.
-
Register : If the participant is not registered at all in the SML, you can register it by clicking on this action.
Registered Documents
Registered documents are UBL document type that are customized and categorized by PEPPOL business flows (i.e. : An UBL v2.1 Invoice that follows business specifications of the PEPPOL BIS 4a v2.0 ). One or more document types can be choose to configure the gateway.
Message Level Response
A Message Level Response (MLR) can be sent back to the sender of the PEPPOL message. A MLR is a business acknowledgment that tells the sender if the received message follows business rules related to the document type and business flow. You can choose the "MLR strategy" in the Gateway IN configuration.
PEPPOL Directory
Participants registered in the Babelway SMP can optionnally also be published to PEPPOL Directory.
Once your gateway is deployed, you will be able to see the defined identifiers in the PEPPOL directory (http://directory.peppol.eu for Production, and http://test-directory.peppol.eu for Test environment).
Undeploying your gateway will delete the participants from the PEPPOL Directory.
Note that the process to add/delete participants to the PEPPOL Directory is asynchronous and might take some time until it actually shows up.
Here is the summary of gateway properties:
Choose between the regular PEPPOL production infrastructure, connected to the SML, or the test infrastructure, connected to the SMK. The default is Production |
|
The values identifying the PEPPOL participants. All values are mandatory. The option 'Publish to PEPPOL directory' will only be taken into account if the PEPPOL participants is registered in the SMP of Babelway. The 'label' of the PEPPOL participants will be used as the PEPPOL participant name in the PEPPOL directory (if the option is checked). |
|
List of documents accepted by this gateway and registered in the SMP. |
|
Using this option you can decide to send MLR directly after message reception. The options are :
|
|
The status of the participant in the PEPPOL SML |
|
The peppol key you received as an access point. If none is provided, the Babelway's key will be used. |
|
They key with which you wish to be registered as an SMP. If none is provided, your participants and documents will be registered on Babelway's SMP. |
Note:
- If there is a file name provided in the "Message In" or "Message Out" which contain ~ tilde character, All browser based on Chromium will replace the ~ tilde character by the _ underscore character when you try to download the file from the Babelway interface, For more details you can check this link https://bugs.chromium.org/p/chromium/issues/detail?id=479419
- The maximum file size accepted by this gateway is 100 MB.
RosettaNet Gateway In
This gateway allows to receive RosettaNet complient PIP message from an other RosettaNet Server. The resulting message is the body of the Service Content section of the MIME message. Signature and Encryption are supported.
URL of the RosettaNet server of the receiver. |
|
Return the ReceiptAcknowledgment (RNIF v2.00) synchronously to the caller. If the option is not selected, the content of a valid ReceiptAcknowledgment is placed in the metadata of the message with the name 'RosettaNetReceiptIn' to be used later by the processing. |
|
Select encryption certificate or go to certificates store. |
|
Select signature certificate or go to certificates store. |
Note:
- In the "General" page for this Gateway In you can see the "Poll now" button. When clicking on this button this will poll all of the messages immediately (and will not wait for the next defined moment).
- If there is a file name provided in the "Message In" or "Message Out" which contain ~ tilde character, All browser based on Chromium will replace the ~ tilde character by the _ underscore character when you try to download the file from the Babelway interface, For more details you can check this link https://bugs.chromium.org/p/chromium/issues/detail?id=479419
- You can check bunch of info like last success date, last message date …etc. by pressing on Run Info button.
- The maximum file size accepted by this gateway is 100 MB.
This Gateway allows to receive messages through ePrior requests.
The specific settings are:
Note:
- If there is a file name provided in the "Message In" or "Message Out" which contain ~ tilde character, All browser based on Chromium will replace the ~ tilde character by the _ underscore character when you try to download the file from the Babelway interface, For more details you can check this link https://bugs.chromium.org/p/chromium/issues/detail?id=479419
- The maximum file size accepted by this gateway is 100/250 MB.
Simpl.ePrior Gateway In
This Gateway allows to receive messages through Simpl.ePrior requests.
The specific settings are:
Note:
- If there is a file name provided in the "Message In" or "Message Out" which contain ~ tilde character, All browser based on Chromium will replace the ~ tilde character by the _ underscore character when you try to download the file from the Babelway interface, For more details you can check this link https://bugs.chromium.org/p/chromium/issues/detail?id=479419
- The maximum file size accepted by this gateway is 100/250 MB.
NemHandel Gateway In
This gateway allows you to receive messages from the Danish NemHandel network.
Select the certificate use to register your information into the NemHandel registry. |
|
Choose between the regular NemHandel production infrastructure, or the test infrastructure. The default is Production |
|
The values identifying the NemHandel participants. |
|
List of documents accepted by this gateway. |
|
Select signature certificate or go to certificates store. |
Note:
- If there is a file name provided in the "Message In" or "Message Out" which contain ~ tilde character, All browser based on Chromium will replace the ~ tilde character by the _ underscore character when you try to download the file from the Babelway interface, For more details you can check this link https://bugs.chromium.org/p/chromium/issues/detail?id=479419
- The maximum file size accepted by this gateway is 100 MB.
Chorus Pro Gateway In
This gateway allows you to get information from the Chorus Pro platform, the French administration network.
This is the Chorus Pro environment you want to use: Production or Qualification. |
|
This is the action you want to perform on the Chorus Pro platform. This includes :
|
|
This is the technical username provided by chorus pro support to access the API through Babelway. More information on how to have that username can be found below. |
|
This is the technical password provided by chorus pro support to access the API through Babelway. More information on how to have that password can be found below. |
|
Save all attached files |
This option will allow to save all attachment files as metadata when checked. |
Replace the default XML by UBL |
On normal basis the messages received from chorus pro are in XML format , when checking this option the messages format will be replaced to be in UBL format. |
Allows you to specify the frequency and the time zone of the calls to the Chorus Pro platform with a cron expression. For easy creation of your cron expression, you can use the online cron maker tool available at: http://www.cronmaker.com/. For more information, please refer to the following page: http://www.quartz-scheduler.org/documentation/quartz-2.x/tutorials/tutorial-lesson-06.html |
XML generated for the invoice_status action type :
<?xml version="1.0" encoding="UTF-8"?> <ChorusInvoiceStatuses> <ChorusInvoiceStatus> <ChorusInvoiceId>530273</ChorusInvoiceId> <InvoiceType>FACTURE</InvoiceType> <InvoiceNumber>BABELWAY-7657654</InvoiceNumber> <DepositDate>2016-12-23</DepositDate> <InvoiceDate>2016-08-22</InvoiceDate> <InvoiceStatus>MISE_A_DISPOSITION</InvoiceStatus> <AmountToPay>49.2</AmountToPay> <Devise>USD</Devise> <ReceiverId>25773702</ReceiverId> <ReceiverCode>00000000008266</ReceiverCode> <ReceiverIdentifierType>SIRET</ReceiverIdentifierType> <ReceiverName>AAA118DESTINATAIRE</ReceiverName> </ChorusInvoiceStatus> ... </ChorusInvoicesStatuses>
-
After channel deployment, the first execution of the Chorus Pro gateway will fetch all invoices that matched the configuration from the last 7 days. After this first fetch, the gateway will continuously fetch all new invoices.
There is an embedded duplicate filtering mechanism that detects based on the chorus pro invoice id if an invoice has been already fetched by babelway system to avoid retrieving multiple times the same invoice. This mechanism is linked to the gateway in, if you duplicate, or delete and recreate the gateway, all the invoices will be fetched again.
An extra one shot poll can be asked to support invoices older than 7 days but as it is based on existing gateway in, the gateway should be already deployed and running and you need to provide the start and end date, as well as the list of suppliers if needed.
Note:
- If there is a file name provided in the "Message In" or "Message Out" which contain ~ tilde character, All browser based on Chromium will replace the ~ tilde character by the _ underscore character when you try to download the file from the Babelway interface, For more details you can check this link https://bugs.chromium.org/p/chromium/issues/detail?id=479419
- You can check bunch of info like last success date, last message date …etc. by pressing on Run Info button.
- The maximum file size accepted by this gateway is 100 MB.
Oracle Fusion Gateway In
This Gateway allows to receive messages through Oracle Fusion Collaboration Message Framework (CMK).
The specific settings are:
How the inbound message is authenticated. The two methods are HTTP's Basic authentication (username/password) or WS-Security signature |
|
Login or username to access the service. |
|
Password associated with previous username. |
|
The X509 certificate used to verify the signature of the incomming Oracle Fusion requests. |
|
The value to use for the ProcessingResultCode in the ConfirmBOD message on successful message reception |
|
The endpoint for the SOAP Post protocol. |
Note:
- If there is a file name provided in the "Message In" or "Message Out" which contain ~ tilde character, All browser based on Chromium will replace the ~ tilde character by the _ underscore character when you try to download the file from the Babelway interface, For more details you can check this link https://bugs.chromium.org/p/chromium/issues/detail?id=479419
- The maximum file size accepted by this gateway is 100 MB
Database Gateway IN
The database gateway connects to a database and pulls rows out (gateway IN) of a table and converts them to an XML file.
Currently, we support Oracle connections (using JDBC - so no current limitations on DB versions) and PostgreSQL connections. We can (and are interested in) setting up additional connection types at a limited cost. Let us know if there’s any client interest.
The connection information is common for both IN and OUT gateways:
- host,
- username,
- password,
- database name,
- service id (for oracle only),and
- SSL (check if you wish to use SSL).
You will additionally have to specify which table you wish to fetch content from, the columns you wish to retrieve (optionally) and what to do with the rows you’ve fetched:
- delete - will rely on table’s primary key to delete the exact row which was fetched.
- update - will fetch only rows where the ‘status column’ has the value that indicates row is in ‘todo’ and will update it to the ‘done’ value once the row has been fetched.
Both gateways build and understand a very basic XML format that looks like this:
<Message>
<table1>
<col1>my first value</col1>
<col2>my second column value</col2>
</table1>
</Message>
As an example, if I were to send this in a database gateway out it would try to execute:
INSERT INTO table1 (col1, col2) VALUES ('my first value','my second column value')
You can check bunch of info like last success date, last message date …etc. by pressing on Run Info button.
There’s nothing else to it... Please contact us if you need any additional information on this.
Email Gateway Out
With an Email Gateway Out, outgoing messages are attached to an email and sent to a specific email address.
The specific settings are:
Email address to which messages will be sent (destination). You can add a comma separated list of recipients or a metadata. The field allows 500 characters to support a list of email addresses but each individual email address is caped to 100 characters. |
|
Email destination CC address.You can add a comma separated list of recipients or a metadata. |
|
Email destination Bcc address.You can add a comma separated list of recipients or a metadata. |
|
Email address from which messages will appear to be sent. Replies will be sent to that address. |
|
If checked, the email message is signed using the transfer certificate. The sending email address should be hub-XXXXX@babelway.net where XXXXX is your account environment id. |
|
If checked, a web beacon (an image containing a unique link) will be in the footer of the email. When the image is loaded for the first time, it will report it as an acknowledgement of the reception of the message. The message is successful when it has been delivered to all recipients, and opened by at least one. |
|
Email message subject. |
|
[text/plain , text/html] default is text/plain |
|
Email message Body. HTML codes See http://www.htmlescape.net/htmlescape_tool.html for an online tool. |
|
Should the message be sent as attachment or not. |
|
Attachment file name [with extension if applicable]. If empty, we will apply the default settings. |
|
Add a download link in the message body. When the link is first clicked, it will "acknowledge" the message and mark it as successful. The link expiration period is 30 days from the moment the link is sent. |
|
This is the text displayed for the download link. Default: "download message". |
|
Allows you to attach other files to the email. Name = filename of the attachment. Value = Pattern to match metadata containing the file to attach. If one pattern matches multiple files, it is possible to attach them all if you guarantee to generate a different filename name for each. This can be achieved by using the capturing groups of the regex in the filename. Ex: if your metadata pattern is attachment-(.*) and your filename is \1, processing with two metadata attachment-file1.csv and attachment-file2.csv will result in files file1.csv and file2.csv. |
Note:
- In Babelway, we're using the standard Java version of REGEX, and it's the same used all over the system.
- If there is a file name provided in the "Message In" or "Message Out" which contain ~ tilde character, All browser based on Chromium will replace the ~ tilde character by the _ underscore character when you try to download the file from the Babelway interface, For more details you can check this link https://bugs.chromium.org/p/chromium/issues/detail?id=479419
- The maximum file size accepted by this gateway is 100 MB.
FTP Client Gateway Out
With a Ftp Client Out Gateway, outgoing messages are transferred to an external Ftp server. You may wish to use this gateway for example to integrate with Wayfair.
The following fields should be defined in order to configure access to your external ftp server:
External ftp server address where Babelway should send messages eg ftp.example.com. |
|
Login or username to access files on this external ftp server. |
|
Password associated with the username. |
|
Indicates that the ftp connection is in passive. Ticking it means the ftp client will establish 2 connections to the ftp server. |
|
Allows you to determine what to do if call to remote server fails. If 'No retry' is chosen, the message will be put immediately in error. Other values allow to make some retries before setting the message in error.
|
|
Directory where outgoing files will be stored on the server. |
|
Filename of the outgoing message [with extension if applicable]. If empty, we will apply the default settings. |
|
Prefix and suffix that will be prepended and appended to the file name when a file is being transferred. This mechanism is used to prevent that a file is read before it is complete. However some systems do not allow to remotely rename files or directly process and delete the file triggering an ERROR in Babelway. |
|
Select FTP, FTPS (Explicit mode) or FTPS (Implicit mode) protocol. |
|
The private key associated with the username to access your account. This can be left empty if you choose to only use the password authentication mechanism. |
Note:
- If there is a file name provided in the "Message In" or "Message Out" which contain ~ tilde character, All browser based on Chromium will replace the ~ tilde character by the _ underscore character when you try to download the file from the Babelway interface, For more details you can check this link https://bugs.chromium.org/p/chromium/issues/detail?id=479419
- The maximum file size accepted by this gateway is 100/250 MB.
FTP Server Gateway Out
With a Ftp Server Out Gateway, outgoing messages are available from a Babelway FTP server, where they can be fetched.
The specific settings are:
Babelway ftp server is the hostname for the ftp server where the files will be made available to download. |
|
Login or username to access your account on Babelway ftp server. This username must be unique as it is linked to a specific directory on the ftp server. |
|
Password associated with the username to access your account. |
|
The directory on the ftp server into which the outgoing files will be written. |
|
Filename of the outgoing message [with extension if applicable]. If empty, we will apply the default settings. |
|
During how much time the file will be kept available on the FTP server. After this timeout, the file will be automatically removed from the FTP server (it you did not do it before). If the file was never downloaded, the file will also be marked in ERROR, because it has not reached its destination. To be warned the soonest possible of errors, we recommend that you set here the lowest possible value. Example : if an automatic process polls the files from here every hour, a value of "3 hours" will allow you to be notified of the problem after just 2 or 3 failed/missing pollings, while a value of "30 days" would lead to files leaving there, without any automatic notification, until some user worries about lack of files. |
After channel deployment, your ftp server will be available to receive messages. You can access this ftp server using any ftp client software set up with the previous account settings.
Note:
- The ports used for the FTP connections in Babelway are: (FTP, FTPs explicit : 20020-21020, FTPs implicit : 22021-23020).
- If there is a file name provided in the "Message In" or "Message Out" which contain ~ tilde character, All browser based on Chromium will replace the ~ tilde character by the _ underscore character when you try to download the file from the Babelway interface, For more details you can check this link https://bugs.chromium.org/p/chromium/issues/detail?id=479419
- The maximum file size accepted by this gateway is 100/250 MB.
With a Sftp Server Out Gateway, outgoing messages are available from a Babelway FTP server, where they can be fetched.
The specific settings are:
Babelway sftp server is the hostname for the sftp server where the files will be made available to download. |
|
Login or username to access your account on Babelway ftp server. This username must be unique as it is linked to a specific directory on the ftp server. |
|
Password associated with the username to access your account. |
|
The public key associated with the username. This can be left empty if you choose to only use the password authentication mechanism. The supported formats are RSA public key (OpenSSH, Putty or DER format). More information about generating such a key can be found at the end of this page. |
|
The directory on the ftp server into which the ougoint files will be written. |
|
Filename of the outgoing message [with extension if applicable]. If empty, we will apply the default settings. |
|
During how much time the file will be kept available on the FTP server. After this timeout, the file will be automatically removed from the FTP server (it you did not do it before). If the file was never downloaded, the file will also be marked in ERROR, because it has not reached its destination. To be warned the soonest possible of errors, we recommend that you set here the lowest possible value. Example : if an automatic process polls the files from here every hour, a value of "3 hours" will allow you to be notified of the problem after just 2 or 3 failed/missing pollings, while a value of "30 days" would lead to files leaving there, without any automatic notification, until some user worries about lack of files. |
After channel deployment, your sftp server will be available to receive messages. You can access this sftp server using any sftp client software set up with the previous account parameters.
Note:
- If there is a file name provided in the "Message In" or "Message Out" which contain ~ tilde character, All browser based on Chromium will replace the ~ tilde character by the _ underscore character when you try to download the file from the Babelway interface, For more details you can check this link https://bugs.chromium.org/p/chromium/issues/detail?id=479419
- The maximum file size accepted by this gateway is 100/250 MB.
With a SFTP Client Out Gateway, outgoing messages are transferred to an external SFTP server.
The specific settings are:
External sftp server address where Babelway will send messages. |
|
Login or username to access files on this external sftp server. |
|
Password associated with the username to access account. |
|
The private key associated with the previous username to access your account. This can be left empty if you choose to only use the password authentication mechanism. The supported formats are RSA private key (OpenSSH format). |
|
Allows you to determine what to do if call to remote server fails. If 'No retry' is chosen, the message will be put immediately in error. Other values allow to make some retries before setting the message in error.
|
|
Directory where outgoing files will be stored on the server. |
|
Filename of the outgoing message [with extension if applicable]. If empty, we will apply the default settings. |
|
Prefix and suffix that will be prepended and appended to the file name when a file is being transferred. This mechanism is used to prevent that a file is read before it is complete. However some systems do not allow to remotely rename files or directly process and delete the file triggering an ERROR in Babelway. |
Babelway provides a unique private key per environment named Transfer that can be used in "private Key" and then share the "public key" one with the partner, For the SFTP Client Gateway Out when using the public and private key authentication mechanism.
Below in the steps that you will follow to be able to use this certificate.
1-You do need to set the private key on Babelway and share the public one with your partner, From the GATEWAY OUT (SFTP_CLIENT) select a key from the side menu of the Private Key.
2-The public key to provide to your partner can be downloaded from Channels - Certificates - Your certificates
3-By downloading the SSH version and sending it to your partner to add it into his SFTP server implemenation.
Note:
- Babelway By default connect to the remote SFTP server on port 22 but if you want to connect to this remote SFTP server using different port then use the below.
- In the Server field add the port number you want to use it, For example if use X.X.X.X:1722 in the Server field which means connect to the remote SFTP server X.X.X.X on port 1722.
- If there is a file name provided in the "Message In" or "Message Out" which contain ~ tilde character, All browser based on Chromium will replace the ~ tilde character by the _ underscore character when you try to download the file from the Babelway interface, For more details you can check this link https://bugs.chromium.org/p/chromium/issues/detail?id=479419
- The maximum file size accepted by this gateway is 100/250 MB.
With an OFTP Client out Gateway, outgoing messages are transferred to an external OFTP server.
The specific settings are:
The OFTP ID provided by your partner. |
|
The SFID provided by your partner. If none has been provided, this is probably the same as the SSID. |
|
The password of your partner. Provided by your partner. |
|
Babelway is providing an official Odette SSID : O01770000000000X0B5SHARED. Please call support if you want to use a different one. |
|
An SFID is automatically assigned to your Environment : O01770000000000X0B5xxxxx where xxxxx is the ID of your Babelway environment. Please call support if you want to use a different one. |
|
The value of the password is 'BABELWAY'. |
|
Filename of the outgoing message [with extension if applicable]. If empty, we will apply the default settings. |
|
File containing instructions and certificates for the installation. You should download it and send it to your OFTP partner. |
|
The URL of the server of your partner. It is provided by your partner. |
|
The port to connect to. It is provided by your partner. |
|
Use TLS (SSL) for communication |
|
Use this certificate to perform client side TLS (SSL) authentication. |
|
Select this if your partner is not sending the mandatory EERP. The message will be set in SUCCESS directly after upload. |
|
Compresses the messages. |
|
Use OFTP2 'Secure Authentication'. This will use the certificates defined for encryption and signature. |
|
Sign outgoing messages using the key selected in "Signature certificate". This allows your partner to verify that you are the one sending the message. This option is only available with OFTP 2.0. |
|
Select signature certificate or go to certificates store. This option is only available with OFTP 2.0. |
|
Encrypt outgoing messages using the certificate selected in "Encryption certificate". This allows your partner to be the only one able to decrypt the messages sent. This option is only available with OFTP 2.0. |
|
Select encryption certificate or go to certificates store. |
|
Select encryption algorithm or go to certificates store. |
|
This allows you to verify that your partner is the one sending the message using the certificate selected in "Signature verification certificate". This option is only available with OFTP 2.0. |
|
Select certificate for data or go to certificates store. |
|
Requests that incoming acknowledgments are signed. The signature will be verified using the Certificate selected in "EERP verification certificate". This allows you to be sure that only the partner could have signed the incoming messages. This option is only available with OFTP 2.0. |
|
Select certificate for EERP or go to certificates store. |
|
Advanced. Once the connection is open, the OFTP gateway will act as both sender and receiver by default. You can control this by setting the following values : BOTH / RECEIVER_ONLY / SENDER_ONLY |
|
Advanced. Babelway is supporting both OFTP1 and OFTP2. When a connection is open, Babelway is using the OFTP built-in mechanism to negotiate the protocol version. The protocol will be the highest possible. Valid values are : OFTP_V12 for version 1.2 / OFTP_V13 for version 1.3 / OFTP_V14 for version 1.4 / OFTP_V20 for version 2.0 |
|
Advanced. Babelway is supporting all types of records. Valid values are : FIXED / TEXTFILE / UNSTRUCTURED / VARIABLE. Default is UNSTRUCTURED |
|
Advanced. You can specify the record size (only used for FIXED and VARIABLE) |
|
Advanced. Control the OFTP "creditCount" parameter. This is the number of data command ( = CREDIT) that could be exchanged prior to an OFTP confirmation from the partner. Default is 64 |
|
Advanced. Control the OFTP "dataExchangeBufferSize" parameter. This is the size of the OFTP data buffer. It should be smaller than the maxBDataLen for ISDN connection. The minimum is 128 bytes and the maximum is 4096 for ISDN and 65535 for TCP connections. Default is 1024 |
|
Allows you to determine what to do if call to remote server fails. If 'No retry' is chosen, the message will be put immediately in error. Other values allow to make some retries before setting the message in error.
|
After channel deployment, your Oftp server will be available to send messages. You can access this oftp server using any Oftp client software set up with the previous account settings.
After channel deployment, your Oftp server will be available to send messages. You can access this oftp server using any Oftp client software set up with the previous account settings.
If you require a custom SSID / SFID / PASSWORD, please send a request to support@babelway.com .
When a message is transferred to the Oftp server, it is processed immediately then the original file is removed from the server.
Note: When sending the message through this "Gateway Out" and the message fell in error "Unable to establish TLS connection to remote OFTP server for SSID XXXXXXXXXXX due to : General SSLEngine problem", This error means that there is a problem occurred while building SSL connection with the remote server, In order to fix this issue we will need to trust the self-signed SSL certificate used in the remote server by following the below steps.
1-From the "certificates" page in the "Trusted certificates" tab click on the "Trust new certificate" button.
Provide the sever IP and Port or URL and Port in the "Trusted Url" field then click on the "Trust root certificate", as shown below.
After that done forget to deploy the environment in order to push this changes to production, Then the messages should be processed successfully.
Note:
- If there is a file name provided in the "Message In" or "Message Out" which contain ~ tilde character, All browser based on Chromium will replace the ~ tilde character by the _ underscore character when you try to download the file from the Babelway interface, For more details you can check this link https://bugs.chromium.org/p/chromium/issues/detail?id=479419
- The maximum file size accepted by this gateway is 100/250 MB.
With an OFtp server Gateway out, outgoing messages are available from a Babelway OFTP server.
The specific settings are:
The OFTP ID provided by your partner. |
|
The SFID provided by your partner. If none has been provided, this is probably the same as the SSID. |
|
The password of your partner. Provided by your partner. |
|
Babelway is providing an official Odette SSID : O01770000000000X0B5SHARED. Please call support if you want to use a different one. |
|
An SFID is automatically assigned to your Environment : O01770000000000X0B5xxxxxx where xxxxx is the ID of your Babelway environment.. Please call support if you want to use a different one. |
|
The value of the password is 'BABELWAY'. |
|
Filename of the outgoing message [with extension if applicable]. If empty, we will apply the default settings. |
|
File containing instructions and certificates for the installation. You should download it and send it to your OFTP partner. |
|
Select this if your partner is not sending the mandatory EERP. The message will be set in SUCCESS directly after upload. |
|
Compresses the messages. |
|
Use OFTP2 'Secure Authentication'. This will use the certificates defined for encryption and signature. |
|
Sign outgoing messages using the key selected in "Signature certificate". This allows your partner to verify that you are the one sending the message. This option is only available with OFTP 2.0. |
|
Select signature certificate or go to certificates store. This option is only available with OFTP 2.0. |
|
Encrypt outgoing messages using the certificate selected in "Encryption certificate". This allows your partner to be the only one able to decrypt the messages sent. This option is only available with OFTP 2.0. |
|
Select encryption certificate or go to certificates store. |
|
Select encryption algorithm or go to certificates store. |
|
This allows you to verify that your partner is the one sending the message using the certificate selected in "Signature verification certificate". This option is only available with OFTP 2.0. |
|
Select certificate for data or go to certificates store. |
|
Requests that incoming acknowledgments are signed. The signature will be verified using the Certificate selected in "EERP verification certificate". This allows you to be sure that only the partner could have signed the incoming messages. This option is only available with OFTP 2.0. |
|
Select certificate for EERP or go to certificates store. |
|
Advanced. Once the connection is open, the OFTP gateway will act as both sender and receiver by default. You can control this by setting the following values : BOTH / RECEIVER_ONLY / SENDER_ONLY |
|
Advanced. Babelway is supporting both OFTP1 and OFTP2. When a connection is open, Babelway is using the OFTP built-in mechanism to negotiate the protocol version. The protocol will be the highest possible. Valid values are : OFTP_V12 for version 1.2 / OFTP_V13 for version 1.3 / OFTP_V14 for version 1.4 / OFTP_V20 for version 2.0 |
|
Advanced. Babelway is supporting all types of records. Valid values are : FIXED / TEXTFILE / UNSTRUCTURED / VARIABLE. Default is UNSTRUCTURED |
|
Advanced. You can specify the record size (only used for FIXED and VARIABLE) |
|
Advanced. Control the OFTP "creditCount" parameter. This is the number of data command ( = CREDIT) that could be exchanged prior to an OFTP confirmation from the partner. Default is 64 |
|
Advanced. Control the OFTP "dataExchangeBufferSize" parameter. This is the size of the OFTP data buffer. It should be smaller than the maxBDataLen for ISDN connection. The minimum is 128 bytes and the maximum is 4096 for ISDN and 65535 for TCP connections. Default is 1024 |
|
During how much time the file will be kept available on the OFTP server. After this timeout, the file will be automatically removed from the OFTP server (it you did not do it before). If the file was never downloaded, the file will also be marked in ERROR, because it has not reached its destination. To be warned the soonest possible of errors, we recommend that you set here the lowest possible value. Example : if an automatic process polls the files from here every hour, a value of "3 hours" will allow you to be notified of the problem after just 2 or 3 failed/missing pollings, while a value of "30 days" would lead to files leaving there, without any automatic notification, until some user worries about lack of files. |
After channel deployment, your Oftp server will be available to send messages. You can access this oftp server using any Oftp client software set up with the previous account settings.
If you require a custom SSID / SFID / PASSWORD, please send a request to support@babelway.com .
When a message is transferred to the Oftp server, it is processed immediately then the original file is removed from the server.
Note:
- If there is a file name provided in the "Message In" or "Message Out" which contain ~ tilde character, All browser based on Chromium will replace the ~ tilde character by the _ underscore character when you try to download the file from the Babelway interface, For more details you can check this link https://bugs.chromium.org/p/chromium/issues/detail?id=479419
- The maximum file size accepted by this gateway is 100/250 MB.
With an AS2 Gateway, outgoing messages are transmitted using an AS2 connection. Common trading partners using AS2 include Walmart, Amazon and Wayfair.
AS2 (Applicability Statement 2) is a specification about how to transport data securely and reliably over the Internet. Security is achieved by using digital certificates and encryption.
The following fields should be defined in order to configure your AS2 access:
Babelway source server. |
|
AS2 ID of the server that receives outgoing messages. Provided by your partner. |
|
MIME/TYPE used to transfer the AS2 message to your partner. Possible values are : "edi", for the content type "application/EDIFACT". "x12", for the content type "application/EDI-X12". "eco", for the content type "application/edi-consent". "xml", for the content type "application/XML". "bin", for the content type "application/ octet-stream". DEFAULT is "bin". |
|
Name of the file sent by AS2. This is an extension to the base AS2 specification and might not be supported by all partners. By default no file name is sent. |
|
The endpoint URL of the receiving gateway ,requires protocol prefix in URL (http:// or https://). |
|
File containing instructions and certificates for the installation. You should download it and send it to your AS2 partner. |
|
Should the message be compressed or not? |
|
Should the message be encrypted or not? |
|
Certificate used for message encryption. Provided by your partner. |
|
Select algorithm used for encrypting message, if any. |
|
Should the message be signed or not? |
|
Local certificate to use for signing AS2 messages. The certificates are kept in the environment certificates store. |
|
Select algorithm used for signing the AS2 message. DEFAULT is SHA-1. |
|
Should a receipt be sent when a request is received or not. |
|
Should the receipt be sent asynchronously or not. |
|
Should the receipt be signed or not. |
|
Select Message Integrity Code algorithm used to compute the MDN of the message. DEFAULT is SHA-1. |
|
Should message signature be enforced or not. This parameter only applies if no AS2 IN gateway is configured for this partner (same AS2 FROM and AS2 TO). |
|
Certificate used for message verification. Provided by your partner. This parameter only applies if no AS2 IN gateway is configured for this partner (same AS2 FROM and AS2 TO). |
|
Maximum number of retries if message sending failed. Default is 8 times. |
|
Interval of time before trying to send message again (in seconds). Default is 1800 (30 minutes). |
Note: Babelway use Hermes 2 which is Drummond Group certified AS2 software, For more details you can check the below link.
http://hermes.cecid.org/en/latest/
To report AS2 parameters to the other party, dowload the AS2 documentation ZIP file. This file can be sent to the other party to give them all parameters they will require to establish a communication with your channel.
Walmart requires their suppliers to use AS2 to connect with them: learn more.
Note:
- The Listening ports for the AS2 Gateway are:
-
When using the HTTPS protocol the Listening port is 443.
-
When using the HTTP protocol the Listening port is 80.
- If there is a file name provided in the "Message In" or "Message Out" which contain ~ tilde character, All browser based on Chromium will replace the ~ tilde character by the _ underscore character when you try to download the file from the Babelway interface, For more details you can check this link https://bugs.chromium.org/p/chromium/issues/detail?id=479419
- The maximum file size accepted by this gateway is 100/250 MB.
- The maximum filename supported for the AS2 "Gateway Out" is 56 characters.
With an Http Client Gateway Out, outgoing messages are sent using a HTTP(s) connection.
All the user defined metadatas defined in the messages are passed in the context of the new message.
The specific settings are:
Configuration file |
If you fill it, only this file is used for the configuration. |
Variables |
Allow you to create variables with the response of the call. |
Authentication Type |
You can select from (Basic, Digest, Ntlm, Any, Cert, Form, OAuth 1a, OAuth 2.0 with Bearer, OAuth 2.0 with Credentials) depend on the server response. |
Login url |
If authentication method is (Form, OAuth 2.0 with Credentials). |
Username |
Username used for (Basic, Digest, Ntlm, Any) authentications. For Ntlm authentication, the username can be prepended by the domain (domain/username). |
Password |
Password used for (Basic, Digest, Ntlm, Any) authentications. |
Preemptive Authentication |
Allows to send authentication information with the first http request (to avoid making a second request). |
Trust Level |
The trust level defines the level of security used in the SSL handshake. Relax = No certificate verification. The default is Standard. |
Valid HTTP return code |
Comma separated list of expected return Http code. |
Certificate Alias |
Alias of an existing key certificate. |
Login URL |
If authentication method is (Form, OAuth 2.0 with Credentials). |
Http Headers |
You can add specific http header(s). |
Form Fields |
When using (Form, OAuth 2.0 with Credentials) authentication, you can add specific authentication form fields to the authentication call. |
Grant Type |
You can select (Client Credentials, Password, Other). Client Credentials (Scope, Username, Password). |
ContentType |
You can select (application/json, FORM_URLENCODED). |
OAuth1 Signature Method |
If OAuth 1a authentication is used, this allows select the signature algorithm to use. Note that if SHA1withRSA is used, a Key alias must be selected. |
OAuth1 Consumer Key |
If OAuth 1a authentication is used, this allows defining the consumer key. This is mandatory. |
OAuth1 Consumer Secret |
If OAuth 1a authentication is used, this allows defining the consumer secret. This is optional. |
OAuth1 Token |
If OAuth 1a authentication is used, this allows defining the token. This is mandatory. |
OAuth1 Token Secret |
If OAuth 1a authentication is used, this allows defining the token secret. This is optional. |
OAuth1 Key Alias |
If SHA1withRSA is used, a Key alias must be selected. |
OAuth1 Realm |
The realm value is a string, generally assigned by the origin server, which may have additional semantics specific to the authentication scheme. |
Bearer |
If OAuth 2.0 with Bearer authentication is used, this allows selecting the OAUTH bearer token to use. |
Calls |
In this section you define one or multiple API calls. |
Name |
Name of a call, used in the next step to go to another call. |
HTTP method |
You can specify the http method to call. |
URL |
URL to call to create a message. |
Use the global authentication |
When enabled the call will be done using the global authentication defined. |
Content |
Content to send, for Gateway out, if no content, we send the message. |
Timeout |
Timeout for connection in milliseconds. Must be between 10000 and 240000. |
Post Action |
In a call you can create a Post Action, to do something with the response of your request. |
Condition |
Condition of the creation of the message. |
Response FileName |
Allow you to define a FileName for the new message. |
Set Metadatas |
Allow you to create metadata in the Babelway context. |
Connected Gateways |
Connected Gateways to send the message. |
Next Step |
Name of the next call to run after this one. |
Wait |
Wait time before the execution of the post action. |
Validate |
Allow you to validate the content of the call response. |
Error Message |
The error message that will be generated in Babelway when the Validate fails. |
Retry Strategy |
Allows you to determine what to do if call to remote server fails. If 'No retry' is chosen, the message will be put immediately in error. Other values allow to make some retries before setting the message in error.
|
Maximum allowed senders |
Maximum number of threads that may send messages in parallel for this gateway (from the same Babelway server). |
Main Information
What is the benefit of using the new HTTP Client "Gateway Out" VS old deprecated HTTP Client "Gateway Out" ?
- The new HTTP Client "Gateway Out" allows to chain multiple HTTP calls.
- For each call the user can manipulate and store part(s) or all of the received response information of the current call to be used in the second call if needed based on the HTTP call specification to be implemented.
- The new HTTP Client "Gateway Out" supports scripting language.
Expression
The below print screen shows the expression which the user can select one of the (Constant, Script, Metadata) values, as shown below.
Constant : When selected the user will provide a static text that will be used as a value in this field.
Script : When selected the user will provide a script code which its result will be used in this field to achieve the user logic in this section.
Note:
- For security reasons we use a black box to run the Javascript code and it does not contain many libraries.
- The Script engine is fully compatible with ECMAScript 5.1.
Script Functions
The "HttpClientFunctions" class have the below functions defined that can be used in the Javascript code
- HttpClientFunctions.HmacMD5(String data, String key, Boolean base64Encode)
- HttpClientFunctions.HmacSHA1(String data, String key, Boolean base64Encode)
- HttpClientFunctions.HmacSHA256(String data, String key, Boolean base64Encode)
- HttpClientFunctions.HmacSHA512(String data, String key, Boolean base64Encode)
- HttpClientFunctions.base64Encode(String toEncode)
- HttpClientFunctions.base64Decode(String toDecode)
- HttpClientFunctions.rsaEncrypt(String toEncrypt, String publicKeyAlias)
- HttpClientFunctions.xmlToJson(String data)
The below example shows the use of the HmacSHA256() function from the "HttpClientFunctions" class which will generate the base64 value of the HmacSHA256 of "message" with the key "secret", as shown below.
HttpClientFunctions.HmacSHA256('message','secret',true);
Metadata : When selected the user will provide a metadata name between curly bracket like for example {MetadataName}, This can be a system metadata which is generated in the current channel only because the system metadata is not propagated from one channel to the other, or by selecting a user defined metadata which is generated from the current channel or generated from any previous channel(s) because the user defined metadata is propagated from one channel to the other.
File section
You can download and upload the configuration in XML format.
- Download the current saved configuration, After configuring HTTP Client "Gateway Out" and testing it successfully you can download the current configuration which is saved in XML format.
- Upload the configuration in XML format, This will override the current configuration of the gateway by the provided configuration in the uploaded XML file.
Note: The download button will only download the saved configuration for the gateway, So if you have done some changes to the gateway which is not saved then all of the unsaved information will not be provided in the downloaded XML file.
Global information section
Scripting language is the scrip language used when the "Script" type is selected and the suported scripting language is JavaScript.
Variables
Allow the user to create variables which can be used in a different calls in this gateway when the expression type of "Script" is selected the result of the script will be used, as shown below.
Already defined variables (system variables)
By default Babelway will create the below system variables for each call and there values can be used when selecting the expression of type "Script".
- loginResponseContent : The body of the login response, save as text.
- loginResponseContentBytes : The body of the login response save as byte.
- loginResponseHeaders : The headers of the login response saved as key-value pairs, To get the value of the login response header write loginResponseHeaders.get("header_name")
- loginResponseCode : The status code of the login response.
- responseContent : The body of the response save as text.
- responseContentBytes : The body of the response save as byte.
- messageContent : The content of the message out save as text.
- messageContentBytes : The content of the message out save as byte.
- responseHeaders : The headers of the response saved as key-value pairs, To get the value of the response header write responseHeaders.get("header_name")
- responseCode : The status code of the response.
- responseCookies: The cookies of the response saved as key-value pairs. To get the value of a cookies, write responseCookies.get('sessionId');
Note:
- The response of the call is saved in the script system variable "responseContent" which can be used in the "Post Action" section.
- The expression of type "Script" is case sensitive and you will need to make sure when using the above variables to work properly to provide them using the correct case sensitive as mentioned above.
- For each call the old system variables will be overridden with the new response of the new call, So if you want to use the old system variable in other call(s) then you can save th old system variable in a user variable in the "Post Action - Validate" section.
Global Authentication and call Authentication sections
When a global authentication is defined then it can be used in the calls where the "Use the global authentication" option is enabled, as shown below.
In case for a specific call or calls you will need to use different authentication then you can create the needed authentication type from the "Authentication" section of each call, as shown below.
In case the call will not have any authentications then just make sure to disable the authentication for this call, as shown below.
Note: When using the call authentication of type "OAuth2.0 With Credentials" then you can extract the token from the authentication response and save the token in a metadata which will be used in the "Authorization" header of the call, This can be done by using the "loginResponseContent" variable and set the expression type to "Script", as shown below.
JSON.parse(loginResponseContent).access_token
Calls section
In this section you can create one call or more than one call to connect to a server receiver or send data based on the logic you want to achieve, as shown below.
Name : This is the name of the call which is mandatory and also this name will be used in the "Post Action - Next Step" section when there are more than one call defined and each call is linked to the other call.
Content : This is for the "Gateway Out" only and if this is empty then we will use the output message from this channel.
Wait : How long the to wait before execute the call, The default is 0 second.
Timeout : Timeout for connection in milliseconds which is by default 90 seconds.
Valid HTTP return code : Comma separated list of expected return HTTP code which evaluates the response HTTP code in the header, If the return code is not in the list, the message is set in error, The default is '200,201,202,204,205'.
Post Action - Validate section
The validate section will allow us to validate the call and generate some user defined variables and user defined metadata to be used in other call(s) or channel(s).
Validate Condition : Allows you to validate the call and the call will be valid when the implemented condition result is true and when the result of condition is false the message will fail in error.
Error Message : When the result of the condition above is false the message will fail in error and the error message will be used from this field in the message details.
Variables : Allow you to create variables to be able to use in the calls in this gateway where supported.
Set metadatas : Allow you to create user defined metadata to be able to use in the calls in this gateway where supported and also will be sent the channel(s) when the "Connected Gateways" option is implemented in the "Post Action - Create Message" section.
Post Action - Create message section
In order to send the received response body from the current HTTP Client "Gateway Out" to the next channel(s), It is a must to use "Script" expression with the value of "responseContent" in the "Content" which will be created by default, as shown below.
Note: You can change the "responseContent" with any other system variables and also you can some manipulation to only extract a part of the received response or even do other manipulation to achieve your request.
Condition : Allows you to create a condition to create a message only when the result of the condition is true so only for specific calls the message will be created.
Response FileName : Allow you to define the FileName for the new message created, If this is empty then the default is "httpresponse.txt".
Set metadatas : Allow you to create user defined metadata to be sent the channel(s) when the "Connected Gateways" option is implemented.
The most important is that all of the user defined metadata created in the "Post Action - Validation" section from all of the previous calls including this call will be sent to the next channel(s) and only the user defined metadata created in this "Post Action - Creat Message" section will be sent to the next channel(s).
Connected Gateways : One or several gateways to receive the created message in this section.
User Metadata Transfer Strategy : The strategy that will be used to transfer the user metadata to the new message created in the connected gateways.
Post Action - Next Step section
In order to be able to do multiple calls you will need to provide the second call name exactly in the "Next step" as you have already defined the call name in the "Name" field to be able to execute the second call after this call complete.
If the "Next step" has a type the message will fail in error and when it is empty the execution will end and not other calls will be executed.
Wait : How long the to wait before execute the call, The default is 0 second.
Babelway Message Metadata section
Allow you to update the "User comment" and "Gateway out message key" when the gateway execution is completed.
User comment metadata : Allow you to define the "User comment" of the current message, The value will be trimmed after 4096 characters.
Gateway (In/Out) Message Key : Allow you to define the "Gateway out message key" of the current message, The value will be trimmed after 100 characters.
Retry options
Retry Strategy : Allows you to determine what to do if call to remote server fails. If 'No retry' is chosen, the message will be put immediately in error. Other values allow to make some retries before setting the message in error.
Maximum allowed senders : Maximum number of threads that may send messages in parallel for this gateway (from the same Babelway server).
If you want to benefit from maximum speed, leave this field empty. Only use if the receiver can not receive messages quickly enough.
Message details Call log
To see the complete call log for each call which will help in investigation from the monitoring message details download the "httpClientGatewayFlowOut" ZIP file from the "Files" section.
For security reasons we will not log the "Authorization" header.
Note:
- In Babelway, we're using the standard Java version of REGEX, and it's the same used all over the system.
- If there is a file name provided in the "Message In" or "Message Out" which contain ~ tilde character, All browser based on Chromium will replace the ~ tilde character by the _ underscore character when you try to download the file from the Babelway interface, For more details you can check this link https://bugs.chromium.org/p/chromium/issues/detail?id=479419
- The maximum file size accepted by this gateway is 100/250 MB.
Http Client Gateway Out (Deprecated)
With an HttpClientOut Gateway, outgoing messages are sent using a Http connection.
All the user defined metadatas defined in the messages are passed in the context of the new message.
The specific settings are:
External service address. Support HTTP and HTTPS protocols. |
|
Login or username to access the service. |
|
Password associated with the username. |
|
Select zero, one or several gateways to receive the response from the http server. |
|
Comma separated list of expected return Http code which evaluates the response HTTP code in the header. If the return code is not in the list, the message is set in error. The default is '200,201,202,204,205'. |
|
The success expression is a regex that evaluates the HTTP response body. If the response doesn't match the success expression, the message is flagged with 'error' status. |
|
You can specify a filename that will be associated with the server response. Default is 'attachment'. |
|
The strategy that will be used to transfer the user metadata to the response message created in the connected gateways. |
|
Allows you to determine what to do if call to remote server fails. If 'No retry' is chosen, the message will be put immediately in error. Other values allow to make some retries before setting the message in error.
|
|
Filename of the outgoing message [with extension if applicable]. If empty, we will apply the default settings. |
|
Timeout for connection in milliseconds. Must be between 10000 and 240000. |
|
You can specify the http method to call. 'Form Posting' is emulating a browser Form Post using mime multipart. The default is POST. |
|
You can specify the version of the TLS protocol. TLS is the replacement of SSL. The default is TLSv1.2. |
|
Name given to the parameter containing the actual message. This is also equivalent to the FORM parameter when a POST if done from a web browser. |
|
Extra parameters to inlude in the message. Name is the parameter name (FORM parameter) and the value is the name of a metadata containg the parameter content. In case of a binary content, the name of the metadata will also be used as the 'filename' of the parameter. |
|
You can add specific http header. This accepts metadata. |
|
The trust level defines the level of security used in the SSL handshake. Relax = No certificate verification, Standard = trusting certificates in environment certificates as well as known CA's, Paranoiac = only trusts certificates defined in the environmnent certificates. Mutual = requires 2-way authentication. |
|
You can select from FORM, BASIC, DIGEST, NTLM, CERT, OAUTH1, OAUTH2, ANY or OAuth 2.0 with Credentials. CERT is 2-way SSL authentication. ANY is BASIC, DIGEST or NTLM depending on the server response. |
|
Allows to send authentication information with the first http request (to avoid making a second request). Only for BASIC or DIGEST authentication. |
|
If authentication method is FORM. |
|
When using FORM authentication, you can add specific authentication form fields to the authentication call. This accepts metadata. |
|
You can use data receive by the login request as metadata, which can be used in the data sending after login. |
|
If CERT authentication is used (2-way SSL authentication), this allows to select the key pair to use from the environment certificate. |
|
If OAUTH2 authentication is used, this allows select the OAUTH bearer token to use. |
|
If OAUTH1 authentication is used, this allows select the signature algorithm to use. Note that if SHA1withRSA is used, a Key alias must be selected. |
|
If OAUTH1 authentication is used, this allows defined the consumer key. This is mandatory. |
|
If OAUTH1 authentication is used, this allows defined the consumer secret. This is optional. |
|
If OAUTH1 authentication is used, this allows defined the token. At this version of Babelway this is mandatory, please contact support if you need to retreive the token from an OAUth handsake. |
|
If OAUTH1 authentication is used, this allows defined the token secret. This is optional. |
|
If OAUTH1 authentication is used with SHA1withRSA, this allows to select the key signing the OAUTH authentication. |
After channel deployment, your connection will be available to send messages.
When using the Authentication method of type OAuth 2.0 with Credentials we will do two calls, The first call will be through the URL provided in the "Login url" field then when we receive the response we can use regex to extract the data received in the response body and save them in a user defined metadata in the "Metadata from response" section then this created user defined metadata can be used in the second call in the "HTTP headers" section, as shown below.
Note: The sent HTTP request has a default content type of "text/html" and if you need to change it based in the output message, you can add the desired Content-Type in the headers section under the properties of the HTTP Client Gateway OUT as seen below:
1- Click on the properties of the HTTP Client Gateway OUT as seen below:
2- Add the desired Content-Type in the headers section (fo example "application/json") as seen below:
Add the desired Content-Type
Note:
- In Babelway, we're using the standard Java version of REGEX, and it's the same used all over the system.
- If there is a file name provided in the "Message In" or "Message Out" which contain ~ tilde character, All browser based on Chromium will replace the ~ tilde character by the _ underscore character when you try to download the file from the Babelway interface, For more details you can check this link https://bugs.chromium.org/p/chromium/issues/detail?id=479419
- The maximum file size accepted by this gateway is 100/250 MB.
With an SoapClientOut Gateway, outgoing messages are sent using a SOAP call.
All the user defined metadatas defined in the messages are passed in the context of the new message.
The specific settings are:
External service address. |
|
Login or username to access the service. |
|
Password associated with the username. |
|
Select zero, one or several gateways to receive the response from the http server. |
|
If an error occurs during processing, the response to a SOAP message is a SOAP fault element in the body of the message, and the fault is returned to the sender of the SOAP message. Standard Soap protocol suggests that they should be sent with a 500 HTTP error code, but some systems still send it with a HTTP 200 ok return code. Choose here how you want to handle your Soap Fault messages: 1) You can treat them as normal messages and therefore, no special rules applies. If they arrive with a HTTP 500 error code, you should add 500 in the list of valid return code. Otherwise, they will end up in error, as normal messages. 2) You can always treat them as Error. Even if we receive them via a valid HTTP response code, the message will be put in error. 3) You can always treat them as Successful messages. Even if we receive them via a invalid HTTP return code, the message will be put in success and possibly transferred to a connected gateway. |
|
Comma separated list of expected return Http code. If the return code is not in the list, the message is set in error. The default is '200,201,202,204,205'. |
|
The success expression is a regex. If the response doesn't match the success expression, the message is flagged with 'error' status. |
|
You can specify a filename that will be associated with the server response. Default is 'attachment'. |
|
The strategy that will be used to transfer the user metadata to the response message created in the connected gateways. |
|
Allows you to determine what to do if call to remote server fails. If 'No retry' is chosen, the message will be put immediately in error. Other values allow to make some retries before setting the message in error.
|
|
Filename of the outgoing message [with extension if applicable]. If empty, we will apply the default settings. |
|
You can specify the http method to call. The default is POST. |
|
Timeout for connection in milliseconds. Must be between 10000 and 240000. |
|
You can add specific http header. This accepts metadata. |
|
Value of the SOAPAction http header. |
|
Allows to specify one or more soap attachments, based on SOAP with Attachments (SwA) using MIME. Name will be sent as 'ContentId' of the mime part of the attachment and Value must contain the name of the metadata containing the String or byte array body of the attachment. |
|
The trust level defines the level of security used in the SSL handshake. Relax = No certificate verification, Standard = trusting certificates in environment certificates as well as known CA's, Paranoiac = only trusts certificates defined in the environmnent certificates. Mutual = requires 2-way authentication. |
|
You can select from FORM, BASIC, DIGEST, CERT or ANY. CERT is 2-way SSL authentication. ANY is BASIC, DIGEST or NTLM depending on the server response. |
|
Allows to send authentication information with the first http request (to avoid making a second request). Only for BASIC or DIGEST authentication. |
|
If authentication method is FORM. |
|
When using FORM authentication, you can add specific authentication form fields to the authentication call. This accepts metadata. |
|
If CERT authentication is used (2-way SSL authentication), this allows to select the key pair to use from the environment certificate. |
|
You can add specific soap header. This accepts metadata. |
|
Defined the standard version of the remote SOAP service. |
|
Ws-Security profile defines the type of security required to call the SOAP service. |
|
Ws-Security username is used in the username/token digest profile. |
|
Ws-Security token is used in the username/token digest profile. |
|
Ws-Security username is used in the X.509 signing profiles. |
|
Ws-Security username is used in the X.509 encryption profiles. |
After channel deployment, your connection will be available to send messages.
Note:
- In Babelway, we're using the standard Java version of REGEX, and it's the same used all over the system.
- If there is a file name provided in the "Message In" or "Message Out" which contain ~ tilde character, All browser based on Chromium will replace the ~ tilde character by the _ underscore character when you try to download the file from the Babelway interface, For more details you can check this link https://bugs.chromium.org/p/chromium/issues/detail?id=479419
- The maximum file size accepted by this gateway is 100/250 MB.
With an Oracle Fusion Out Gateway, outgoing messages are sent to a Oracle Fusion CMK endpoint using a SOAP call.
All the user defined metadatas defined in the messages are passed in the context of the new message.
The specific settings are:
External service address. |
|
Login or username to access the service. |
|
Password associated with the username. |
|
Select zero, one or several gateways to receive the response from the http server. |
|
If an error occurs during processing, the response to a SOAP message is a SOAP fault element in the body of the message, and the fault is returned to the sender of the SOAP message. Standard Soap protocol suggests that they should be sent with a 500 HTTP error code, but some systems still send it with a HTTP 200 ok return code. Choose here how you want to handle your Soap Fault messages: 1) You can treat them as normal messages and therefore, no special rules applies. If they arrive with a HTTP 500 error code, you should add 500 in the list of valid return code. Otherwise, they will end up in error, as normal messages. 2) You can always treat them as Error. Even if we receive them via a valid HTTP response code, the message will be put in error. 3) You can always treat them as Successful messages. Even if we receive them via a invalid HTTP return code, the message will be put in success and possibly transferred to a connected gateway. |
|
Comma separated list of expected return Http code. If the return code is not in the list, the message is set in error. The default is '200,201,202,204,205'. |
|
The success expression is a regex. If the response doesn't match the success expression, the message is flagged with 'error' status. |
|
You can specify a filename that will be associated with the server response. Default is 'attachment'. |
|
The strategy that will be used to transfer the user metadata to the response message created in the connected gateways. |
|
Allows you to determine what to do if call to remote server fails. If 'No retry' is chosen, the message will be put immediately in error. Other values allow to make some retries before setting the message in error.
|
|
Filename of the outgoing message [with extension if applicable]. If empty, we will apply the default settings. |
|
You can specify the http method to call. The default is POST. |
|
Timeout for connection in milliseconds. Must be between 10000 and 240000. |
|
You can add specific http header. This accepts metadata. |
|
Value of the SOAPAction http header. |
|
Allows to specify one or more soap attachments, based on SOAP with Attachments (SwA) using MIME. Name will be sent as 'ContentId' of the mime part of the attachment and Value must contain the name of the metadata containing the String or byte array body of the attachment. |
|
The trust level defines the level of security used in the SSL handshake. Relax = No certificate verification, Standard = trusting certificates in environment certificates as well as known CA's, Paranoiac = only trusts certificates defined in the environmnent certificates. Mutual = requires 2-way authentication. |
|
You can select from FORM, BASIC, DIGEST, CERT or ANY. CERT is 2-way SSL authentication. ANY is BASIC, DIGEST or NTLM depending on the server response. |
|
Allows to send authentication information with the first http request (to avoid making a second request). Only for BASIC or DIGEST authentication. |
|
If authentication method is FORM. |
|
When using FORM authentication, you can add specific authentication form fields to the authentication call. This accepts metadata. |
|
If CERT authentication is used (2-way SSL authentication), this allows to select the key pair to use from the environment certificate. |
|
You can add specific soap header. This accepts metadata. |
|
Defined the standard version of the remote SOAP service. |
|
Ws-Security profile defines the type of security required to call the SOAP service. |
|
Ws-Security username is used in the username/token digest profile. |
|
Ws-Security token is used in the username/token digest profile. |
|
Ws-Security username is used in the X.509 signing profiles. |
|
Ws-Security username is used in the X.509 encryption profiles. |
After channel deployment, your connection will be available to send messages.
Note:
- In Babelway, we're using the standard Java version of REGEX, and it's the same used all over the system.
- If there is a file name provided in the "Message In" or "Message Out" which contain ~ tilde character, All browser based on Chromium will replace the ~ tilde character by the _ underscore character when you try to download the file from the Babelway interface, For more details you can check this link https://bugs.chromium.org/p/chromium/issues/detail?id=479419
- The maximum file size accepted by this gateway is 100 MB.
With ePrior Out Gateway, outgoing messages are made available on Babelway ePrior server.
The specific settings are:
The X509 certificate used to verify the signature of the incomming ePrior requests. |
|
The identification of the consumer from which the ePrior request comes from. |
|
The identification of the party to which the ePrior document is sent. |
|
The identification of the party from which the ePrior document is sent. |
|
The type of the ePrior document. |
|
The identification of the ePrior document. |
|
During how much time the file will be kept available on the ePrior server. After this timeout, the file will be automatically removed from the ePrior server (it you did not do it before). If the file was never downloaded, the file will also be marked in ERROR, because it has not reached its destination. To be warned the soonest possible of errors, we recommend that you set here the lowest possible value. Example : if an automatic process polls the files from here every hour, a value of "3 hours" will allow you to be notified of the problem after just 2 or 3 failed/missing pollings, while a value of "30 days" would lead to files leaving there, without any automatic notification, until some user worries about lack of files. |
Note:
- If there is a file name provided in the "Message In" or "Message Out" which contain ~ tilde character, All browser based on Chromium will replace the ~ tilde character by the _ underscore character when you try to download the file from the Babelway interface, For more details you can check this link https://bugs.chromium.org/p/chromium/issues/detail?id=479419
- The maximum file size accepted by this gateway is 100 MB.
Simpl.ePrior Gateway Out
With Simpl.ePrior Out Gateway, outgoing messages are made available on Babelway Simpl.ePrior server.
The specific settings are:
The X509 certificate used to verify the signature of the incomming Simpl.ePrior requests. |
|
The identification of the consumer from which the Simpl.ePrior request comes from. |
|
The identification of the party to which the Simpl.ePrior document is sent. |
|
The identification of the party from which the Simpl.ePrior document is sent. |
|
The type of the Simpl.ePrior document. |
|
The identification of the Simpl.ePrior document. |
|
During how much time the file will be kept available on the Simpl.ePrior server. After this timeout, the file will be automatically removed from the Simpl.ePrior server (it you did not do it before). If the file was never downloaded, the file will also be marked in ERROR, because it has not reached its destination. To be warned the soonest possible of errors, we recommend that you set here the lowest possible value. Example : if an automatic process polls the files from here every hour, a value of "3 hours" will allow you to be notified of the problem after just 2 or 3 failed/missing pollings, while a value of "30 days" would lead to files leaving there, without any automatic notification, until some user worries about lack of files. |
Note:
- If there is a file name provided in the "Message In" or "Message Out" which contain ~ tilde character, All browser based on Chromium will replace the ~ tilde character by the _ underscore character when you try to download the file from the Babelway interface, For more details you can check this link https://bugs.chromium.org/p/chromium/issues/detail?id=479419
- The maximum file size accepted by this gateway is 100 MB.
Http Gateway Out
With a HTTP out Gateway, outgoing messages are available from a Babelway HTTP server.
The specific settings are:
Login or username to access the service . |
|
Password associated with the username. |
|
using the SOAP Post protocol. WSDL Support HTTP and HTTPS protocols. |
|
How to encode the content |
|
During how much time the file will be kept available on the HTTP server. After this timeout, the file will be automatically removed from the HTTP server (it you did not do it before). If the file was never downloaded, the file will also be marked in ERROR, because it has not reached its destination. To be warned the soonest possible of errors, we recommend that you set here the lowest possible value. Example : if an automatic process polls the files from here every hour, a value of "3 hours" will allow you to be notified of the problem after just 2 or 3 failed/missing pollings, while a value of "30 days" would lead to files leaving there, without any automatic notification, until some user worries about lack of files. |
After channel deployment, your connection will be available to send messages.
Note:
- The HTTP server Gateway uses the port 80 for HTTP and 443 for HTTPS.
- You will need to download the WSDL file for this gateway by using the SOAP URL in the browser then login using the user name and password for this gateway in order to download the WSDL file for this environment as for some environments the SOAP URL and the WSDL file are different from other environments.
- If there is a file name provided in the "Message In" or "Message Out" which contain ~ tilde character, All browser based on Chromium will replace the ~ tilde character by the _ underscore character when you try to download the file from the Babelway interface, For more details you can check this link https://bugs.chromium.org/p/chromium/issues/detail?id=479419
- The maximum file size accepted by this gateway is 100 MB.
The X.400 out Gateway allows to send the message on the X.400 network to the address of your trading partner.
The account private address. This is the address to communicate to your trading partner. The formatting may vary from one partner to the other. The most common formats are: C=WW; A=400NET; P=BABELWAY; S=HUB-25333 /C=WW/A=400NET/P=BABELWAY/S=HUB-25333. |
|
You can choose to enter the full address in the "manual address field" or each address component in the corresponding field. |
|
Country = C value |
|
Partner Administration Management Domain Name = A value |
|
Partner Private Management Domain Name = P value |
|
Partner Organization = O value |
|
Partner Organizational Unit 1 |
|
Partner Given Name |
|
Partner Initial |
|
Partner Surname = S value |
|
Partner Generation Qualifier |
|
Request a X.400 delivery report |
|
Send the X.400 message as binary (using bilaterally-defined body part) |
Note:
- If there is a file name provided in the "Message In" or "Message Out" which contain ~ tilde character, All browser based on Chromium will replace the ~ tilde character by the _ underscore character when you try to download the file from the Babelway interface, For more details you can check this link https://bugs.chromium.org/p/chromium/issues/detail?id=479419
- The maximum file size accepted by this gateway is 100 MB.
Internal Gateway Out
The internal gateway in / out are used to transfer messages between 2 channels within the same Babelway environment.
All the user defined metadatas defined in the messages are passed in the context of the new message.
The specific settings are:
Select the internal gateways In that will receive the message. You can select multiple gateway in. A copy of the message will be sent to each of them. |
|
Filename of the outgoing message [with extension if applicable]. If empty, we will apply the default settings. |
|
Filename of the Response message. |
|
The strategy that will be used to transfer the user metadata to the new message created in the connected gateways. |
As opposed to most other gateways, the internal gateway is immediately available as gateway out for other channels configuration without requiring a channel deployment.
Note:
- If there is a file name provided in the "Message In" or "Message Out" which contain ~ tilde character, All browser based on Chromium will replace the ~ tilde character by the _ underscore character when you try to download the file from the Babelway interface, For more details you can check this link https://bugs.chromium.org/p/chromium/issues/detail?id=479419
- The maximum file size accepted by this gateway is 100 MB.
The null gateway can be used for test and development purposes. The outgoing message will not be sent anywhere and remain in Babelway.
Outgoing messages will not be forwarded but they are nevertheless created and readable through the Messages interface. You may use this gateway for testing your messages before going to production or for preventing a channel to send messages before deployment.
Note:
- If there is a file name provided in the "Message In" or "Message Out" which contain ~ tilde character, All browser based on Chromium will replace the ~ tilde character by the _ underscore character when you try to download the file from the Babelway interface, For more details you can check this link https://bugs.chromium.org/p/chromium/issues/detail?id=479419
- The maximum file size accepted by this gateway is 100 MB.
Splitter Gateway Out
The splitter gateway OUT enables to split a message into multiple messages. The splitter can split according to RegEx, XPath, Edifact or X12 expressions. The resulting messages are forwarded to one or more channels in the same environment.
The specific settings are:
Select the internal gateways In that will receive the split messages. You can select multiple gateway in. A copy of the message will be sent to each of them. |
|
The split type determines how the file will be analyzed (text, xml, edifact) to split it in parts. |
|
Introduces a delay (in seconds, up to maximum 300 seconds) before it sends out each message. For example, if the delay is set to 30 and the split generates 4 messages, each message will be sent 30 seconds appart with the last message dispatched 1.5 minutes after the split. |
|
The strategy that will be used to transfer the user metadata to the new message created in the connected gateways. |
|
Filename of the parent message [with extension if applicable]. If empty, we will apply the default settings. |
|
Filename of the split message. |
|
Regex expression to create a header added to each split message |
|
RegEx expression to select the content of the split message. [\n](?=EE) which means split when seeing line return and then EE |
|
Split the message every so many lines |
|
XPath to select the content of the split message. |
|
Regex expression to create a footer added to each split message |
|
Keep the parent node of the split xml. Only valid with XPath splitting. |
|
Skip the xml declaration in the split xml. Only valid with XPath splitting. |
|
Optional Xslt to perform on the split Xml. Only valid with XPath splitting. |
|
Charset to use to decode file waiting to be split. |
|
Charset to use to encode the file resulting of the splitting. |
Note:
- In Babelway, we're using the standard Java version of REGEX, and it's the same used all over the system.
- If there is a file name provided in the "Message In" or "Message Out" which contain ~ tilde character, All browser based on Chromium will replace the ~ tilde character by the _ underscore character when you try to download the file from the Babelway interface, For more details you can check this link https://bugs.chromium.org/p/chromium/issues/detail?id=479419
- The maximum file size accepted by this gateway is 100 MB.
Aggregator Gateway Out
The aggregator gateway OUT enables to aggregate messages into one single file. The aggregator can append the messages, use an xslt to merge xml documents or merge Edifact or X12 documents. The resulting message is forwarded to one or more channels in the same environment.
All the user defined metadata in the first of the aggregated messages are passed in the context of the aggregated message.
The specific settings are:
The internal gateway where to send the aggregated message. You can select multiple gateways in. A copy of the message will be sent to each of them. |
|
Select 'append' for simple append. Use header, separator and footer to control the aggregation. Select 'xml' to create an aggregation of xml document. Optionally an xslt can be applied to the result. Select 'edifact' or 'x12' to merge edi documents; the envelope of the first document will be used. Select 'zip' to wrap messages in a single zip file. Select 'tar' to wrap messages in a single tar file. |
|
Optional. Enables to generate different aggregated files grouping incoming messages based on the value of a metadata. Example: 3 messages arrive with value A, B and A in the selected metadata. The aggregator will generate 1 file with the 2 messages with value A and 1 file with 1 message with the value B. |
|
Optional. By default, Babelway will put the message in error if it exceeds the maximum size allowed by the system (check documentation on allowed file sizes). If you specify a value, when the number of MB of the generated file reaches that value, Babelway will generate a message with the current values and start again with another file until all messages are processed. |
|
Specifies how you want Babelway to differentiate files when split by the "Max file size" parameter. Either alphabetical append (alpha: filename, filename-a, filename-b, ...) or numeric append (numeric: filename, filename-1, filename-2, ...). |
|
Frequency in seconds. Default is 300 (5 minutes). |
|
Cron expression. Allows you to define complex time expressions like every weekday night at 23:00 (0 23 ? * MON-FRI) and the time zone for the polling. This takes precedence on the frequency property. For easy creation of your cron expression, you can use the online cron maker tool available at:http://www.cronmaker.com/. For more information, please refer to the following page:http://www.quartz-scheduler.org/documentation/quartz-2.x/tutorials/tutorial-lesson-06.html |
|
Filename of the message OUT of the channel that serves as input to the aggregator. If empty, we will apply the default settings. |
|
Filename of the aggregated file, by default the file name is set to 'aggregate'. Tip: You can use: {com_babelway_messaging_context_aggregator_groupBy} to include the name of the group by in the file name, or any user defined metadata defined in the first of the aggregated messages. |
|
If you specify a time (in seconds), the aggregation will wait that time after the reception of a new incoming message, even if it conflicts with its scheduled run. This allows, for example, ensuring all messages from a batch are included in a single aggregation. |
|
For 'append' type: prefix to add at the beginning of the file. For 'xslt' type: name for the root of the resulting message. Default='messages' |
|
For 'append' type: message separator. For 'xslt' type: name for the element surrounding each message. Default='message' |
|
Suffix to add at the beginning of the file. |
|
Xslt to execute on the resulting Xml. |
|
Check this to skip the UNA section in EDIFACT and Odette messages. |
|
Define a custom XPATH expression used to compute the edifact control field. If left empty, the control of the first message will be used. |
|
Charset to use to decode the file waiting to be aggregated. Default is UTF8. |
|
Charset to use to encode the file resulting of the aggregation. Default is UTF8. |
|
The strategy that will be used to transfer the user metadata to the new message created in the connected gateways. |
Note:
- If there is a file name provided in the "Message In" or "Message Out" which contain ~ tilde character, All browser based on Chromium will replace the ~ tilde character by the _ underscore character when you try to download the file from the Babelway interface, For more details you can check this link https://bugs.chromium.org/p/chromium/issues/detail?id=479419
- The maximum file size accepted by this gateway is 100 MB.
NFS Gateway Out
The NFS gateway is used to connect and push files to a remote NFS server.
Hostname of the NFS server. |
|
Name of the exported volume. |
|
NFS login method: use PCNFSD for username / password and UGID to directly use UID, GID and GIDS |
|
Username used for the NFS authentication. Only used with PCNFSD login method. |
|
Password used for the NFS authentication. Only used with PCNFSD login method. |
|
Unix user UID to use during authentication. Only used with UGID login method. |
|
Unix user's group GID to use during authentication. Only used with UGID login method. |
|
Unix user's additional groups GID to use during authentication, encoded as a comma separated list. Only used with UGID login method. |
|
Local NFS path to the folder you want to use. This is relative to the export. |
Note:
- If there is a file name provided in the "Message In" or "Message Out" which contain ~ tilde character, All browser based on Chromium will replace the ~ tilde character by the _ underscore character when you try to download the file from the Babelway interface, For more details you can check this link https://bugs.chromium.org/p/chromium/issues/detail?id=479419
- The maximum file size accepted by this gateway is 250 MB.
Lookup Table Gateway Out
The lookup table gateway is used to fill a lookup table automatically from a message. See also Automatic Population of Lookup table using Channel for information about importing data from a channel.
The technical id of the lookup table. |
|
Enable this if you need to append the records from the messages going through this channel. If not enabled, the entire table will be replaced by the new values when the criteria below are not configured. However, defining criteria will allow only the new values to be appended. |
|
If filled, only the values that match this criterion will be deleted or inserted in the target lookup table. The name must be the name of the column that must match. The value is the value that this column must have to be replaced. |
Below is more explanation in more technical details regarding the "Append" and "Criteria" options.
Each of the "Append" and "Criteria" options are related to each other and this means that changing one of them will affect the behaviour of the other option after checking the data updated in the lookup table.
The sequence of execution by the system is to check first the "Criteria" option and then "Append" option.
To make it easy in explanation we can say that the "Criteria" option is like a filterloop() function which will be executed first on the output message by only selecting the lines which its row column name equals to the provided value and all of the other lines don't match this condition will not be seletect.
After that the lines in the lookup table will be selected based on the same criteria, And all of the other lines in the lookup table will not match this criteria will be ignored and will be stored in the lookup table.
After that based on the "Append" option if it is enabled then the selected lines from the output message based on the "Criteria" option will be appended to the selected lines from the lookup table based on the "Criteria" option, And the other lines in the lookup table which was not selected based on the "Criteria" option will found also in the lookup table.
As the "Append" option can be enabled or disabled and the "Criteria" option can be used or not used, then this means that we have 4 cases to be generated.
1-The "Append" option is enabled and the "Criteria" option is not used, This means that the complete output message will be appended to the complete lookup table.
2-The "Append" option is disabled and the "Criteria" option is used, This means that the selected lines from the output message based on the "Criteria" option will be checked against the selected lines from the lookup table based on the "Criteria" option and if the input message has the exact lines found in the lookup table then this lines will not be deleted from the lookup table and if the output message has a new lines or old lines which has one updated value or more then this lines will be considered as a new line and will be created in the lookup table, And for the lines that are matching the "Criteria" option from the lookup table and the output message didn't have them or with updated values then this lines will be deleted from the lookup table.
3-The "Append" option is enabled and the "Criteria" option is used, This means that the selected lines from the output message based on the "Criteria" option will be appended to the selected lines from the lookup table based on the "Criteria" option and all of the other lines from the lookup table that didn't match the "Criteria" option will be in the lookup table without any updates.
4-The "Append" option is disabled and the "Criteria" option is not used, This means that all of the entire lookup table lines will be replaced by all of the lines from the entire output message.
Note: When the "Criteria" option is not used then this means that all of the output message lines and lookup table lines will be selected.
In the below example we will see that the below lookup table has lines with the column "One" having the values of "None" and "Update", as shown below.
When the below input message is generated from the channel which has two "Update" lines and only one of them has updated data, as shown below.
And the "Append" option is disabled and the "Criteria" option is used then in this case only the new line will be created and the old line will be deleted, as shown below.
Now when the "Append" option is enabled and the "Criteria" option is used and we have sent the same message two times we will see that only the "Update" lines are appended from the output message and the "None" lines are ignored, as shown below.
Now when the "Append" option is disabled and the "Criteria" option is not used then this means that all of the entire lookup table lines will be replaced by all of the lines from the entire output message, as shown below.
Note:
- If there is a file name provided in the "Message In" or "Message Out" which contain ~ tilde character, All browser based on Chromium will replace the ~ tilde character by the _ underscore character when you try to download the file from the Babelway interface, For more details you can check this link https://bugs.chromium.org/p/chromium/issues/detail?id=479419
- The maximum file size accepted by this gateway is 100 MB.
SAP Gateway Out
With a SAP Out Gateway, outgoing messages are pushed from Babelway to a SAP server.
The specific settings are:
SAP client to use. This is the three digit number you use in the first field of the login screen of SAP Gui. It has the name 'Client' and is just above the user and password fields. For instance: 001, 210, 400 ... |
|
The Valid SAP user ID you want to use. Ideally this should be a user specially created for this purpose. For instance: user |
|
Password associated with the user ID. For instance: password |
|
IP or DNS name for SAP application server. For instance: sap.yourcompany.com |
|
SAP system number is the last 2 digits of the SAP client. For instance: 01, 10, 00. Default is the last 2 digits of SAP client parameter |
Note:
- If there is a file name provided in the "Message In" or "Message Out" which contain ~ tilde character, All browser based on Chromium will replace the ~ tilde character by the _ underscore character when you try to download the file from the Babelway interface, For more details you can check this link https://bugs.chromium.org/p/chromium/issues/detail?id=479419
- The maximum file size accepted by this gateway is 100/250 MB.
Dropbox Gateway Out
The Dropbox gateway out allows you to upload your messages into a Dropbox account.
The specific settings are:
The name of the Dropbox account to which the messages will be sent. This information is "read only", and set by the wizard when you allow Babelway to access the Dropbox account. |
|
The folder in your Dropbox account in which the messages will be placed. This folder will appear under the path /Apps/Babelway/ . |
|
Filename of the outgoing message [with extension if applicable]. If empty, we will apply the default settings. |
Note:
- If there is a file name provided in the "Message In" or "Message Out" which contain ~ tilde character, All browser based on Chromium will replace the ~ tilde character by the _ underscore character when you try to download the file from the Babelway interface, For more details you can check this link https://bugs.chromium.org/p/chromium/issues/detail?id=479419
- The maximum file size accepted by this gateway is 250 MB.
Exact Postbox Gateway Out
The Exact gateway allows to send messages to Exact Postbox users. This gateway must be used with the Exact wizard and the message delivery is based solely on the content of the message sent.
Note:
- If there is a file name provided in the "Message In" or "Message Out" which contain ~ tilde character, All browser based on Chromium will replace the ~ tilde character by the _ underscore character when you try to download the file from the Babelway interface, For more details you can check this link https://bugs.chromium.org/p/chromium/issues/detail?id=479419
- The maximum file size accepted by this gateway is 100 MB.
This gateway allows you to send files directly to an account on Tradeshift.
URL Prefix to call Tradeshift API. Default is https://api.tradeshift.com/tradeshift/rest/ |
|
Choose 'Tenant' to connect to your own Tradeshift account and send the document from there. Choose 'Van' if you don't have a Tradeshift account and you need to dispatch the document to the account of someone else. |
|
The Tradeshift tenantId to use. Use Babelway application in Tradeshift to retrieve this value. |
|
The Tradeshift token to use. Use Babelway application in Tradeshift to retrieve this value. |
|
The Tradeshift token secret to use. Use Babelway application in Tradeshift to retrieve this value. |
|
The Tradeshift consumer key to use to authenticate the Babelway application. This should be left empty in most of the case. |
|
The Tradeshift consumer secret to use to authenticate the Babelway application. This should be left empty in most of the case. |
|
Comma separated list of error Http return code that should be retried. If the return code is not in the list, the message is set in error. The default is '502,503,504'. |
|
Optional. If the HTTP response is success (HTTP code 2xx) and if the HTTP response matches one of the pattern(s) (regular expressions), the message will be retried. |
|
The Tradeshift API to call. Do not include the URL prefix. |
|
You can specify the http method to call. The default is PUT. |
|
The content type of the generic api request. The default is text/xml. |
|
The content type of the generic api response. The default is text/xml. |
|
Select zero, one or several gateways to receive the response from the Tradeshift API. |
|
The Tradeshift document profile. |
|
The van id used by Tradeshift to find the business partner. |
|
The country used by Tradeshift to find the business partner. |
|
The company name used by Tradeshift to find the business partner. |
|
The email address used by Tradeshift to find the business partner. |
|
The identifier scheme used by Tradeshift to find the business partner. |
|
The identifier value of the scheme used by Tradeshift to find the business partner. |
|
Key value pairs which will be added to the request. |
|
Additional properties that can be set on the Tradeshift document. |
|
Allows you to determine what to do if call to remote server fails. If 'No retry' is chosen, the message will be put immediately in error. Other values allow to make some retries before setting the message in error.
|
|
Select zero, one or several gateways to receive the response from the server. |
|
The strategy that will be used to transfer the user metadata to the new message created in the connected gateways. |
|
The technical id of the lookup table. |
Note:
- If there is a file name provided in the "Message In" or "Message Out" which contain ~ tilde character, All browser based on Chromium will replace the ~ tilde character by the _ underscore character when you try to download the file from the Babelway interface, For more details you can check this link https://bugs.chromium.org/p/chromium/issues/detail?id=479419
- The maximum file size accepted by this gateway is 100/250 MB.
Amazon Marketplace Gateway Out
This gateway allows to send 'Feeds' to an account on Amazon Marketplace.
Request support@babelway.com for changing this parameter. Type of process. 'Feed' is the only one supported at this stage. |
|
Request support@babelway.com for changing this parameter. Endpoint is the entry point for an Amazon marketplace web service. Default is https://mws.amazonservices.com |
|
Amazon marketplace web services access key ID. |
|
Amazon marketplace web services secret key ID. |
|
Amazon marketplace seller ID. |
|
Amazon marketplace ID. |
|
Feed type see MWS doc. |
|
Allows you to determine what to do if call to remote server fails. If 'No retry' is chosen, the message will be put immediately in error. Other values allow to make some retries before setting the message in error.
|
Note: This Gateway Out only sends Price and Inventory and Product messages to Amazon Marketplace.
The below link has the complete list for all of the available FeedType in the Amazon MWS Feeds API section.
https://docs.developer.amazonservices.com/en_US/feeds/Feeds_FeedType.html
Note:
- If there is a file name provided in the "Message In" or "Message Out" which contain ~ tilde character, All browser based on Chromium will replace the ~ tilde character by the _ underscore character when you try to download the file from the Babelway interface, For more details you can check this link https://bugs.chromium.org/p/chromium/issues/detail?id=479419
- The maximum file size accepted by this gateway is 100 MB.
With an BilltrustOut Gateway, outgoing messages are sent to Billtrust API.
All the user defined metadata defined in the messages are passed in the context of the new message.
The specific settings are:
External service address. |
|
URL used to get OAUTH2 token. |
|
Login or username to access the service. |
|
Password associated with the username. |
|
Select zero, one or several gateways to receive the response from the http server. |
|
Comma separated list of expected return Http code. If the return code is not in the list, the message is set in error. The default is '200,201,202,204,205'. |
|
The success expression is a regex. If the response doesn't match the success expression, the message is flagged with 'error' status. |
|
You can specify a filename that will be associated with the server response. Default is 'attachment'. |
|
The strategy that will be used to transfer the user metadata to the response message created in the connected gateways. |
|
Filename of the outgoing message [with extension if applicable]. If empty, we will apply the default settings. |
|
Timeout for connection in milliseconds. Must be between 10000 and 240000. |
|
You can specify the http method to call. The default is POST. |
|
You can add specific http header. This accepts metadata. |
|
The trust level defines the level of security used in the SSL handshake. Relax = No certificate verification, Standard = trusting certificates in environment certificates as well as known CA's, Paranoiac = only trusts certificates defined in the environment certificates. Mutual = requires 2-way authentication. |
After channel deployment, your connection will be available to send messages.
Note:
- In Babelway, we're using the standard Java version of REGEX, and it's the same used all over the system.
- If there is a file name provided in the "Message In" or "Message Out" which contain ~ tilde character, All browser based on Chromium will replace the ~ tilde character by the _ underscore character when you try to download the file from the Babelway interface, For more details you can check this link https://bugs.chromium.org/p/chromium/issues/detail?id=479419
- The maximum file size accepted by this gateway is 100 MB.
This gateway allows to send files directly a Trading Partner’s VAN via the ECGrid VAN. A Trading Partner is the company whom you are going to send documents. It can be useful to integrate with Rite Aid or Wayfair for example.
The VAN gateway routes the message to its destination based on the Identifier / Qualifier pair as determined in the X12 or Edifact data. They look like this:
X12: ISA*00* *00* *ZZ*SENDERID *ZZ*RECEIVERID *010101*0101*U*00401*000000001*0*T*!
EDIFACT: UNB+UNOA:1+SENDERID:ZZ+RECEIVERID:ZZ+
For the VAN Out Gateway, your ID Is the Sender ID. Your Trading Partner ID is the Receiver ID.
When sending a message through the gateway, two things may occur:
1. The Receiver ID is known in the VAN database. If this is the case, your message will transmit properly to your receiver. The message will be successful.
2. The Receiver ID is unknown in the VAN database. The message will be a failure. If this is the case, a new Trading Partner request must be sent. To do so, send the following to support@babelway.com
-
Subject: New Trading Partner Request
-
Trading Partner Name
-
Trading Partner Qualifier / ID Pair
-
Trading Partner VAN name
Setup usually takes 5 business days depending on the receiver’s VAN. Babelway will confirm with you when the setup is complete.
Once this is complete, you may begin using the channel to send to your trading partner.
The specific settings are:
Note:
- If there is a file name provided in the "Message In" or "Message Out" which contain ~ tilde character, All browser based on Chromium will replace the ~ tilde character by the _ underscore character when you try to download the file from the Babelway interface, For more details you can check this link https://bugs.chromium.org/p/chromium/issues/detail?id=479419
- The maximum file size accepted by this gateway is 100 MB.
PEPPOL Gateway Out
This gateway allows you to send files to the PEPPOL network.
More information about PEPPOL in Gateway IN section
Choose between the regular PEPPOL production infrastructure, connected to the SML, or the test infrastructure, connected to the SMK. The default is Production |
|
The peppol key you received as an access point. If none is provided, Babelway's key will be used. |
|
Name of the file sent by AS2. This is an extension to the base AS2 specification and might not be supported by all partners. By default no file name is sent. |
Note: In order to change the PEPPOL environment to Production or Test regarding the "Gateway Out" then from "Gateway Out" properties select Production or Test from "PEPPOL environment" field, as shown below.
Select PEPPOL environment Production or Test
For more information related to 'ALLOW HERMES RECEIVER' contact L2 support (For admins only)
Note:
- If there is a file name provided in the "Message In" or "Message Out" which contain ~ tilde character, All browser based on Chromium will replace the ~ tilde character by the _ underscore character when you try to download the file from the Babelway interface, For more details you can check this link https://bugs.chromium.org/p/chromium/issues/detail?id=479419
- The maximum file size accepted by this gateway is 100 MB.
This gateway allows you to send RosettaNet complient PIP message to another RosettaNet Server. This Gateway must be used along with a RosettaNet message out.
URL of the RosettaNet server of the receiver. |
|
Select signature certificate or go to certificates store. |
|
Select encryption certificate or go to certificates store. |
|
Attachments to add to the S/MIME message. Metadata = Pattern to match metadata containing the file to attach. Filename = name of the file in the zip. If one pattern matches multiple files, it is possible to put them all if you guarantee to generate a different filename name for each. This can be achieved by using the capturing groups of the regex in the filename. Ex: if your metadata pattern is attachment-(.*) and your filename is \1, processing with two metadata attachment-file1.csv and attachment-file2.csv will result in files file1.csv and file2.csv. |
|
Select this to set the GlobalUsageCode in the ServiceHeader to 'Test'. Otherwise 'Production' is used. |
Note:
- In Babelway, we're using the standard Java version of REGEX, and it's the same used all over the system.
- If there is a file name provided in the "Message In" or "Message Out" which contain ~ tilde character, All browser based on Chromium will replace the ~ tilde character by the _ underscore character when you try to download the file from the Babelway interface, For more details you can check this link https://bugs.chromium.org/p/chromium/issues/detail?id=479419
- The maximum file size accepted by this gateway is 100 MB.
NemHandel Gateway Out
This gateway allows you to send messages to the Danish NemHandel network.
Select the certificate use to register your information into the NemHandel registry. |
|
Choose between the regular NemHandel production infrastructure, or the test infrastructure. The default is Production |
|
Select signature certificate or go to certificates store. |
|
Allows you to determine what to do if call to remote server fails. If 'No retry' is chosen, the message will be put immediately in error. Other values allow to make some retries before setting the message in error.
|
Note:
- If there is a file name provided in the "Message In" or "Message Out" which contain ~ tilde character, All browser based on Chromium will replace the ~ tilde character by the _ underscore character when you try to download the file from the Babelway interface, For more details you can check this link https://bugs.chromium.org/p/chromium/issues/detail?id=479419
- The maximum file size accepted by this gateway is 100 MB.
Chorus Pro Gateway Out
This gateway allows you to send invoices and credit note to the french administration network.
This is the Chorus Pro environment you want to use: Production or Qualification. |
|
This is the technical username provided by chorus pro support to access the API through Babelway. More information on how to have that username can be found below. |
|
This is the technical password provided by chorus pro support to access the API through Babelway. More information on how to have that password can be found below. |
|
Allows you to determine what to do if call to remote server fails. If 'No retry' is chosen, the message will be put immediately in error. Other values allow to make some retries before setting the message in error.
|
Note:
- If there is a file name provided in the "Message In" or "Message Out" which contain ~ tilde character, All browser based on Chromium will replace the ~ tilde character by the _ underscore character when you try to download the file from the Babelway interface, For more details you can check this link https://bugs.chromium.org/p/chromium/issues/detail?id=479419
- The maximum file size accepted by this gateway is 100 MB.
Database Gateway OUT
The database gateway connects to a database and pulls rows out (gateway IN) of a table and converts them to an XML file.
Currently, we support Oracle connections (using JDBC - so no current limitations on DB versions) and PostgreSQL connections. We can (and are interested in) setting up additional connection types at a limited cost. Let us know if there’s any client interest.
The connection information is common for both IN and OUT gateways:
- host,
- username,
- password,
- database name,
- service id (for oracle only),and
- SSL (check if you wish to use SSL).
You will additionally have to specify which table you wish to fetch content from, the columns you wish to retrieve (optionally) and what to do with the rows you’ve fetched:
- delete - will rely on table’s primary key to delete the exact row which was fetched.
- update - will fetch only rows where the ‘status column’ has the value that indicates row is in ‘todo’ and will update it to the ‘done’ value once the row has been fetched.
Both gateways build and understand a very basic XML format that looks like this:
<Message>
<table1>
<col1>my first value</col1>
<col2>my second column value</col2>
</table1>
</Message>
As an example, if I were to send this in a database gateway out it would try to execute:
INSERT INTO table1 (col1, col2) VALUES ('my first value','my second column value')
There’s nothing else to it... Please contact us if you need any additional information on this.