To simplify integration to other 3rd party test systems, we introduce Wats Standard Text Format.
When you install the WATS Client, a folder named “WatsStandardTextFormat” is created at C:\ProgramData\Virinco\WATS. This is the input folder for the WATS Standard Text Converter built into the WATS Client. If a file with .txt extension that uses the Wats Standard Text Format is saved to the directory, the WATS Client will automatically read and import the file into WATS.
The format of the Wats Standard Text Format is a tab delimited ASCII file (*.txt). Each line in the file represents an entry containing any number of data fields.
The file consists of three main parts; a Header data part, a Step data part and a Footer data part. The Header data part is further split into two sub parts; a list of predefined headers followed by an optional section of miscellaneous UUT data.
The WATS Client can read one UUT report per file or multiple UUT reports in one file. Use the Data Markers to organize the data.
Converter parameters are used as default values for when the file is missing data or for setting options on the converter. This converter supports:
- operationTypeCode: Process code for the test operation. Default 10 (SW Debug).
- testModeType: See Converter Method below. Default Active.
- operator: Name of the operator performing the test. Default sysoper.
- stationName: Name of the station performing the test. Default is name of the PC.
- sequenceName: Name of the sequence on the first step. Default SeqName.
- sequenceVersion: Version number or name of the sequence on the first step. Default 0.0.0.
- cultureCode: How to read numbers and dates. Default en-US.
- fileEncoding: Code page to read the file with. Default 1252 (Windows Western).
- validationMode: When text is too long or contains invalid character, the converter can either throw error (ThrowExceptions) or remove the extra or invalid character (AutoTruncate). Default ThrowExceptions.
The WATS API supports two methods for importing data: Active and Import. When operating in Active mode, the result of a step, sequence and test is set automatically using the measure, compare operator and the limit(s). In Import mode, the status (pass/fail) must be set manually.
When in Active mode, the Wats Standard Text Format converter use a combination of Active and Import: if status is given in the data, it will be used; if not, limits are used.
When in Import mode, status must be set manually.
Inside the InputPath folder two folders are created: Done and Error. When a file with the correct file type (.txt in this case) is added to the InputPath folder, it is picked up by the WATS Standard Text Converter.
- If the PostProcessAction is "Delete" (default):
- After the system has imported the data in the file, it is deleted if the import succeeded, or moved to the Error folder if it did not.
- If the PostProcessAction is "Move":
- After the system has imported the data in the file, it is moved to one of the two folders, Done if the import succeeded, Error if it did not.
- If the PostProcessAction is "Zip":
- After the system has imported the data in the file, it is moved to a zipped folder inside Done if the import succeeded, or moved normally to Error if it did not.
A file called wats.log has data about the files that is picked up by the WATS Client and imported through the converter.
Where to find the wats.log
Description & Example
Please see the attached PDF for detailed description, and TXT file for example.