ZipSync Validation
The ZipSync process automatically validates all CSV files to ensure that:
- All required files are present
- Files have all required columns
- All files have the header row
- Phone numbers are in the required format
- Email addresses are in the required format
- All referential relationships between the ZipSync files are consistent (e.g., between Users & Sites)
- Valid values for CSV content exist on the client side (where possible to confirm); for example, DS_GROUPS.csv / TIMEZONE, DS, DS_USERS.csv / LANGUAGE_OVERRIDE, DS_TEXT_PHONE_DEVICES.csv / COUNTRY_CODE
If no validation errors occur, the files are uploaded; if there are validation errors, they are logged to the CSV file indicated in the console output.
Runtime Modes & Command Line Flags
There are three runtime modes for validation:
- Validate and upload only if no validation errors found (default)
- Validate only (do not upload)
- Validate and force upload even if validation errors found
You can control these modes using the following command line flags:
Flag | Description |
---|---|
(No flag) | Validates the ZIP file and uploads only if no validation errors occur |
-v --validate |
Validates the ZIP file without uploading |
-f --force |
Forces upload of the ZIP file regardless of validation result |
Examples
epic file <filename>.zip
epic file <filename>.zip --validate
epic file <filename>.zip -f
EPIC Return Codes
The EPIC process will return one of the following codes:
Return Code | Description |
---|---|
0 |
Success: no validation errors occurred and ZIP file upload succeeded |
2 |
Validation failure: validation errors occurred (independent of upload requirement) |
255 |
Program error: possible causes include bad command line parameters, inability to reach the server, or some other problem that prevented the program from completing. Note: while this value is typically 255, it may also be any non-zero value except 2. |
When the EPIC client validates the ZIP file and then uploads it to the server, any errors (e.g., due to network issues, etc.) that occur after validation will be reported; in this case, validation results are not reported. Note that this applies by default and when -f is specified. However, if the -f option is used and the upload was successful, validation errors will be reported.