Reports View for an asset collection lets you generate various standard reports for it. Custom reports are also possible.

Problems and Suggestions Report

Reports > Problems and Suggestions checks the current content of the asset collection against all of its applicable quality rules (i.e., its shapes and validity constraints they define) and enrichment (suggestions for mapping) rules. A message box shows the rule-processing progress and then shows the report. Note that results of the validation will be reflected in the Dashboard > Completeness and Validity display.

You will be able to limit the scope of checking to only assets of a certain type.

Validity checking also happens every time information about specific resource is update. In this case, validity is checked only for the updated resource. Users can also enable validity checking when they are viewing individual resources in the form. This setting is sticky, it will be remembered and applied across all of asset collections user works with. See the View or Edit documentation for details.

To develop custom extensions to this feature, see EDG Developer Guide > Extending the Problems and Suggestions Reports.

 

View Change History

Click Reports > View Change History to show the audit trail view. For a production copy, this shows all the changes made since it has been created. For a workflow, this shows only changes made within the working copy managed by the workflow.

Clicking the Search button on the Change History screen displays a time-stamped list of the saves made in the Matching Changes panel, and clicking one of those lines displays details about what changes were made as part of that save operation in the Details of Selected Change panel. Below, the change made on July 30th has just been clicked, showing that three values were added and one was deleted as part of the change made with a particular save operation.

If you are logged in as a user who is editor or manager of the vocabulary/asset collection or a workflow where the change was made, then a link Revert this Change will appear in the bottom panel. Click on this link to undo this operation. This will in fact create a new “forward” edit in the change history, with yourself as author. Note that this feature should be used with care, because reverting some steps from the middle of the change history may lead to orphan resources in your model.

If you are logged in as a user who is editor or manager of an asset collection and look at a change performed in a working copy as part of a workflow, then a link Commit this Change to production will appear in the bottom panel. You can click on this link to move the change history entry (in the example above, the three additions and the deletion) out of the workflow copy and into the production copy, essentially cherry-picking which change from a workflow copy you want to accept. As with the Revert feature mentioned above, this feature should be used with care, because committing some steps from the middle of the change history may lead to creating data statements that are disconnected from the rest of the information. For example, when you commit a change that has modified some attribute of a newly created code, then you should also make sure that the change that created the code in the first place has also been committed.

Before you click the Search button, you can narrow the scope of the search by filling out any or all of the fields at the top of the form:

  • Creator. Enter the name of a particular EDG user to only see changes by that user. This field uses typeahead, so that if you have users named “Joe” and “Joan” and only type in “Jo”, these two names will appear in a drop-down list for you to pick from.

     

  • Date. Enter a date in the first date field to see all changes after that date, a date in the second field to see all changes before that date, or in both fields to see the changes within a particular date range. (There’s no need to actually type in the date value; clicking in either field displays a calendar where you can then click on the date you want to enter.)

     

  • Status. Enter “committed” or “uncommitted” to only list changes with one of these status values.

Comparison Report

For a production asset collections, this report lets you compare it with another, user-selected asset collections. For a working copy, it shows differences between a working copy and a production copy. Note that this report only compares information contained directly in the selected collection. It does not compare contents of included asset collections. The report will list each changed asset and properties that were changed, showing the changed values. If a value was added, it is shown in green. If it was deleted, it is shown in pink.

For example, the following shows what happens after the preferred label property for “South Korea” is edited, an alternative label is added, and a “Seoul” is added as a narrower value of the “South Korea” resource (renamed to “Republic of Korea”).

The right hand side of each change contains a link View Change that displays a dialog box with details of the change log entry that caused that particular change. Depending on your permissions, you can revert or commit the change in that dialog box. See View Change History for further information on reverting and committing individual changes.

Property Value Rules

This shows what properties in the collection’s will be inferred through SHACL: sh:defaultValue or sh:values (see Inferring Data with SHACL Property Value Rules for details). The listing is organized by class. Rules for inferred properties are depicted diagrammatically.

Statistics

For any asset collection (production or working copy), Reports > Graph Statistics displays details about the asset collection’s node distribution. The following shows the statistics for the sample Reference Dataset: Country Codes.