Q-Cloud File Parser Configuration Reference

Required Environment Variables

Variable Description

QWEB_USERNAME

Authentication username used for API authentication.

QWEB_PASSWORD

Authentication password used for API authentication.

URL

Base URL for the Q-Cloud API requests.

PARSER_MODE

Selects which file family the container accepts: acg, zwz, or unilinunimat.

Common Optional Variables

Variable Default Description

LOG_MODE

message

message for concise lines, debug for structured JSON logs.

RUN_ID

auto-generated

Stable identifier for one parser run.

FAIL_FAST

true

Stop on the first failed or invalid file when set to true.

INPUT_FORMAT

auto

auto uses the file extension, or force csv or json.

PROCESSED_FILE_ACTION

none

Post-success handling: none, archive, or delete.

ARCHIVE_DIR

<input directory>/archive

Archive destination when PROCESSED_FILE_ACTION=archive.

BATCH_SIZE

5000

Maximum records per internal batch.

VERIFY_TLS

workflow default (true)

Set false only when you intentionally need insecure TLS.

DRY_RUN

false

Plan the run without sending write requests.

Integration-Specific Variables

Some file interfaces need extra settings. The available options depend on PARSER_MODE.

ACG Generic File Interface

The generic ACG mode uses per-file-type regex settings.

  • FILE_REGEX_ADDUSER selects the file to process for Add User imports.

  • FILE_REGEX_REMOVEUSER selects the file to process for Remove User imports.

  • FILE_REGEX_ADDITEM selects the file to process for Add Item imports.

  • FILE_REGEX_REMOVEITEM selects the file to process for Remove Item imports.

  • FILE_REGEX_ADDARTICLE selects the file to process for Add Articles imports.

  • FILE_REGEX_ADDARTICLEGROUP selects the file to process for Add Article Group imports.

  • FILE_REGEX_OUTSCAN selects the file to process for Outscan imports.

ZWZ Fileinterface

The ZWZ mode uses one file match pattern and a small set of routing settings.

  • FILE_REGEX selects the single ZWZ file to process.

  • customer_external_id selects the customer scope used for ZWZ outscan routing.

  • device_external_id selects the loading device used when ZWZ should create a device load.

  • ITEMPOOL_EXTERNAL_ID selects the stock pool used when ZWZ creates generic garments.

  • DELETE_NOT_IN_FILE turns on masterfile-style deletion for ZWZ, so garments not present in the file are removed.

UNILIN-UNIMAT

The UNILIN-UNIMAT mode also uses one file match pattern.

  • FILE_REGEX selects the single UNILIN-UNIMAT file to process.