Config / Data Exchange / ANVEDI Remote Comm. Handler

ANVEDI Remote Comm. Handler

For new implementations, please check if you can use the File Exchange Service. The components described in this chapter will not be supported on new Microsoft Dynamics NAV 2015 (BC22 and above) releases. We will only provide updates in case of security vulnerabilities.

This codeunit is not available in Microsoft Dynamics 365 Business Central Online (SaaS). This codeunit requires the installation of external .NET components, which are provided free of charge.

This codeunit is used to sent or receive files from/to a remote server. This codeunit requires the installation of additional .NET components on the service tier. (Or on each machine in the case of the Classic Client of NAV). Please see the Installation chapter for more details.

You can select this codeunit in the communication channel and use the action Configure in the communication channel, to change the settings.

TLS versions: All of our on-premise components are using the .NET framework and support the TLS versions that are currently supported by your operating system an .NET 3.5

Fields

Communication Channel Code

This field is part of the primary key. This field is filled automatically.

Description

A description of the server / settings.

Protocol

The protocol to be used. Depending on the direction of the communication channel you can only select some of the protocols.

SMTP

For outgoing transmissions only. Use SMTP to send e-mail like messages.
(The integer value of this option in the database is 0)

The SMTP part of the module is intended for use with technical systems and not for creating human-readable emails.

POP3

For incoming transmissions only. Retrieve data from a POP3 server.
(The integer value of this option in the database is 1)

FTP/FTPS

Use FTP oder FTP over SSL.
(The integer value of this option in the database is 2)

On module version prior to version 4.00 the unencrypted FTP mode is only reliable if you’re using version 3.00.36 with an additional remote communication hotfix. This is due to a bug in the .NET components provided with the module and only affects FTP connections (FTP without SSL). FTPs should also work without the hotfix.

SFTP

Use SFTP (SSH).
(The integer value of this option in the database is 3)

Host

The server name / DNS address or IP.

Port

The port that should be used. Most protocols have default ports defined, if you set this value to 0.

User

The user name that should be used to contact the server.

Password

The password that should be used to authenticate the user to the server.

Encryption

The encryption mode. Select SSL for FTPS or to use encrypted SMTP or POP3.

None

Do not use encryption or use the default encryption in case of SFTP.
(The integer value of this option in the database is 0)

Yes

This option was named SSL before version 5.2. We renamed the option because not all protocols use SSL for encryption.

Use encryption.
(The integer value of this option in the database is 1)

Sender Address

Only used by SMTP: The sender e-mail address.

Sender Name

Only used by SMTP: The sender name in clear text.

Default Recipient

Only used by SMTP: The recipient if the receiver identification is empty.

Subject

Only used by SMTP: The subject of the message. You can also use all variables that are available for the field Filename Template.

Send file as Attachment

SMTP only: Whether to sent the data as body or as an attachment.

Text Template

SMTP only: When data is sent as an attachment you can define a static text that is sent as the body of the message. This field is not directly available in the user interface. We do not support variables inside the text part.

The SMTP part of the module is intended for use with technical systems and not for creating human-readable emails.

Action on Import

The action that should be executed after importing the transmission. This aqction is executed after the data was successful retrieved and stored. It is also executed if the data cannot be converted, as the data is available to Microsoft Dynamics NAV 2015 for re-processing.

Do Nothing

No action after import.
(The integer value of this option in the database is 0)

Archive

Archive the data after import (not supported by all protocols).
(The integer value of this option in the database is 1)

Delete

Delete the data after import.
(The integer value of this option in the database is 2)

Allow Duplicate Filenames

Whether the same file name can be imported multiple times by the same communication channel.

Connection Keep-Alive

Whether to keep the network connection open when retrieving or sending more than one transmission.

FTP Transfer Mode

Only used for FTP and FTPs. The data transfer mode to be used.

Select automatically,.
(The integer value of this option in the database is 0)

Passive (Auto)

Passive mode. Select implementation automatically.
(The integer value of this option in the database is 1)

