<< Click to Display Table of Contents >> Navigation:  Live > Agents > Web API Agents > Web API Vendor > Live In-Situ Legacy Agent

The In-Situ TROLL Link Telemetry Agent is an EQuIS Live report for obtaining sensor data from In-Situ TROLL Link Telemetry System.

 

To use the In-Situ TROLL Link Telemetry Agent to produce and automatically load data, complete the following steps.

 

Create Logger(s)

 

1.Open EQuIS Professional.

2.Create a new logger in the DT_LOGGER table.

3.Set the LOGGER_CODE equal to the following value, where {UnitIdent} is the identifier of the logger (without brackets) in the In-Situ TROLL Link Telemetry system:

romcomm.netromrdiROMws.asmxGetUnitData#{UnitIdent}
 

4.Set LOGGER_DESC to your preferred name/description for the logger (may be {UnitIdent} if desired).

5.Set UTC_OFFSET_HRS to the number of hours from UTC for the location of the data logger. This value will be used to convert the date/time of each observation to UTC.

6.Set LIVE_DATA_SOURCE equal to the following value, where {UnitIdent} is the identifier of the logger (without brackets) in the In-Situ TROLL Link Telemetry system:

https://www.romcomm.net/romrdi/ROMws.asmx/GetUnitData?UnitIdent={UnitIdent}
 

7.Optionally, set FACILITY_ID and SYS_LOC_CODE to associate the logger with an existing facility and location.

8.Optionally, set DEVICE_DESC to the type of logger (e.g., "Level TROLL 700").

9.Set CUSTOM_FIELD_5 to the encrypted string containing the credentials (e.g., "userid=[userid]&password=[password]") for the In-Situ TROLL Link Telemetry web service.

10.Set STATUS_FLAG equal to 'A'.

 

Create Series

 

1.Open EQuIS Professional.

2.Create a new series in the DT_LOGGER_SERIES table.

3.Set LOGGER_ID to the appropriate value for the In-Situ logger.

4.Set SERIES_NAME exactly as specified in the In-Situ TROLL Link Telemetry system.

5.Optionally, set SERIES_DESC, and SERIES_UNIT as desired.

6.Set STATUS_FLAG to 'A'.

 

Loading Data

 

The In-Situ TROLL Link Telemetry Agent can be run as a scheduled EQuIS Information Agent (EIA), at the desired frequency, to automatically load data as often as needed. When the agent runs, it will process all applicable series in the database, so only one user needs to create and schedule the agent.