A WATS Client converter plugin for importing test data from Listen's SoundCheck test software to WATS.
You can download the latest released version of the converter here. See the Custom Converter section in the WATS Client Installation Guide for your version of the WATS Client for how to install a converter.
This converter uses the following parameters:
| Parameter | Default value | Description |
|---|---|---|
| partRevision | 1.0 | If log is missing a revision, use this one. |
| operationTypeCode | 10 | If log is missing operation code (process code), use this one. |
| operator | oper | If log is missing a operator, use this one. |
| sequenceName | SoundCheckSeq | If log is missing sequence name, use this one. |
| sequenceVersion | 1.0.0 | If log is missing sequence version, use this one. |
| cultureCode | en-US | Which culture to parse numbers and dates with. |
The project uses the MSTest framework for testing the converter.
It is setup with two tests; one for setting up the API by registering the client to your WATS, and one for running the converter.
The values are hardcoded in the test, so you will need to change the values to reflect your setup.
- In SetupClient, fill in your information in the the call to RegisterClient.
- In TestConverter, fill in the path to the file you want to test the converter with. There are example files in the Examples folder.
- Run SetupClient once, then you can run TestConverter as many times as you want.
We're open to suggestions! Feel free open an issue or create a pull request.
Please read Contributing for details on contributions.
The first step to using SoundCheck and WATS together is to add one or more AutoSave to Text - Append steps as in the sequence below. These steps do the real work of saving SoundCheck data in a format that is recognized by the WATS SoundCheck converter.
Next, you will configure the AutoSave to Text step to store the desired data. Note that each SoundCheck AutoSave step can only save one type of data (i.e., Data, Results, and Waveforms). If you want to store both Data and Results you will need two AutoSave to Text steps as in the sequence above. Note, the SoundCheck WATS converter does not support waveforms at this time.
Each AutoSave to Text step needs to be configured to save the Time, Lot No., and Serial No. as shown below. To store Results (e.g., single values), select the Results radio button above and choose the results that you want saved by selecting their names in the Results listbox.
To save Data (e.g., curves) select the Data radio button and choose the data curves from the Data listbox as shown below:
At this point, you are ready to run the sequence and collect data. Unless you change the default configuration, your data file will be stored in the $SoundCheckRoot\data folder where $SoundCheckRoot is the folder where SoundCheck is installed; in the above images, the file will be stored in C:\SoundCheck 18\data.
After running your sequence and saving data, you'll need to move the data file to the WATS SoundCheck converter input path folder as configured in the converter configuration. In the configuration shown below, the WATS SoundCheck converter input path is C:\ProgramData\Virinco\WATS\SoundCheck:
Symptom:
- Converter did not start after being configured.
Possible cause:
- WATS Client Service does not have folder permission to the input path.
- WATS Client Service was not restarted after configuration.
Possible solution:
- Give NETWORK SERVICE write permission to the input path folder
- Make a change in a converter configuration and undo the change, click APPLY. When asked to restart the service, click Yes.
Symptom:
- The converter class drop down list in the Client configurator is empty after adding a converter DLL.
Possible cause:
- The DLL file is blocked. Windows blocks files that it thinks are untrusted, which stops them from being executed.
Possible solution:
- Open properties on the file and unblock it.
Contact Virinco support, and include the wats.log file: Where to find the wats log file at the Client.
- Issues with the converter or suggestions for improvements can be submitted as an issue here on GitHub.
- Ask questions about WATS in the WATS Community Help
- Suggestions for the WATS Client itself or WATS in general can be submitted to the WATS Idea Exchange
- Sensitive installation issues or other sensitive questions can be sent to [email protected]
- Questions on using WATS with SoundCheck can be sent to [email protected]
This project is licensed under the LGPLv3 which is an extension of the GPLv3.