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:
|(No flag)||Validates the ZIP file and uploads only if no validation errors occur|
|Validates the ZIP file without uploading|
|Forces upload of the ZIP file regardless of validation result|
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:
|Success: no validation errors occurred and ZIP file upload succeeded|
|Validation failure: validation errors occurred (independent of upload requirement)|
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.