Active (Auto)

Active mode. Select implementation automatically. This will require that the active FTP ports on the machine running the code is directly available from the internet.
(The integer value of this option in the database is 2)

EPRT

Extended port mode
(The integer value of this option in the database is 3)

EPSV

Extended passive mode
(The integer value of this option in the database is 4)

PASV

Traditional passive mode
(The integer value of this option in the database is 5)

PASVEX

Extended passive mode
(The integer value of this option in the database is 6)

PORT

Active port mode
(The integer value of this option in the database is 7)

FTP Encryption Mode

When to start the encryption for FTPs connections.

Default behaviour.
(The integer value of this option in the database is 0)

Implicit

Start the encryption on connection to the server.
(The integer value of this option in the database is 1)

Explicit

Connect unencrypted and change to encryption afterwards.
(The integer value of this option in the database is 2)

FTP Data Type

You can select the FTP data mode. Depending on the content of the data the text mode will change the encoding of the file during transfer and sometimes the representation of line breaks.

Binary

The data is considered to be binary. This is required, for example, for PDF files.
(The integer value of this option in the database is 0)

Text

The data only contains text and can be re-encoded.
(The integer value of this option in the database is 1)

Filename Template

A template string to build the file name for outgoing files. You can use any constant text that is valid inside file names. We support several global variables that can be used inside the filename. Because the module does not know the content of the file and the used buffer structures you cannot directly access data from the file.

The following variables are available:

{Entry No.}

The entry number of the transmission. Can be used to generate a unique filename.

{Reference No.}
{Reference}

Not supported in older versions. Output the reference number (document number) that is stored with the transmission. If business transactions are used it is automatically set.

{Description}

The description of the transmission.

{Sender Party}

Deprecated. Alias for {Sender Partner}.

{Sender Partner}

The sender partner code.

{Sender Identification}

The sender partner identification.

{Receiver Party}

Deprecated. Alias for {Receiver Partner}.

{Receiver Partner}

The receiver partner code.

{Receiver Identification}

The receiver partner identification.

{Project}

The project of the mapping that has generated the data.

{Format}

The format of the mapping that has generated the data.

{Code}

The code of the mapping that has generated the data.

{CCYY}

The year with century information, e.g. 2019.

{YY}

The year, e.g. 19.

{MM}

The month as two digits.

{DD}

The day as two digits.

{WW}

The calendar week, represented as two digits.

{QQ}

The quarter, represented as two digits.

{HH}

The hour of the transmission creation.

{mm}

The minutes of the transmission creation.

{ss}

The seconds of the transmission creation.

It is possible to create custom variables via the callback functionality of the module, if you need, for example, to include a document number in the filename.

File Mask

Currently not supported.

Remote Directory

The directory on the server, if the protocol support remote directories.

Private Key

Used for SFTP only. Stores the private key. Anveo EDI Connect does not officially support the use of private keys. You can try it with an OpenSSH formatted key, but our support cannot help you with key errors. The module currently has no option to remove the key, once it is set. You either have to create a new communication channel, or empty the BLOB by using the Microsoft Dynamics NAV 2015 development environment.

Host Key

Currently not used.

Host Fingerprint

Optional: The fingerprint of the remote SFTP server to compare after connecting. If the keys do not match an error is generated. If you leave the field empty the module will accept any certificate for the server.

Ignore SSL Errors

Whether the SSL certificate has to be valid or whether all certificates are accepted.

Ignoring SSL error will make man in the middle attacks possible. You should try to resolve the SSL error instead of accepting any remote certificate.

Internal NAV Encoding

If you set the internal and external encoding, the module will try to re-encode the data. You should set these fields to empty, if you are not sure whether a re-encode is required. This way the data is not changed on sending/receiving by the component.

External Encoding

If you set the internal and external encoding, the module will try to re-encode the data. You should set these fields to empty, if you are not sure whether a re-encode is required. This way the data is not changed on sending/receiving by the component.