Skip to main content

File Connection paths, masks and naming

Configuration options

UI purpose / propertyType/defaultRuntime effect and conditions
File name / FileNametag-capable string / emptyOutput naming template; supports runtime/data tags plus <FILENO> and <COUNTER>
File pattern / FilePatterntag-capable pattern / *Selects inbound files and can contribute to Transport output naming
Main folder / FileDirpath / <DEFAULTDIR>\Primary read/write folder; setter enforces a trailing delimiter and derives default subfolders
Counter / EnableCounterBoolean / falseEnables database-backed <COUNTER> increments
Unique file name / UniqueFileNameBoolean / trueGenerates a unique destination rather than overwriting an existing file
Ensure safe filename / EnsureSafeFileNameBoolean / trueApplies safe-filename processing after tag expansion
Inbound naming / InboundFileNamingincoming/name-selection enum / use incomingChooses how received Transport data is named locally

<DEFAULTDIR> resolves through General Setup Default file path. Validate the processed absolute path under the runtime account. Tags can produce different names for different records/runs; test collisions, invalid characters and empty values.

Configure and test

  1. Create/open a File Connection and choose a descriptive name.
  2. Set the main folder and narrowest safe input pattern.
  3. Configure output naming and keep safe/unique naming enabled unless a reviewed overwrite contract requires otherwise.
  4. Save, create the required folders and test read/create/move access as Velox Service.
  5. Run a controlled File Definition/Flow and inspect the actual processed path plus file log events.

Continue with post-processing behaviour and locking/failure.