CCB-7: Additional schematron rules to check Target_Identification.Internal_Reference.reference_type

[jordanpadams]

🦄 Sibling SCR

NASA-PDS/PDS4-CCB#7

💡 SCR Summary

Problem Statement

Per NASA-PDS/validate#432 (comment), and the IM Spec definition for reference_type, we are missing a check for bundle_to_target in Product_Bundle references.

Additional Details

As the requested changes only affects Schematron, and since the CCB considers schematron to be "software / code", there CCB should be advised ass a courtesy.

Applicable Components

Information Model
PDS Tools / Validate (possibly)

Proposed Solution

Update Schematron to include these checks.

Requested Changes

Currently, the IM has schematron rules in place for these Products types:
-- Product_Ancillary.Context_Area.Target_Identification.Internal_Reference.reference_type == ancillary_to_target
-- Product_Document.Context_Area.Target_Identification.Internal_Reference.reference_type == document_to_target

Per DDWG vote, the SCR has been extended / re-written to additionally include schematron rules and IM permissible values for these Product types having an xPath == Context_Area.Target_Identification.Internal_Reference.reference_type:

-- Product_Bundle.Context_Area.Target_Identification.Internal_Reference.reference_type == bundle_to_target
-- Product_Collection.Context_Area.Target_Identification.Internal_Reference.reference_type == collection_to_target
-- Product_Observational.Observation_Area.Target_Identification.Internal_Reference.reference_type == data_to_target

Note that <Observation_Area> has a base type of <Context_Area>
-- Product_Browse.Context_Area.Target_Identification.Internal_Reference.reference_type == browse_to_target
-- Product_External.Context_Area.Target_Identification.Internal_Reference.reference_type == external_to_target
-- Product_Native.Context_Area.Target_Identification.Internal_Reference.reference_type == native_to_target
-- Product_SPICE_Kernel.Context_Area.Target_Identification.Internal_Reference.reference_type == data_to_target
-- Product_XML_Schema.Context_Area.Target_Identification.Internal_Reference.reference_type == schema_to_target

Note that the above permissible values must be added to the IM.

Applicable Attachments

1. Schematron to ensure proper validation of above prescribed rules:

CCB-7_ref_type_schematron_20240318.zip

2. Both VALID and FAIL test cases for the prescribed Product types noted above:

CCB-7_reference_type_test_cases_20240318.zip

3. List of proposed reference_type values and associated value_meanings, including both existing values and those that need to be added.

CCB7-permissible-value-value_meanings-20240403.pdf

Impact Statement

Impact:
-- Information Model -- The requested change has moderate impact on the IM. A new schematron rule is being added.

No Impact:
-- Standards Reference
-- Concepts Document
-- APG
-- DPH
-- External Agencies
-- ISO Standards
-- PDS Tools
-- PDS Website
-- PAG

Technical Assessment

The request is to extend schematron validation. This change extends the set of reference types to be validated for relationships between products and target context products. This change request is reasonable.

Added to parent epic?

Will do