Define-JSON
Data model for supply and demand data contracts to complement CDISC USDM, ODM, and Dataset-JSON. This LinkML version includes semantics to act as Rosetta Stone for SDMX, FHIR, OMOP, RDF, and CDISC.
URI: https://cdisc.org/define-json
Name: Define-JSON
Schema Diagram
erDiagram
MetaDataVersion {
stringList resources
string fileOID
datetime asOfDateTime
datetime creationDateTime
string odmVersion
string fileType
string originator
string sourceSystem
string sourceSystemVersion
string context
string defineVersion
string studyOID
string studyName
string studyDescription
string protocolName
string OID
string uuid
string name
string description
string label
stringList aliases
boolean mandatory
string purpose
datetime lastUpdated
string owner
string wasDerivedFrom
}
Comment {
string text
string OID
string uuid
string name
string description
string label
stringList aliases
}
Coding {
string code
string decode
string codeSystem
string codeSystemVersion
AliasPredicate aliasType
}
DocumentReference {
string title
string leafID
integerList pages
string relationship
string version
string href
string OID
string uuid
string name
string description
string label
stringList aliases
}
DataProduct {
string dataProductOwner
string domain
DataProductLifecycleStatus lifecycleStatus
stringList hasPolicy
string version
string href
string OID
string uuid
string name
string description
string label
stringList aliases
boolean mandatory
string purpose
datetime lastUpdated
string owner
string wasDerivedFrom
}
Dataset {
string publishedBy
stringList keys
string datasetType
string conformsTo
stringList hasPolicy
string informationSensitivityClassification
string version
string href
stringList profile
string authenticator
string action
string reportingBegin
string reportingEnd
string dataExtractionDate
string validFrom
string validTo
string publicationYear
string publicationPeriod
string OID
string uuid
string name
string description
string label
stringList aliases
}
Timing {
TimingType type
boolean isNominal
string value
datetime windowLower
datetime windowUpper
boolean recalled
string frequency
string OID
string uuid
string name
string description
string label
stringList aliases
}
Method {
MethodType type
string OID
string uuid
string name
string description
string label
stringList aliases
boolean mandatory
string purpose
datetime lastUpdated
string owner
string wasDerivedFrom
}
FormalExpression {
string context
string expression
string returnType
string OID
string uuid
string name
string description
string label
stringList aliases
}
Resource {
string resourceType
string attribute
string version
string href
string OID
string uuid
string name
string description
string label
stringList aliases
}
ReturnValue {
DataType dataType
stringList valueList
string OID
string uuid
string name
string description
string label
stringList aliases
}
Parameter {
DataType dataType
string value
stringList items
string OID
string uuid
string name
string description
string label
stringList aliases
}
ConceptProperty {
integer minOccurs
integer maxOccurs
string OID
string uuid
string name
string description
string label
stringList aliases
boolean mandatory
string purpose
datetime lastUpdated
string owner
string wasDerivedFrom
}
CodeList {
DataType dataType
string formatName
string version
string href
string OID
string uuid
string name
string description
string label
stringList aliases
boolean mandatory
string purpose
datetime lastUpdated
string owner
string wasDerivedFrom
}
CodeListItem {
string codedValue
string decode
string description
stringList aliases
decimal weight
boolean other
}
NominalOccurrence {
string event
string OID
string uuid
string name
string description
string label
stringList aliases
boolean mandatory
string purpose
datetime lastUpdated
string owner
string wasDerivedFrom
}
Condition {
string implementsCondition
LogicalOperator operator
string OID
string uuid
string name
string description
string label
stringList aliases
boolean mandatory
string purpose
datetime lastUpdated
string owner
string wasDerivedFrom
}
RangeCheck {
Comparator comparator
stringList checkValues
string item
SoftHard softHard
LogicalOperator operator
}
Distribution {
string conformsTo
string format
}
DataService {
string protocol
string securitySchemaType
string resourceType
string attribute
string version
string href
string OID
string uuid
string name
string description
string label
stringList aliases
}
DataStructureDefinition {
boolean evolvingStructure
string domain
string structure
boolean isReferenceData
ItemGroupType type
stringList children
stringList profile
string authenticator
string OID
string uuid
string name
string description
string label
stringList aliases
boolean mandatory
string purpose
datetime lastUpdated
string owner
string wasDerivedFrom
string version
string href
}
WhereClause {
string OID
string uuid
string name
string description
string label
stringList aliases
}
ReifiedConcept {
string version
string href
string OID
string uuid
string name
string description
string label
stringList aliases
boolean mandatory
string purpose
datetime lastUpdated
string owner
string wasDerivedFrom
}
Item {
DataType dataType
integer length
string role
boolean hasNoData
string crfCompletionInstructions
string cdiscNotes
string implementationNotes
string preSpecifiedValue
integer decimalDigits
string displayFormat
integer significantDigits
string OID
string uuid
string name
string description
string label
stringList aliases
boolean mandatory
string purpose
datetime lastUpdated
string owner
string wasDerivedFrom
}
Origin {
OriginType type
OriginSource source
}
SourceItem {
stringList resource
}
ComponentList {
stringList components
string OID
string uuid
string name
string description
string label
stringList aliases
}
DataAttribute {
string role
string OID
string uuid
string name
string description
string label
stringList aliases
boolean mandatory
string purpose
datetime lastUpdated
string owner
string wasDerivedFrom
}
Measure {
string role
string OID
string uuid
string name
string description
string label
stringList aliases
boolean mandatory
string purpose
datetime lastUpdated
string owner
string wasDerivedFrom
}
Dimension {
integer keySequence
string role
string OID
string uuid
string name
string description
string label
stringList aliases
boolean mandatory
string purpose
datetime lastUpdated
string owner
string wasDerivedFrom
}
Dataflow {
string version
string href
string OID
string uuid
string name
string description
string label
stringList aliases
boolean mandatory
string purpose
datetime lastUpdated
string owner
string wasDerivedFrom
}
Standard {
StandardName name
StandardType type
PublishingSet publishingSet
string version
StandardStatus status
string OID
string uuid
string description
string label
stringList aliases
}
Dictionary {
string publishedBy
string OID
string uuid
string name
string description
string label
stringList aliases
}
Relationship {
PredicateTermEnum predicateTerm
LinkingPhraseEnum linkingPhrase
string OID
string uuid
string name
string description
string label
stringList aliases
}
IdentifiableElement {
string OID
string uuid
string name
string description
string label
stringList aliases
}
ItemGroup {
string domain
string structure
boolean isReferenceData
ItemGroupType type
stringList children
stringList profile
string authenticator
string OID
string uuid
string name
string description
string label
stringList aliases
boolean mandatory
string purpose
datetime lastUpdated
string owner
string wasDerivedFrom
string version
string href
}
MetaDataVersion ||--}o ItemGroup : "itemGroups"
MetaDataVersion ||--}o Item : "items"
MetaDataVersion ||--}o Condition : "conditions"
MetaDataVersion ||--}o WhereClause : "whereClauses"
MetaDataVersion ||--}o Method : "methods"
MetaDataVersion ||--}o CodeList : "codeLists"
MetaDataVersion ||--}o Coding : "codings"
MetaDataVersion ||--}o ReifiedConcept : "concepts"
MetaDataVersion ||--}o Relationship : "relationships"
MetaDataVersion ||--}o Dictionary : "dictionaries"
MetaDataVersion ||--}o Standard : "standards"
MetaDataVersion ||--}o DocumentReference : "annotatedCRFs"
MetaDataVersion ||--}o DataProduct : "dataProducts"
MetaDataVersion ||--}o Coding : "coding"
MetaDataVersion ||--}o Comment : "comments"
MetaDataVersion ||--}o Comment : "siteOrSponsorComments"
Comment ||--}o DocumentReference : "documents"
Comment ||--}o Coding : "coding"
DocumentReference ||--}o Coding : "coding"
DataProduct ||--}o DataService : "inputPort"
DataProduct ||--}o DataService : "outputPort"
DataProduct ||--}o Dataset : "inputDataset"
DataProduct ||--}o Dataset : "outputDataset"
DataProduct ||--}o Coding : "coding"
DataProduct ||--}o Comment : "comments"
DataProduct ||--}o Comment : "siteOrSponsorComments"
Dataset ||--|o Dataflow : "describedBy"
Dataset ||--|o DataStructureDefinition : "structuredBy"
Dataset ||--}o Distribution : "distribution"
Dataset ||--}o Coding : "security"
Dataset ||--|o Timing : "validityPeriod"
Dataset ||--}o Coding : "coding"
Timing ||--|o NominalOccurrence : "relativeTo"
Timing ||--|o NominalOccurrence : "relativeFrom"
Timing ||--|o Method : "imputation"
Timing ||--}o Coding : "coding"
Method ||--}o FormalExpression : "formalExpressions"
Method ||--|o DocumentReference : "document"
Method ||--}o Coding : "coding"
Method ||--}o Comment : "comments"
Method ||--}o Comment : "siteOrSponsorComments"
FormalExpression ||--}o Parameter : "parameters"
FormalExpression ||--|o ReturnValue : "returnValue"
FormalExpression ||--}o Resource : "externalCodeLibs"
FormalExpression ||--}o Coding : "coding"
Resource ||--}o FormalExpression : "selection"
Resource ||--}o Coding : "coding"
ReturnValue ||--}o Coding : "coding"
Parameter ||--}o CodeList : "codeList"
Parameter ||--}o ConceptProperty : "conceptProperty"
Parameter ||--}o Coding : "coding"
ConceptProperty ||--|o CodeList : "codeList"
ConceptProperty ||--}o Coding : "coding"
ConceptProperty ||--}o Comment : "comments"
ConceptProperty ||--}o Comment : "siteOrSponsorComments"
CodeList ||--}o CodeListItem : "codeListItems"
CodeList ||--|o Resource : "externalCodeList"
CodeList ||--}o Coding : "coding"
CodeList ||--}o Comment : "comments"
CodeList ||--}o Comment : "siteOrSponsorComments"
CodeListItem ||--|o Coding : "coding"
NominalOccurrence ||--|| Timing : "timing"
NominalOccurrence ||--}o Condition : "condition"
NominalOccurrence ||--}o Coding : "coding"
NominalOccurrence ||--}o Comment : "comments"
NominalOccurrence ||--}o Comment : "siteOrSponsorComments"
Condition ||--}o RangeCheck : "rangeChecks"
Condition ||--}o FormalExpression : "formalExpression"
Condition ||--}o Condition : "conditions"
Condition ||--}o Coding : "coding"
Condition ||--}o Comment : "comments"
Condition ||--}o Comment : "siteOrSponsorComments"
RangeCheck ||--}o FormalExpression : "formalExpression"
Distribution ||--|o DataService : "accessService"
Distribution ||--|o Dataset : "isDistributionOf"
DataService ||--|o Distribution : "isAccessServiceOf"
DataService ||--}o FormalExpression : "selection"
DataService ||--}o Coding : "coding"
DataStructureDefinition ||--}o Dimension : "dimensions"
DataStructureDefinition ||--}o Measure : "measures"
DataStructureDefinition ||--}o DataAttribute : "attributes"
DataStructureDefinition ||--|o ComponentList : "grouping"
DataStructureDefinition ||--}o Item : "items"
DataStructureDefinition ||--|o ReifiedConcept : "implementsConcept"
DataStructureDefinition ||--}o WhereClause : "whereClauses"
DataStructureDefinition ||--}o Coding : "security"
DataStructureDefinition ||--|o Timing : "validityPeriod"
DataStructureDefinition ||--}o Coding : "coding"
DataStructureDefinition ||--}o Comment : "comments"
DataStructureDefinition ||--}o Comment : "siteOrSponsorComments"
WhereClause ||--}o Condition : "conditions"
WhereClause ||--}o Coding : "coding"
ReifiedConcept ||--}o ConceptProperty : "properties"
ReifiedConcept ||--}o Coding : "coding"
ReifiedConcept ||--}o Comment : "comments"
ReifiedConcept ||--}o Comment : "siteOrSponsorComments"
Item ||--|o CodeList : "codeList"
Item ||--|o Method : "method"
Item ||--}o RangeCheck : "rangeChecks"
Item ||--}o WhereClause : "whereClauses"
Item ||--|o Origin : "origin"
Item ||--|o ConceptProperty : "conceptProperty"
Item ||--|o CodeList : "roleCodeList"
Item ||--|o Condition : "collectionExceptionCondition"
Item ||--}o Coding : "coding"
Item ||--}o Comment : "comments"
Item ||--}o Comment : "siteOrSponsorComments"
Origin ||--}o SourceItem : "sourceItems"
Origin ||--|o DocumentReference : "document"
SourceItem ||--|o Item : "item"
SourceItem ||--|o DocumentReference : "document"
SourceItem ||--}o Coding : "coding"
ComponentList ||--}o Coding : "coding"
DataAttribute ||--|| Item : "item"
DataAttribute ||--|o Method : "missingHandling"
DataAttribute ||--|o Method : "imputation"
DataAttribute ||--}o Coding : "coding"
DataAttribute ||--}o Comment : "comments"
DataAttribute ||--}o Comment : "siteOrSponsorComments"
Measure ||--|| Item : "item"
Measure ||--|o Method : "missingHandling"
Measure ||--|o Method : "imputation"
Measure ||--}o Coding : "coding"
Measure ||--}o Comment : "comments"
Measure ||--}o Comment : "siteOrSponsorComments"
Dimension ||--|| Item : "item"
Dimension ||--|o Method : "missingHandling"
Dimension ||--|o Method : "imputation"
Dimension ||--}o Coding : "coding"
Dimension ||--}o Comment : "comments"
Dimension ||--}o Comment : "siteOrSponsorComments"
Dataflow ||--|| DataStructureDefinition : "structure"
Dataflow ||--}o Dimension : "dimensionConstraint"
Dataflow ||--}o Coding : "coding"
Dataflow ||--}o Comment : "comments"
Dataflow ||--}o Comment : "siteOrSponsorComments"
Standard ||--}o Coding : "coding"
Dictionary ||--}o Coding : "terms"
Dictionary ||--}o Coding : "coding"
Relationship ||--|| IdentifiableElement : "subject"
Relationship ||--|| IdentifiableElement : "object"
Relationship ||--}o Coding : "coding"
IdentifiableElement ||--}o Coding : "coding"
ItemGroup ||--}o Item : "items"
ItemGroup ||--|o ReifiedConcept : "implementsConcept"
ItemGroup ||--}o WhereClause : "whereClauses"
ItemGroup ||--}o Coding : "security"
ItemGroup ||--|o Timing : "validityPeriod"
ItemGroup ||--}o Coding : "coding"
ItemGroup ||--}o Comment : "comments"
ItemGroup ||--}o Comment : "siteOrSponsorComments"
Classes
Class | Description |
---|---|
CodeListItem | A structured member of a CodeList that extends the Coding class with additional context-specific properties |
Coding | A semantic reference that provides standardized codes and their meanings from controlled vocabularies |
DataflowRelationship | A relationship element that associates a DataAttribute with a Dataflow, reported at the Dataset level |
DatasetKey | An abstract identifier that comprises the cross-product of dimension values to identify a specific cross-section |
GroupKey | A dimension subset that represents collections of dimensions that are subsets of the full dimension set, distinct from SeriesKey which includes Time dimensions |
SeriesKey | A unique identifier that comprises the cross-product of dimension values including Time to identify observations, representing dimensions shared by all observations in a conceptual series |
DimensionRelationship | A relationship element that associates a DataAttribute with a specific Dimension at a specific level |
Distribution | A technical representation that provides a specific format or access method for a dataset |
Formatted | A mixin that provides slots for reporting, exchange, or storage formatting |
Governed | A mixin that provides slots for audit trail and standards governance, including mandatory status, comments, and attribution |
GovernedElement | |
CodeList | A value set that defines a discrete collection of permissible values for an item, corresponding to the ODM CodeList construct |
ConceptProperty | A reified property concept that exists within the context of its containing topic concept |
Condition | A reusable, composable, and nestable logical construct allowing for complex expressions. Conditions are most useful when given a meaningful name and linked to Study Definitions. |
CubeComponent | An abstract data field that represents a component in a data structure definition, referencing an Item for its definition |
DataAttribute | A data cube property that describes additional characteristics or metadata about observations |
Dimension | A data cube property that describes a categorical or hierarchical dimension |
Measure | A data cube property that describes a measurable quantity or value |
Dataflow | An abstract representation that defines data provision for different reference periods, where a Distribution and its Dataset are instances |
DataProduct | A governed collection that represents a purpose-driven assembly of datasets and services with an owning team and lifecycle |
Item | A data element that represents a specific piece of information within a defined context, with data type, constraints, and derivation methods |
ItemGroup | A collection element that groups related items or subgroups within a specific context, used for tables, FHIR resource profiles, biomedical concept specializations, or form sections |
DataStructureDefinition | A structural element that defines the organization of a data cube for analysis, including dimensions, attributes, and measures |
MetaDataVersion | A container element that represents a given version of a specification, linking to a particular usage context such as a study, dataset, or data collection instrument. |
Method | A reusable computational procedure that describes how to derive values and can be referenced by Items |
NominalOccurrence | An event element that represents occurrences such as planned or unplanned encounters or adverse events |
ProvisionAgreement | An agreement element that describes the contractual relationship between a Data Provider and a Data Consumer regarding data provision |
ReifiedConcept | A canonical information layer that makes abstract concepts explicit and referenceable, showing how different data implementations represent the same underlying meanings through a star schema structure with multiple properties |
SiteOrSponsorComment | A feedback element that contains comments from a site or sponsor, distinct from the general Comment class |
GroupRelationship | A relationship element that associates a DataAttribute with a set of Dimensions, used when attribute values vary based on all group dimension values |
Identifiable | A mixin that provides slots for making an entity addressable within a study or context |
IdentifiableElement | |
Comment | A descriptive element that contains explanatory text provided by a data or metadata handler |
ComponentList | An abstract definition that specifies a list of components within a data structure definition, including various descriptor types |
Dataset | A collection element that groups observations sharing the same dimensionality, expressed as a set of unique dimensions within a Data Product context |
Dictionary | A dictionary that defines a set of codes and their meanings |
DocumentReference | A comprehensive reference element that points to an external document, combining elements from ODM and FHIR |
FormalExpression | A computational element that defines the execution of a data derivation within a specific context |
Organization | An entity that represents organizational information, such as a site or sponsor |
DataProvider | An organization element that provides data to a Data Consumer, which can be a sponsor, site, or any other entity that supplies data |
Parameter | A variable element that describes an input used in a formal expression |
Relationship | A semantic link that defines connections between elements such as Items or ItemGroups, capturing relationships like "is the unit for" or "assesses seriousness of" |
Resource | An external reference that serves as the source for a Dataset, ItemGroup, or Item |
DataService | A service element that provides an API or endpoint for serving or receiving data |
ReturnValue | An output specification that defines the details of what a formal expression returns |
Standard | A collection element that groups related standards within a specific context, used for defining CDISC implementation guides and controlled terminologies |
Timing | A temporal element that describes the timing of an event or occurrence, which can be absolute, relative, or nominal |
User | An entity that represents information about a specific user of a clinical data collection or data management system |
WhereClause | A conditional element that describes the circumstances under which a containing context applies, linking conditions to structures where they are used |
IsODMItem | A mixin that provides additional attributes for CDISC Operational Data Model items, including roles, completion instructions, and implementation notes |
IsProfile | A mixin that provides additional metadata for FHIR resources and Data Products, including profiles, security tags, and validity periods |
IsSdmxDataset | A mixin that provides additional metadata specific to SDMX Datasets |
Labelled | A mixin that provides slots for detailing meanings and multilingual descriptions |
MeasureRelationship | A relationship element that associates a DataAttribute with a Measure |
ObservationRelationship | A relationship element that associates a DataAttribute with an Observation, allowing value-level Items to be reused across multiple different Views |
ODMFileMetadata | A mixin that provides ODM file-level metadata attributes including file identifiers, timestamps, and system information |
Origin | A provenance element that describes the source of data for an item |
RangeCheck | A validation element that performs a simple comparison check between a referenced item's value and specified values, resolving to a boolean result |
SourceItem | A data source that provides the origin of information for an item |
StudyMetadata | A mixin that provides study-level metadata attributes including study identification and protocol information |
TranslatedText | |
Translation | A text representation that provides content in a specific language, used for multilingual support |
Versioned | A mixin that provides version and connectivity information, including version numbers and resource references |
Slots
Slot | Description |
---|---|
OID | Local identifier within this study/context. Use CDISC OID format for regulatory submissions, or simple strings for internal use. |
uuid | Universal unique identifier |
mandatory | Is this element required? |
comments | Comment on the element, such as a rationale for its inclusion or exclusion |
siteOrSponsorComments | Comment on the element, such as a rationale for its inclusion or exclusion |
purpose | Purpose or rationale for this data element |
lastUpdated | When the resource was last updated |
owner | Party responsible for this element |
wasDerivedFrom | Reference to another item that this item implements or extends, e.g. a template Item definition. |
name | Short name or identifier, used for field names |
description | Detailed description, shown in tooltips |
coding | Semantic tags for this element |
label | Human-readable label, shown in UIs |
aliases | Alternative name or identifier |
decimalDigits | For decimal values, the number of digits after the decimal point |
displayFormat | A display format for the item |
significantDigits | For numeric values, the number of significant digits |
version | The version of the external resources |
href | Machine-readable instructions to obtain the resource e.g. FHIR path, URL |
profile | Profiles this resource claims to conform to |
security | Security tags applied to this resource |
authenticator | Who/what authenticated the resource |
validityPeriod | Time period during which the resouce is valid |
role | Identifies the role of the item within the containing context, taken from the roleCodeList |
roleCodeList | Reference to the CodeList that defines the roles for this item |
hasNoData | Set to Yes if this is a manifest and there is no data for this item |
crfCompletionInstructions | CRFCompletionInstructions reference: Instructions for the clinical site on how to enter collected information on the CRF |
cdiscNotes | CDISCNotes reference: Explanatory text for the variable |
implementationNotes | ImplementationNotes reference: Further information, such as rationale and implementation instructions, on how to implement the CRF data collection fields |
collectionExceptionCondition | Condition that defines when collection may be exempted |
preSpecifiedValue | Prefill value or a default value for a field that is automatically populated. |
fileOID | Unique identifier for the ODM file |
asOfDateTime | Date and time when the data snapshot was taken |
creationDateTime | Date and time when the ODM file was created |
odmVersion | Version of the ODM standard used |
fileType | Type of ODM file (e.g., Snapshot, Transactional) |
originator | Organization or system that created the ODM file |
sourceSystem | Source system that generated the data |
sourceSystemVersion | Version of the source system |
context | Define-XML context (usually "Other" for Define-XML) |
defineVersion | Version of Define-XML specification used |
studyOID | Unique identifier for the study |
studyName | Name of the study |
studyDescription | Description of the study |
protocolName | Protocol name for the study |
itemGroups | Item groups, containing items, defined in this version of the metadata |
items | Template or top-level items (not belonging to any item group) defined in this version of the metadata |
resources | References to documents that describe this version of the metadata. |
conditions | Logical conditions that apply to this version of the metadata. |
whereClauses | Data contexts that apply to this version of the metadata. |
methods | Methods defined in this version of the metadata. |
codeLists | Code lists defined in this version of the metadata. |
codings | Codings defined in this version of the metadata |
concepts | Structured Concepts defined in this version of the metadata |
relationships | Relationships between items, item groups, and other elements in this version of the metadata. |
dictionaries | Dictionaries defined in this version of the metadata |
standards | Standards defined in this version of the metadata |
annotatedCRFs | Reference to annotated case report forms |
dataProducts | Indexed data flows with clear ownership |
dataType | The data type of the item. |
length | The maximum length of the data item in characters. |
codeList | Reference to the CodeList that constrains the item values. |
method | Reference to the Method element that describes how to derive this item's value. |
rangeChecks | Range checks applied to this item (e.g. edit checks, CORE rules) |
origin | The origin of the data |
conceptProperty | Reference to a abstract concept property that this item is a specialization / instance of. |
domain | Domain abbreviation for the dataset. |
structure | Data structure of the item group, indicating how the records are organized. If this is a FHIR Resource, is it nested or flattened? If this is a structured concept, is it a Biomedical/Derivation/Analysis concept? |
isReferenceData | Set to Yes if this is a reference item group. |
type | Type of item group |
children | References to child ItemGroups (OIDs) within this item group. Use these OID references to look up the actual ItemGroup objects from the top-level itemGroups collection. |
implementsConcept | Reference to a abstract concept topic that this item group is a specialization of |
subject | The starting element of the relationship (e.g., an Item or ItemGroup). |
object | The ending element of the relationship. |
predicateTerm | Short variable relationship linking phrase for programming purposes. |
linkingPhrase | Variable relationship descriptive linking phrase. |
language | The language of the translation |
value | The translated text |
translations | |
formatName | Name of a standard format definition |
codeListItems | The individual values that make up this CodeList. The type of CodeListItem included determines its behaviour |
externalCodeList | Reference to a code list that is defined externally to this study |
codedValue | The value of the CodeListItem before decoding |
decode | The decoded value of the CodeListItem |
weight | Numeric significance of the code (e.g., for scoring) |
other | Flag to indicate that the term represents "other" content |
text | The comment text. |
documents | References to documents that contain or are referenced by this comment |
code | The code value |
codeSystem | The code system identifier |
codeSystemVersion | The code system version |
aliasType | How this coding is related in the context of its parent element |
terms | Terms in this dictionary - leave this empty in most cases to keep the file small |
publishedBy | Associates the Data Provider that reports/publishes the data. |
properties | Properties of the reified object, which can be other governed elements or simple values |
minOccurs | Minimum number of occurrences of this property in the context. Set to >0 to mandate some number of occurrences |
maxOccurs | Maximum number of occurrences of this property in the context. Leave empty for unbounded. Set to 0 to disable property |
implementsCondition | Reference to a external (e.g. USDM) condition definition that this implements |
formalExpression | Logical expression, resolving to a boolean, that implements this condition in a specific context |
operator | Logical operator for combining child conditions or range checks. Defaults to ALL if not specified. |
comparator | The type of comparison to be performed |
checkValues | Values to compare against |
item | Reference to the Item element whose value is being checked. If not specified, check applies to the enclosing context |
softHard | Indicates whether a validation check is an error ("Hard") or a warning ("Soft") |
expression | The actual text of the formal expression (renamed from 'code' for disambiguation). |
returnType | Return type of the expression |
parameters | Parameters used in the expression |
returnValue | Return value details |
externalCodeLibs | External code libraries referenced |
formalExpressions | Formal expressions used by this method |
document | Reference to a document that describes this method in detail. |
resource | Path to a resource (e.g. File, FHIR datasource) that is the source of this item |
valueList | A list of possible return values. |
source | The source of the data, such as Investigator, Sponsor, Subject, or Vendor. |
sourceItems | Source items for this origin |
sourceType | who made the comment, such as Investigator, Sponsor. |
userType | User's role in the study. |
userName | The username of the user. |
fullName | The full name of the user. |
organization | The organization the user belongs to. |
location | The physical location of the organization. |
address | The address of the organization. |
partOfOrganization | Reference to a parent organization if this organization is part of a larger entity. |
publishingSet | Publishing Set of a Controlled Terminology |
status | Status of an Implementation Guide or of a Controlled Terminology |
resourceType | Type of resource (e.g., "ODM", "HL7-FHIR", "HL7-CDA", "HL7-v2", "OpenEHR-extract") |
attribute | Field provided by the Name attribute where the data or information can be obtained. Examples are "valueQuantity.value" or "valueQuantity.unit". |
selection | Machine-executable instructions for selecting data from the resource. |
title | Document title |
leafID | Leaf identifier for document reference in Define-XML |
pages | Reference to specific pages in a PDF document |
relationship | Relationship to the referencing entity |
isNominal | Indicates whether the timing is nominal (event-based) or not. |
relativeTo | Reference to the event or occurrence that this timing is relative to. |
relativeFrom | Reference to the event or occurrence that this timing is relative to. |
windowLower | Start date/time of the timing |
windowUpper | End date/time of the timing |
recalled | Indicates whether the timing is recalled or not (recalled timings are less reliable). |
frequency | Frequency. Use dose frequency terminology e.g. "BID" if applicable. |
imputation | The imputation method used for the Timing. |
timing | A named event reference, that can nest further named timing references. |
event | The ID of the event in a Schedule. |
condition | A condition that must be met for this occurrence to be valid. |
dimensions | |
measures | |
attributes | |
grouping | An association to a set of metadata concepts that have an identified structural role in a Data Structure Definition. |
evolvingStructure | |
dimensionConstraint | |
action | Defines the action to be taken by the recipient system (information, append, replace, delete) |
reportingBegin | A specific time period in a known system of time periods that identifies the start period of a report. |
reportingEnd | A specific time period in a known system of time periods that identifies the end period of a report. |
dataExtractionDate | A specific time period that identifies the date and time that the data are extracted from a data source. |
validFrom | Indicates the inclusive start time indicating the validity of the information in the data set. |
validTo | Indicates the inclusive end time indicating the validity of the information in the data set. |
publicationYear | Specifies the year of publication of the data or metadata in terms of whatever provisioning agreements might be in force. |
publicationPeriod | Specifies the period of publication of the data or metadata in terms of whatever provisioning agreements might be in force. |
describedBy | Associates a Dataflow and thereby a Data Structure Definition to the data set. |
structuredBy | Associates the Data Structure Definition that defines the structure of the Data Set. Note that the Data Structure Definition is the same as that associated (non-mandatory) to the Dataflow. |
keys | Series and Group keys in the data that are associated with dimensions in this structure |
datasetType | Type or classification of the dataset |
distribution | Representations of this dataset in various formats or access methods |
conformsTo | Specification or standard that this dataset conforms to |
hasPolicy | Access or usage policy applied to this dataset |
informationSensitivityClassification | Classification of the dataset's sensitivity or confidentiality |
keyValues | List of Key Values that comprise each key, separated by a dot e.g. SUBJ001.VISIT2.BMI |
attributeValues | Association to the Attribute Values relating to Key |
missingHandling | The method for handling missing values in the measure property |
keySequence | |
components | The components that make up this component list |
measure | |
dataFlow | |
groupKey | Set of dimensions that this definition depends on |
dataProductOwner | The person or team accountable for this data product |
lifecycleStatus | Current lifecycle status of the data product |
inputPort | Services that provide input into this data product |
outputPort | Services that expose output from this data product |
inputDataset | Source datasets used by the data product |
outputDataset | Output datasets produced by the data product |
accessService | Service that provides access to this distribution |
isDistributionOf | Dataset this distribution represents |
format | File format or serialization used in the distribution |
isAccessServiceOf | Distribution(s) for which this service provides access |
protocol | Protocol used by the service (e.g., HTTPS, FTP) |
securitySchemaType | Security or authentication method used (e.g., OAuth2) |
providesDataFor | The Dataflows that this provider supplies data for |
provisionAgreements | The ProvisionAgreements that this provider has with Data Consumers |
provider | The Data Provider that is part of this agreement |
Enumerations
Enumeration | Description |
---|---|
AliasPredicate | An enumeration that defines permissible values for the relationship between an element and its alias |
Comparator | An enumeration that defines the types of comparison operations available for a RangeCheck |
UserType | An enumeration that defines the types of users in a clinical data collection or management system |
OrganizationType | An enumeration that defines the types of organizations involved in clinical research |
SoftHard | An enumeration that indicates whether a validation check should be treated as an error or a warning |
MethodType | An enumeration that defines the types of computational methods available for data processing |
DataType | An enumeration that defines the fundamental data types available for items |
OriginType | An enumeration that defines the types of origins for data items |
OriginSource | An enumeration that defines the sources of data origin |
ItemGroupType | An enumeration that defines the roles of an item group within a specific context |
TimingType | An enumeration that defines CDISC timing type values indicating the temporal relationship of an observation to a reference point |
LinkingPhraseEnum | An enumeration that defines variable relationship descriptive linking phrases from the COSMoS SDTM BC model |
PredicateTermEnum | An enumeration that defines short variable relationship linking phrases for programming purposes from the COSMoS SDTM BC model |
DataProductLifecycleStatus | An enumeration that defines the lifecycle stages for a DataProduct |
StandardName | An enumeration that defines permissible values for standard names |
StandardType | An enumeration that defines permissible values for standard types |
PublishingSet | An enumeration that defines permissible values for publishing sets |
StandardStatus | An enumeration that defines permissible values for standard status |
LogicalOperator | Logical operators for combining conditions in Boolean expressions. For complex expressions, use the EXPRESSION value. |
Types
Type | Description |
---|---|
String | A character string |
Integer | An integer |
Boolean | A binary (true or false) value |
Float | A real number that conforms to the xsd:float specification |
Double | A real number that conforms to the xsd:double specification |
Decimal | A real number with arbitrary precision that conforms to the xsd:decimal specification |
Time | A time object represents a (local) time of day, independent of any particular day |
Date | a date (year, month and day) in an idealized calendar |
Datetime | The combination of a date and time |
DateOrDatetime | Either a date or a datetime |
Uriorcurie | a URI or a CURIE |
Curie | a compact URI |
Uri | a complete URI |
Ncname | Prefix part of CURIE |
Objectidentifier | A URI or CURIE that represents an object in the model. |
Nodeidentifier | A URI, CURIE or BNODE that represents a node in a model. |
Jsonpointer | A string encoding a JSON Pointer. The value of the string MUST conform to JSON Point syntax and SHOULD dereference to a valid object within the current instance document when encoded in tree form. |
Jsonpath | A string encoding a JSON Path. The value of the string MUST conform to JSON Point syntax and SHOULD dereference to zero or more valid objects within the current instance document when encoded in tree form. |
Sparqlpath | A string encoding a SPARQL Property Path. The value of the string MUST conform to SPARQL syntax and SHOULD dereference to zero or more valid objects within the current instance document when encoded as RDF. |
Subsets
Subset | Description |
---|---|