Administer Facts

The Administer Facts page allows you to view and, in some cases, edit the fact metadata for an environment. There are a number of filters available on the left and central panels to help get to the facts of interest.

On this page:

Panes, Fields, and Buttons

Panes

Filters Pane: The filters pane allows you to select the point type code that you are interested in. For example, to see electric meters, select Electric Meters from the drop-down list.

Fields

The top section of the Administer Facts page provides filters that can be used to search facts and a button to apply the filters and display the facts. While the drop downs display the possible values to select from, the text boxes have the capability to search based on a given string. If the whole string is unknown, a part of it can be entered with a percentage (%) symbol with as prefix, suffix or both. The following are descriptions of each field:

Fact ID: System-assigned, unique fact identifier.
Fact Type Code: Search for facts that are a specific fact type code.
Time Basis: For facts that are based on a specific period of time.
Fact Category: Search for facts that area specific fact category.
Fact Name: The Name given to the fact when it was added.
Fact Lookup: Secondary description given to the fact when it was added.
Note: This field is case sensitive.
Fact Source: Data or calculation that produced the fact.
Role Type Code: Search for facts associated to a specific role type.
Aggregation Method: Mathematical function used to calculate the fact.
Parent PTC: Point type code associated to a parent object.
Status: Search for facts that are a specific status.

Buttons

Get Facts: Search for facts matching the criteria set in the top sections fields.

Data Table

The data table displays the filtered facts in a tabular format with one row representing one fact. A drop-down on the upper left corner can be used to change the number of facts displayed per page; the default is 50 entries.

Every row has buttons to view, edit, or navigate to the fact audit screen for the fact in that row. The details can also be viewed by clicking the + in front of every row. The selected facts can also be copied to clipboard or saved as CSV or PDF using the buttons on the upper right corner. A search bar can be used to search for any text in the displayed fact table. Table elements include:

ID: System-assigned, unique fact identifier.
Fact Type Code: Search for facts that are a specific fact type code.
Time Basis: Search for facts that are based on a specific period of time.
Fact Category: Search for facts that are a specific fact category.
Fact Name: Name given to the fact when it was added.
Fact Lookup: Secondary description given to the fact when it was added.
Note: This field is case sensitive.
Fact Source: Data or calculation that produced the fact.
Role Type Code: Search for facts associated to a specific role type.
Agg Method (Aggregation Method): Mathematical function used to calculate the fact.
View: Opens the Viewing Fact Information dialog box, which contains the same information as the data table. In addition, it displays the associated Role and Fact Sequence.
Edit: Opens the Manage Fact dialog box, which contains the same information as the data table. In addition, it provides opportunities to update the fact name, aggregation method, and fact status.
Fact Audit: Navigates to the Fact Audit page and displays the current context to provide further information.

View Fact Information

The Administer Facts dialog box is accessed from the View link, which is found in the Administer Facts data table.

Fields

Fact ID: System-assigned, unique fact identifier.
Fact Type Code: Fact type code associated to the fact when it was added.
Time Basis: The period of time that is used to aggregate data in order to calculate the fact.
Fact Category: Category associated to the fact when it was added.
Fact Name: Name that was given to the fact when it was added.
Fact Lookup: Secondary description given to the fact when it was added.
Note: This field is case sensitive.
Fact Source: the data or calculation that produced the fact.
Role: Role type associated with the fact when it was added.
Agg Method(Aggregation Method): Mathematical function used to calculate the fact.
Parent Point Type Code: Point type code associated to a parent object.
Create Time: Date and time when the fact was created.
Update Time: Date and time when the fact was last updated.
Status: Status that was assigned to the fact.

Buttons

Edit: Opens the Manage Facts dialog box.
Cancel: Closes the dialog box.

Manage Fact Information

The Administer Facts dialog box is accessed from the Edit link in the Administer Facts data table, or through the Edit button in the View Fact Information dialog box.

Fields

Fact ID: System-assigned, unique fact identifier.
Fact Type Code: Fact type code associated to the fact when it was added.
Time Basis: The period of time that is used to aggregate data in order to calculate the fact.
Fact Category: Category associated to the fact when it was added.
Fact Name: Review or update the name that was given to the fact when it was added.
Fact Lookup: Secondary description given to the fact when it was added.
Note: This field is case sensitive.
Fact Source: Data or calculation that produced the fact.
Role: Role type associated to the fact when it was added.
Agg Method (Aggregation Method): Review or update the mathematical function used to calculate the fact.
Parent Point Type Code: the point type code associated to a parent object.
Create Time: Date and time when the fact was created.
Update Time: Date and time when the fact was last updated.
Status: Review or update the status that was assigned to the fact.

Buttons

Save: Save any changes that have been made; the button is disabled until a field has been modified
Cancel: Close the dialog box.