Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Expand
titleSTEP 2: Set up the component configurations
image-20240814-201930.png

Fields marked with an asterisk * are required.

Connection Configurations:

Field

Description

Default Value

Protocol *

Specifies the protocol you’ll be using. Supports: FTP, FTPS, or SFTP

FTP

Server *

The server you will be connecting with

-

Port *

The port to use

-

Username *

The remote user to login as.

This account will need permissions to read, delete, and/or move files to the specified FTPDirectory

-

Password

The password to authenticate with.

-

Certificate

The name of your certificate file, if in use.

By default, this should be a PEM certificate. The default configurations can be changed by modifying the net.[protocol].init function directly in the script. See Adapting the Component.

This configuration is only applicable for FTP and FTPS.

-

PrivateKey

The name of your private key file, if in use.

By default, this should be a PEM certificate and not be password-locked. The default configurations can be changed by modifying the net.[protocol].init function directly in the script. See Adapting the Component.

-

RetryCount

The number of times to retry the connection if it drops. Default is set to 3 attempts.

3

FTP Workflow Configurations:

Field

Description

Default Value

FTPDirectory *

The source directory on the FTP server you’ll be retrieving files from

FTP

FileType

The types of files you wish to retrieve (e.g. txt). You can also specify multiple files (e.g. txt,hl7) or all file types (e.g. *).

-

MoveFTPProcessedFiles

Set to true if you wish to move processed files (i.e. files that have already been downloaded to the local server) to a folder on the FTP server designated by FTPProcessedDirectory. If false, processed files will be deleted.

true

FTPProcessedDirectory

The directory on the FTP server that processed files will be moved into. You will need to create this folder if you choose to use this workflow.

-

Local File Workflow Configurations:

Field

Description

Default Value

LocalDirectory *

The local directory that the files will be downloaded to from the FTP server. Files in this directory will then be picked up for processing.

-

MoveProcessedFiles

Set to true if you wish to move processed files to a local folder designated by ProcessedDirectory. If false, processed files will be deleted.

true

ProcessedDirectory

The local directory that processed files will be moved into. You will need to create this folder if you choose to use this workflow.

-

MinimumFileAge *

The time to wait in seconds after last modified date before processing.

0

IgnoreSegments *

Specifies whether to remove identified segments when processing file.

Default segments to ignore include: FHS, BHS, FTS, BTS. This can be modified in config.lua. See Adapting the Component.

false

InputFileEncoding *

The encoding used in the output file.

If left blank, encoding will be updated to the default according to OS. See supported encodings below.

Western (Windows-1252) for Windows

Western (ISO-8859-1) for Linux/Mac OS.

Expand
titleSTEP 3: Start the component and view the processed files' contents in the logs

Once the component has been started, it will download files that match the provided parameters to the specified local directory. It will then process the downloaded files and push their contents to the component’s queue for further processing. Open the component’s logs to see the queued files and verify that the contents are being read as expected.

...