Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Security: Visible for all users if configured. See Configuration for details.

Overview

This function feature allows users to retrieve and view (read only) archive historical data. Select the meter, archive type and datetimes (if applicable), then Submit History Requestarchived historical data from ACM.

...

Directions

  1. Select a meter from the Meter selection drop down. This has an auto-complete function allowing the user to enter feature allowing entry of a search phrase and the results will be filtered. Each entry shows the meter name and its unique object id in the ACM configuration.

  2. Select the archive type Archive Type from the available choices.

...

Entry Type

Control UI

Date:

Use the top arrows to select the year and month. Click on the day to select and close the form. When the desired date is selected, the control will be hidden and the entry value updated selected will be applied to the date from the controlform.

Note: The current day is highlighted solid by default.

Time:

Use the mouse (touch on mobile) to move the inner and outer selector to the hour or minute value to set the total time.

When the control loads it positions the outer (hour) selector first. When the desired hour is selected, release the mouse button or (touch on mobile) and the minute mode will position the selection to the inner (minute) selector. When the desired minute is selected, release the mouse button or (touch on mobile) and the control will be hidden and the entry value updated will be applied to the time from the controlform.

Image RemovedImage Added

Archive Results

The results page is formatted differently based on the history type. Each type is discussed below. The link at the top (<- ARCHIVE HISTORY) will navigate back to the entry form discussed above. The last search used during the current session will be reloaded if applicable.

Meter Characteristics

The results page includes a back link to the entry form as well as the name of the meter and the date of the record from the ACM archive.

...

The search function will filter the listing based on the text entered. Click or hit the Enter key on the keyboard to apply a search filter. Clear the entry and click or hit the Enter key on the keyboard to remove a search filter.

...

The results page includes a back link to the entry form as well as the name of the meter, the total number of records in the results returned and the start/end date of the records from the ACM archive.

Records Table

The records table includes the timestamp and sequence number columns by default. These columns are sortable. The remaining columns are dynamic based on the record and as such are not sortable. If the following message appears and no additional dynamic columns are present, then the record fields will not be included in the table columns. They will be present in the Record Details regardless.

...

Record Details

The visibility icon toggles the field details portion of the record to show or hide. The

...

The detail fields in the record can be filtered and sorted by column.

The search function will filter the listing based on the text entered. Click or hit the Enter key on the keyboard to apply a search filter. Clear the entry and click or hit the Enter key on the keyboard to remove a search filter.

...

Troubleshooting Archive History Issues

Error

Description

Resolution

No Records are returned.

No Records are returned when the history is known to have been collected by ACM.

  1. Verify the search parameters are correct including the meter and its id.

  2. Verify the archive history process is running. See Archive Management Tab of the ACM user guide for details.

Inconsistent field data or the record columns are not showing in the main table.

The record set returned had data columns (record field data) that do did not match across all records. Its not possible to display a uniform set of columns so they are not visible.

  1. Modify the search (date) parameters to only include records with consistent field data.

Service Not Reachable

The Archive Management service is not reachable as configured or is offline for some other reason.

  1. Verify the service port and host are configured correctly here.

...