Skip to main content

Hyperproof Self-service reporting data model

The data model in the data warehouse contains all of the user-facing Hyperproof business objects and the supporting relationship tables to facilitate associations. Each object is available in the Views catalog within the schema based on your Hyperproof organization name in the HYPERPROOF database. Each object name, and the columns within, use the default capitalization of fully upper case and underscores in place of spaces. Because of the upper case and underscore format, queries on Hyperproof data warehouse objects do require quoted identification.

Business objects

The Hyperproof business objects represented in the data warehouse include:

Note

As we continue to improve and update the data model with new modules, you may need to refresh the data model manually.

  • Access review

  • Assessment

  • Audit

  • Control

  • Evaluation

  • Hypersync

  • Issue

  • Label

  • Program

  • Proof

  • Questionnaire

  • Request

  • Requirement

  • Response

  • Risk

  • Task

  • Test

  • Vendor

Each business object model contains columns for each system attribute, and any applicable custom fields, visible within Hyperproof. The following metadata fields are available for each record:

  • CREATED - UTC timestamp generated when the object was created.

  • CREATOR - Full name of the user who created the object.

  • UPDATED - UTC timestamp generated when the object was created.

  • UPDATER - Full name of the user who last changed the object.

A system-generated unique identifier column is available for aggregating and joining records. The name of the unique identifier column is generated based on the object name, an underscore, and "ID". For example, the unique identifier for the control object is CONTROL_ID.

Note

The ID field created by Hyperproof when a new record is created for a business object is stored in the column named ID.

Relationship objects

Relationship objects are represented by the combination of two business object models, with an underscore. Generally, the parent object is first, and the child object is second. For example, the association between controls and labels is named CONTROL_LABEL in the data warehouse.

Relationship objects are composed of the unique identifier fields of the related objects. For example, CONTROL_LABEL has both CONTROL_ID and LABEL_ID fields that can be used in joins to the Control and Label objects in the data warehouse, respectively. The following metadata fields are available for each record:

  • CREATED - UTC timestamp generated when the link between the two objects was created.

  • CREATOR - Full name of the user who linked the objects.

  • UPDATED - UTC timestamp generated when the link was last changed.

  • UPDATER - Full name of the person who last changed the link.

A system-generated unique identifier column is available for aggregating records. The name of the unique identifier column is generated based on the object name, an underscore, and "ID". For example, the ID for the control to label relationship object is CONTROL_LABEL_ID.

Some Hyperproof relationships contain a third dimension, such as PROGRAM_REQUIREMENT_CONTROL. These objects follow the same structure as standard relationships, with the addition of the unique ID field for the third object.

Some Hyperproof objects contain linkages within the record and do not contain an additional relationship table. For these tables, there are columns for TARGET_OBJECT_TYPE, indicating which business object the table is associated with, and TARGET_OBJECT_ID, which is the unique identifier of the corresponding object. For example, you can query for tasks that are on requests by joining to the Request object using the following query:

select
    t.NAME as TASK,
    t.ASSIGNEE as TASK_ASSIGNEE,
    r.ID as REQUEST_ID,
    r.ASSIGNEE as REQUEST_ASSIGNEE
from TASK t
inner join REQUEST r
    on t.TARGET_OBJECT_TYPE = 'Request'
    and t.TARGET_OBJECT_ID = r.REQUEST_ID

Snapshot objects

Hyperproof captures snapshots of some data displayed in the user interface but not stored. These models can be used for time series reporting of business object attributes captured in the snapshot. Snapshot objects include:

  • RiskSnapshot

Each snapshot contains a DATE field indicating the date the snapshot was captured and the business object attributes captured in the snapshot.

The unique ID of the corresponding record is provided for joining. For example, when using the RISKSNAPSHOT object, you can use the RISK_ID field to join to the Risk object in the data warehouse. Joining allows you to access additional Risk attributes not captured in the snapshot.

Limitations

The following fields have not been implemented yet in the data model.

Vendor

  • Health

  • Tolerance

Program

  • Health

Task

  • Repeats

SPRS scoring

If you have added a program that uses SPRS scoring, such as NIST 800-171 or CMMC 2.0 Level 2 and 3, the associated requirement statuses are stored in the database as the Hyperproof statuses not the SPRS statuses. SPRS statuses are mapped to Hyperproof statuses in the user interface to facilitate scoring and displaying statistics on the program dashboard. Status mappings are as follows:

SPRS status

Hyperproof status

Not Implemented

Not started

Partially implemented

In Progress

Implemented

Completed

Not applicable

Not applicable

For more information, see SPRS statuses.