Update USDM report to differentiate between entity definitions and entity references

[ASL-rmarshall]

The Entity Details section of the USDM report (in both JSON and Excel formats) contains a list of "entities" with a count of occurrences. The numbers listed are based on the number of records found in each of the class-based datasets that are created when the USDM data service converts the input USDM JSON data to tabular format. However, the class-based datasets contain both:

• A record representing the definition of each instance of the class (rel_type = "definition"), and
• A record representing any reference (by id) to the instance (rel_type = "reference").

It's not clear from the report that the Entity Details numbers include both definitions and references, so it would be better if the report were updated to make this distinction clear.

[ASL-rmarshall]

A short-term mitigation would be to add a comment to the ReadMe sheet.

May need to consider how to obtain/report the numbers when the report is generated from a different data source (e.g., Excel files during testing).

[OGarcia11]

@ASL-rmarshall what is the priority of this ticket in terms of how confusing could be or affecting the end user?

[BSnoeijerCD]

@OGarcia11 I would not say it has a high prioirty. Although it can cause some confusion for the users it is not altering the CORE validation output.

Personally, I would only report the records with 'definitions' as the reference records are only created in the background during the conversion to tabular format and this whole process is not visible/explained for the user.