File name pattern restrictions

When ION is creating files - in write actions or when renaming files in after read action), the file name pattern must be specified. These are the restrictions:

  • Illegal Characters: / \ ? * : | " < > ( ) & ; null # ^ \r \n
  • Illegal Conventions: Placing a space at the end of the name or placing a period at the beginning or the end of the name.

When any of the characters exist in the file name pattern, for example from the values set by the user or coming from standard or fields keywords. The File Connector replaces these characters with % followed by the character ASCII Code before creating the file.

These file system restrictions are currently not checked by the File Connector:

  • Maximum File Name length allowed
  • Reserved keywords.

Ensure that the full file name consists of allowed characters in respective SMB / FTP / sFTP / FTPs. Characters that are not allowed can cause a retry on write actions in ION. This results in a "hanging" connection point and can only be resolved by removing the relevant message from the Incoming Pending Messages queue.

When an error occurs during the file creation with these actions:

  • Write Action: the write operation fails and a confirm BOD is created.
  • After Read Action: the rename operation fails and the file is moved to the Error Location.