An ItemGroupDef describes a type of variable or field grouping that can occur within a study.
ODM v2.0 introduces nested ItemGroups. ItemGroupRef elements may be added to ItemGroupDef to create hierarchical data structures of arbitrary depth. Nested ItemGroupDefs can be used for enhanced re-usability of ItemGroups. They can also be used to represent semantic relationships between items, items that share common behaviors such as skip logic, or items that are displayed or collected together.
The Coding child element allows to associate semantics within the group. For example, a LOINC panel code in the case that the ItemGroup represents a laboratory panel.
The WorkflowRef child element allows to reference a workflow definition (WorkflowDef) for navigation within the ItemGroup, for example, when the ItemGroup represents a form or questionnaire (or part of it) where there is a workflow between the items or groups of items.
Element Name | ItemGroupDef |
---|---|
Parent Elements | MetaDataVersion |
Element XPath(s) | /ODM/Study/MetaDataVersion/ItemGroupDef |
Element Textual Value | None |
Attributes | OID, Name, Repeating, IsReferenceData, Structure, ArchiveLocationID, DatasetName, Domain, Type, Purpose, StandardOID, IsNonStandard, HasNoData, CommentOID |
Child Elements | (Description?, Class?, (ItemGroupRef?, ItemRef?)+, Coding*, WorkflowRef?, Origin*, Alias*, Leaf?) |
Usage/Business Rules |
|
Attribute | Schema Datatype or Enumeration | Usage | Definition | Business Rule(s) |
---|---|---|---|---|
OID | oid | Required | Unique identifier for the ItemGroupDef element. |
|
Name | name | Required | Human readable name for the ItemGroupDef. |
|
Repeating | (No | Simple | Dynamic | Static) | Required | The Repeating attribute indicates that the ItemGroup may occur repeatedly within the containing element. Simple - the ItemGroup repeats within the containing element and is not bound in any way. Note: It is equivalent to the ODM v1.3.2 case where Repeating="Yes". Dynamic - ItemGroupData repeats based on values in a codelist. There may be multiple occurrences for some codelist items. Static - ItemGroupData repeats based on values in a codelist. Only one occurrence may happen for each codelist item. |
|
RepeatingLimit | positiveInteger | Optional | Maximum number of repeats. |
|
IsReferenceData | (Yes | No) | Optional | Specifies whether this ItemGroupDef is used for non-subject data. |
|
Structure | text | Optional | Description of the level of detail represented by individual records in the ItemGroup | |
ArchiveLocationID | oidref | Optional | Reference to the unique ID of a leaf element that provides the actual location and file name of the data file. |
|
DatasetName | name | Optional | Name of a file containing the ItemGroupData for this ItemGroupDef. The name applies to the object itself rather then providing a mapping to a different object. |
|
Domain | text | Optional | Identifies the scope or CDISC SDTMIG/SENDIG Domain of the ItemGroup data. The domain applies to the object itself rather then providing a mapping to a different object. |
|
Type | (Form | Section | Dataset | Concept) | Required | identifies the type of data structure the ItemGroup represents. Form - a CRF for data collection. Note, ItemGroupDef Type="Form" replaces the ODM v1.x FormDef element. Section - a section within a CRF. Dataset - tabulation, analysis or operational datasets. Concept - defines a biomedical concept. |
|
Purpose | text | Optional | Purpose of the ItemGroup. |
|
StandardOID | oidref | Optional | Reference to a Standard element. |
|
IsNonStandard | Yes | Conditional | Required for ADaM, SDTM, or SEND if StandardOID is not provided. |
|
HasNoData | Yes | Optional | Used to indicate that an ItemGroupDef has no data. May be used at sponsor's discretion or if required by a regulatory authority |
|
CommentOID | oidref | Optional | Reference to a CommentDef with sponsor provided information related to this ItemGroupDef. It allows annotations to the ItemGroup. |
|
ODM-62 - Getting issue details... STATUS