Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Body:

...

Attributes

Jira
serverIssue Tracker (JIRA)
serverId85506ce4-3cb3-3d91-85ee-f633aaaf4a45
keyODM2DEV-55
:

...

The Include metadata element allows a reference to a prior metadata version.

...

Include Page

...

Include Element
Include Element

Include Page
Include Attributes
Include Attributes

Contained in:

...

A reference to a prior metadata version. This version must be present earlier in the same ODM file or in a previous file in the series. See the PriorFileOID attribute of the ODM element.

When a metadata element such as an ItemDef is re-defined in a MetaDataVersion that includes a previous MetaDataVersion, any metadata element of the same type and with the same OID in a preceding MetaDataVersion is completely replaced. This includes all attributes and child elements. It also means that all attributes and child elements not present in the new definition are effectively deleted from the previous version.

In the following example, question " I.003 " has been added to the ItemGroup " IG.001 " by adding an ItemRef element to the ItemGroupDef. The new version of the ItemGroupDef now contains only one of the Aliases, and the other Alias defined in MetaDataVersion " MDV.001 " has been removed. This same mechanism is used to remove ItemRefs from an ItemGroupDef, or to re-order reorder them.

Example
Code Block
<Study OID="S.001">
  <MetaDataVersion OID="MDV.001" Name="First Metadata version"> 
    <ItemGroupDef OID="IG.001" Name="First ItemGroup"> 
      <ItemRef ItemOID="I.001" Mandatory="Yes" OrderNumber="1"/> 
      <ItemRef ItemOID="I.002" Mandatory="Yes" OrderNumber="2"/> 
      <Alias Context="Context1" Name="IG1"/> 
      <Alias Context="Context2" Name="FIRST"/> 
    </ItemGroupDef> 
  </MetaDataVersion> 
  
  <MetaDataVersion OID="MDV.002" Name="Second Metadata version"> 
    <Include StudyOID="S.001" MetaDataVersionOID="MDV.001"/>
    <ItemGroupDef OID="IG.001" Name="First ItemGroup (modified)"> 
      <ItemRef ItemOID="I.001" Mandatory="Yes" OrderNumber="1"/> 
      <ItemRef ItemOID="I.003" Mandatory="Yes" OrderNumber="2"/> 
      <ItemRef ItemOID="I.002" Mandatory="Yes" OrderNumber="3"/> 
      <Alias Context="Context1" Name="IG1"/> 
    </ItemGroupDef> 
  </MetaDataVersion> 
</Study>

...

titleInclude

Include Page
Include Example
Include Example

Note: The StudyOID attribute allows an Include element to reference a metadata version in another study. Thus, it is possible for many studies to share a set of common metadata definitions. In fact, a study that contains nothing but metadata can serve as a metadata library.

...


Pagenav2