HOW TO
Process CSV Files
Goal
Read, transform, and write delimited files from Excel.
Prerequisites
- Read and write permission for the input and output directories.
- A known delimiter, file-name pattern, and expected arrival condition.
- A protected output path or an explicit user trigger for writes.
Steps
1. Watch the input directory or identify matching files after the readiness time.
2. Read each ready file and keep the file name as its cache key when useful.
3. Combine and sort the loaded rows.
4. Write only after the readiness check succeeds.
Result
Matching files are read, normalized, combined, and written only after the readiness condition succeeds.
Common Variations
- Use
U.WATCH_FILESto trigger discovery only after relevant filesystem changes. - Cache large inputs when only a small derived output needs to remain in the workbook.
- Read multiple file paths directly through supported append configuration.
Troubleshooting
- If no files appear, verify directory, pattern, earliest write time, and permissions.
- If fields parse incorrectly, inspect raw delimiters and locale-sensitive numeric/date conversion.
- If writes repeat, move the write behind a readiness transition or explicit event.