An AQTS field data plugin for AQTS 2019.2-or-newer systems, which can read discharge summary measurements from AquaCalc 5000 CSV files.
- Install it on AQTS 2019.2-or-newer via the System Configuration page
Choose the appropriate version of the plugin for your AQTS app server.
| AQTS Version | Latest compatible plugin Version |
|---|---|
| AQTS 2020.2 | v20.2.1 |
| AQTS 2020.1 AQTS 2019.4 AQTS 2019.3 AQTS 2019.2 |
v19.2.10 |
The plugin has one configurable setting. The configuration settings are stored in different places, depending on the version of the plugin.
| Version | Configuration location |
|---|---|
| 20.2.x | Use the Settings page of the System Config app to change the settings. Group: FieldDataPluginConfig-AquaCalc5000Key: AssumeUsgsSiteIdentifiersValue: Either true or false. Defaults to true if not set. |
| 19.2.x | Read from the INI file in the plugin folder, at %ProgramData%\Aquatic Informatics\AQUARIUS Server\FieldDataPlugins\AquaCalc5000\Config.iniAssumeUsgsSiteIdentifiers=true |
AssumeUsgsSiteIdentifiers defaults to true, and controls whether USGS-style 8-digit site identifiers should be used when the GAGE ID# is numeric.
When AssumeUsgsSiteIdentifiers is true, leading zeros will be added to site identifier so that they conform to the 8-digit identifier format.
When AssumeUsgsSiteIdentifiers is false, no leading zeros will be added, and the GAGE ID# value will be used as-is.
- Requires Visual Studio 2017 (Community Edition is fine)
- .NET 4.7.2 runtime
- Load the
src\AquaCalc5000Plugin.slnfile in Visual Studio and build theReleaseconfiguration. - The
src\AquaCalc5000\deploy\Release\AquaCalc5000.pluginfile can then be installed on your AQTS app server.
Use the included PluginTester.exe tool from the Aquarius.FieldDataFramework package to test your plugin logic on the sample files.
- Open the AquaCalc5000 project's Properties page
- Select the Debug tab
- Select Start external program: as the start action and browse to
"src\packages\Aquarius.FieldDataFramework.19.2.2\tools\PluginTester.exe - Enter the Command line arguments: to launch your plugin
/Plugin=AquaCalc5000.dll /Json=AppendedResults.json /Data=..\..\..\..\data\*.csv
The /Plugin= argument can be the filename of your plugin assembly, without any folder. The default working directory for a start action is the bin folder containing your plugin.
- Set a breakpoint in the plugin's
ParseFile()methods. - Select your plugin project in Solution Explorer and select "Debug | Start new instance"
- Now you're debugging your plugin!
See the PluginTester documentation for more details.
Use the System Configuration page of AQUARIUS Time Series to install the plugin.