Expand |
---|
title | Setup Tank Monitor Interface |
---|
| 1. Go to System Manager, select Company Configuration menu. This will open the Company Configuration screen. 2. Navigate to Tank Management, Tank Monitor tab, click Interface Type. 3. Select Anova Gaslog. 4. Enter details, then click Save ![](/download/attachments/130318438/image2021-10-5_13-41-10.png?version=1&modificationDate=1633412480363&api=v2&effects=border-simple,shadow-kn)
|
Expand |
---|
title | Post credentials to the token API to retrieve a current Bearer token |
---|
| 1. Download and install Postman. 2. Open Postman, click "+" button. GET New Request will be added on your tab. ![](/download/attachments/130318438/image2021-10-5_14-47-20.png?version=1&modificationDate=1633416450563&api=v2&effects=border-simple,shadow-kn)
3. On New Request tab, change the selection on dropdown menu to POST. 4. Enter request URL: https://auwweb.gaslogtelemetry.com/api/v1/connect/token? ![](/download/attachments/130318438/image2021-10-5_15-4-2.png?version=1&modificationDate=1633417452250&api=v2&effects=border-simple,shadow-kn)
5. On New Request tab, navigate to Body tab. Select x-www-form-urlencoded, then enter the following details: KEY | VALUE | grant_type | password | username | woodford.irely | password | BBA@2n56 | client_id | WoodfordOilCo | client_secret | 0B3B0F8DCA374CC0A9BC03804DFA09 |
6. Click Send button. Response will be generated.
![](/download/attachments/130318438/image2021-10-5_15-47-49.png?version=1&modificationDate=1633420079023&api=v2&effects=border-simple,shadow-kn)
Note: access_token change every send. |
Expand |
---|
title | Call the tankinfo API to retrieve a list of all tanks |
---|
| 1. Click "+" button. GET New Request will be added on your tab. ![](/download/attachments/130318438/image2021-10-5_16-41-42.png?version=1&modificationDate=1633423313020&api=v2&effects=border-simple,shadow-kn)
2. Enter request URL: https://auwweb.gaslogtelemetry.com/api/v1/device/tankinfo. 3. Navigate to Authorization tab then select Bearer Token. ![](/download/attachments/130318438/image2021-10-5_16-40-36.png?version=1&modificationDate=1633423247277&api=v2&effects=border-simple,shadow-kn)
4. Copy the generated access_token from previous step response. ![](/download/attachments/130318438/image2021-10-5_16-54-46.png?version=1&modificationDate=1633424096257&api=v2&effects=border-simple,shadow-kn)
5. Enter it in the Token field, then click Send button. ![](/download/attachments/130318438/image2021-10-5_16-57-48.png?version=1&modificationDate=1633424278397&api=v2&effects=border-simple,shadow-kn)
6. Click Save Response > Save to a file ![](/download/attachments/130318438/image2021-10-5_17-1-39.png?version=1&modificationDate=1633424509903&api=v2&effects=border-simple,shadow-kn)
7 7. Select path to save file, then click Save button. File will be saved as response.json. Note: lastReportedDate change every day. Details in generated response will be used in Clock reading, Customer creation, Device creation, and Consumption SIte |
Expand |
---|
title | Create Customer with Consumption Site, Create and Add the Devices to the Site, and Add Clock Reading |
---|
| The following should be setup/ready before the import: 1. Costumer with Consumption Site - customer should have an existing consumption site. Customer Number is used as the mapping for customerAccount. Image Added
2. Devices - consumption site should have an attached devices. Device Tank Monitor Serial # (serialNumber) and Device Tank Serial # (customerTank) are paired with customer number where the combination is used as mapping for import. Image Added
3. Clock Reading - a reading date entry should also exists in Clock Reading as this is being mapped as lastReportedDate. Image Added
The date should also not exist in Events tab of the Consumption Site. Image Added
Expand |
---|
| Field | Example | i21 Field | Notes |
---|
deviceId | 618000 | Not Used |
| serialNumber | 7534188 | TM > Site > Device > Tank Monitor Serial # | Matching Hierarchy #1 this is first to check. - Device Type = Tank Monitor
- Device Serial # matches to file
- Device Linked to a Site
If no match then try Matching Hierarchy #2. | customerAccount | 12430655 | TM > Site > Customer | Matching Hierarchy #2 - Site with Customer # that Matches API > customerAccount
- Device Linked to Site
- Device Type = Tank
- Device Serial # matches API > customerTank
If no match then give errors that no match was found. | customerName | John Clutter | Not Used |
| customerTank | 1361978 | TM > Site > Device > Tank Serial # | Part of Matching Hierarchy #2 see customerAccount | tankSize | 500 | NA | Should already be setup on TM Site > Tank Device | address | Howard Street | Not Used |
| town | Cowen | Not Used |
| state | WV | Not Used |
| postcode | 26206 | Not Used |
| latitude | 38.4132843 | TM > Site > Latitude | Will be used to Update TM Site if there is no existing value | longitude | -80.5601714 | TM > Site > Longitude | Will be used to Update TM Site if there is no existing value | lastReportedDate | 08/23/2021 06:39:00 | TM > Site > Reading Event > Event Date | Will ignore adding duplicate readings | lastReportedLevel | 66 | TM > Site > Estimated % Left TM > Site > Estimated Gallons Left |
Use Estimated % Left x TM Site > Total Capacity to get Estimated Gallons Left | lastDeliveryDate | 03/04/2021 14:52:00 | Not Used |
| tankType | Horizontal Tank | Not Used |
| dailyUsage | 0.0 | Not Used |
|
Sample JSON with 2 records: [ { "deviceId": "618000", "serialNumber": "7534188", "customerAccount": "12430655", "customerName": "John Clutter", "customerTank": "1361978", "tankSize": "500", "address": "Howard Street", "town": "Cowen", "state": "WV", "postcode": "26206", "latitude": "38.4132843", "longitude": "-80.5601714", "lastReportedDate": " | 082304/2021 06:39:00", "lastReportedLevel": " | 6665", "lastDeliveryDate": "03/04/2021 14:52:00", "tankType": "Horizontal Tank", "dailyUsage": 0. | 0028571 }, { "deviceId": "618001", "serialNumber": "7542459", "customerAccount": "63150005", "customerName": " | RDR Energy Resources IncRDR Energy Resources Inc.", "customerTank": "Concrete Plant", "tankSize": "2005", "address": "411 Sycamore Street", "town": "Clarksburg", "state": "WV", "postcode": "26301", "latitude": "39.2861121", "longitude": "-80.3520409", "lastReportedDate": " | 082303/2021 15:37:00", "lastReportedLevel": " | 5854", "lastDeliveryDate": " | 081701/2021 15:00:00", "tankType": "Diesel", "dailyUsage": | 7623467 |
|