You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Looking at the code of xml_builders.R and xml_helpers.R I noticed that there are some assumptions about Define-XML that are non-standard, and not defined in the Define-XML specification.
There is an assumption that a prefix "def" is used for the Define-XML namespace (http://www.cdisc.org/ns/def/v2.1 for Define-XML 2.1). Although recommended as best practice to make it easier for users to understand and implement Define-XML, and to aid in the comparison of documents. In practice, other namespace prefixes can be used—as long as the Define-XML conforms to the rules of XML namespaces.
In several places in the code I see that assumptions are made about conventions for OIDs. For example, OIDs for ItemGroupDef elements can not be assumed to have a structure "IG." and OIDs for variables can not be assumed to have structure "IT.". It is problematic when code makes any assumptions about the convention for OIDs. Trying to extract information, like names, from OIDs will fail when a Define-XML file does not follow an imposed and non-standard OID convention. It will limit the Define-XML files that will be supported by metacore.
From the Define-XML specification: "The value of an OID attribute has no intrinsic meaning. Although some may find convenience in applying a predefined convention for assigning values to aid readability (as illustrated throughout this document), no meaning should be attached to the OID value. The significance of an OID value is simply that it is used to reference an object defined elsewhere, and no additional semantics are implied."
The text was updated successfully, but these errors were encountered:
lexjansen
changed the title
Dependance on non-standard Define-XML conventions
Dependence on non-standard Define-XML conventions
Sep 1, 2023
Looking at the code of xml_builders.R and xml_helpers.R I noticed that there are some assumptions about Define-XML that are non-standard, and not defined in the Define-XML specification.
From the Define-XML specification: "The value of an OID attribute has no intrinsic meaning. Although some may find convenience in applying a predefined convention for assigning values to aid readability (as illustrated throughout this document), no meaning should be attached to the OID value. The significance of an OID value is simply that it is used to reference an object defined elsewhere, and no additional semantics are implied."
The text was updated successfully, but these errors were encountered: