From aed2d615cb4a145ec6ecf9f7f196f34319f2f701 Mon Sep 17 00:00:00 2001 From: PharmCat Date: Wed, 18 Jan 2023 16:23:22 +0300 Subject: [PATCH] update --- docs/make.jl | 9 ++++-- docs/src/odm/clinicaldata.md | 28 +++++++++++------- docs/src/odm/event.md | 28 ++++++++++++++++++ docs/src/odm/form.md | 25 +++++++++++++--- docs/src/odm/item.md | 57 +++++++++++++----------------------- docs/src/odm/itemgroup.md | 44 ++++++++++++++++++++-------- docs/src/odm/metadata.md | 24 +++++++++++++++ docs/src/odm/odm.md | 54 +++++++++++++++++++--------------- docs/src/odm/study.md | 20 +++++++++++++ 9 files changed, 200 insertions(+), 89 deletions(-) create mode 100644 docs/src/odm/event.md create mode 100644 docs/src/odm/metadata.md create mode 100644 docs/src/odm/study.md diff --git a/docs/make.jl b/docs/make.jl index 38b6939..8206268 100644 --- a/docs/make.jl +++ b/docs/make.jl @@ -11,9 +11,12 @@ makedocs( "Examples" => "examples.md", "ODM" => [ "ODM" => ".//odm//odm.md", - "Form" => ".//odm//form.md", - "ItemGroup" => ".//odm//itemgroup.md", - "Item" => ".//odm//item.md", + "Study" => ".//odm//study.md", + "MetaDataVersion" => ".//odm//metadata.md", + "StudyEventDef" => ".//odm//event.md", + "FormDef" => ".//odm//form.md", + "ItemGroupDef" => ".//odm//itemgroup.md", + "ItemDef" => ".//odm//item.md", "ClinicalData"=>".//odm//clinicaldata.md"], "API" => "api.md" ], diff --git a/docs/src/odm/clinicaldata.md b/docs/src/odm/clinicaldata.md index cfce882..566d887 100644 --- a/docs/src/odm/clinicaldata.md +++ b/docs/src/odm/clinicaldata.md @@ -1,17 +1,23 @@ +## Body + + (SubjectData*, AuditRecords*, Signatures*, Annotations*) + ## Attributes -ClinicalData node should get attributes: +* StudyOID oidref References the Study that uses the data nested within this element. +* MetaDataVersionOID oidref References the MetaDataVersion (within the above Study) that governs the data nested within this element. -* StudyOID -* MetaDataVersionOID +## Contained in -## Body - -* SubjectData* -* AuditRecords* -* Signatures* -* Annotations* +* ODM + +Clinical data for multiple subjects. -## In +The StudyOID and MetaDataVersionOID attributes select a particular metadata version. All metadata references (OIDs) occurring within this ClinicalData element refer to definitions within the selected metadata version. -ODM \ No newline at end of file +Based on +Specification for the Operational Data Model (ODM) +Version 1.3.2 Production +Source File: ODM1-3-2.htm +Last Update: 2013-12-01 Copyright © CDISC 2013. +http://www.cdisc.org/odm \ No newline at end of file diff --git a/docs/src/odm/event.md b/docs/src/odm/event.md new file mode 100644 index 0000000..2235c8f --- /dev/null +++ b/docs/src/odm/event.md @@ -0,0 +1,28 @@ +## Body + + (Description?, FormRef*, Alias*) + +## Attributes + +* OID oid +* Name name +* Repeating (Yes | No) +* Type (Scheduled | Unscheduled | Common) +* Category text (optional) + +## Contained in + +* MetaDataVersion + +A StudyEventDef packages a set of forms. Scheduled Study Events correspond to sets of forms that are expected to be collected for each subject as part of the planned visit sequence for the study. Unscheduled Study Events are designed to collect data that may or may not occur for any particular subject such as a set of forms that are completed for an early termination due to a serious adverse event. A common Study Event is a collection of forms that are used at several different data collection events such as an Adverse Event or Concomitant Medications log. + +The Repeating flag indicates that this type of study event can occur repeatedly within any given subject. + +The Category attribute is typically used to indicate the study phase appropriate to this type of study event. Examples might include Screening, PreTreatment, Treatment, and FollowUp. + +Based on +Specification for the Operational Data Model (ODM) +Version 1.3.2 Production +Source File: ODM1-3-2.htm +Last Update: 2013-12-01 Copyright © CDISC 2013. +http://www.cdisc.org/odm diff --git a/docs/src/odm/form.md b/docs/src/odm/form.md index a380f86..d4f8a6d 100644 --- a/docs/src/odm/form.md +++ b/docs/src/odm/form.md @@ -1,7 +1,24 @@ +## Body + + (Description?, ItemGroupRef*, ArchiveLayout*, Alias*) + ## Attributes -Form node should get attributes: +* OID oid +* Name name +* Repeating (Yes | No) + +## Contained in + +* MetaDataVersion + +A FormDef describes a type of form that can occur in a study. + +The Repeating flag indicates that this type of form can occur repeatedly within a containing study event. -* OID -* Name -* Repeating (`Yes` or `No`) +Based on +Specification for the Operational Data Model (ODM) +Version 1.3.2 Production +Source File: ODM1-3-2.htm +Last Update: 2013-12-01 Copyright © CDISC 2013. +http://www.cdisc.org/odm diff --git a/docs/src/odm/item.md b/docs/src/odm/item.md index c5430df..490a83c 100644 --- a/docs/src/odm/item.md +++ b/docs/src/odm/item.md @@ -1,43 +1,28 @@ -## Attributes +## Body -Item node should get attributes: + (Description?, Question?, ExternalQuestion?, MeasurementUnitRef*, RangeCheck*, CodeListRef?, Role* Deprecated, Alias*) -* OID -* Name -* DataType +## Attributes -Optional attributes: +* OID oid +* Name name +* DataType (text | integer | float | date | time | datetime | string | boolean | double | hexBinary | base64Binary | hexFloat | base64Float | partialDate | partialTime | partialDatetime | durationDatetime | intervalDatetime | incompleteDatetime | incompleteDate | incompleteTime | URI ) +* Length positiveInteger (optional) +* SignificantDigits nonNegativeInteger (optional) +* SASFieldName sasName (optional) +* SDSVarName sasName (optional) +* Origin text (optional) +* Comment text (optional) -* Length -* SignificantDigits -* SASFieldName -* SDSVarName -* Origin -* Comment +# Contained in -## DataType +* MetaDataVersion -DataType values: +An ItemDef describes a type of item that can occur within a study. Item properties include name, datatype, measurement units, range or codelist restrictions, and several other properties. -* text -* integer -* float -* date -* time -* datetime -* string -* boolean -* double -* hexBinary -* base64Binary -* hexFloat -* base64Float -* partialDate -* partialTime -* partialDatetime -* durationDatetime -* intervalDatetime -* incompleteDatetime -* incompleteDate -* incompleteTime -* URI +Based on +Specification for the Operational Data Model (ODM) +Version 1.3.2 Production +Source File: ODM1-3-2.htm +Last Update: 2013-12-01 Copyright © CDISC 2013. +http://www.cdisc.org/odm \ No newline at end of file diff --git a/docs/src/odm/itemgroup.md b/docs/src/odm/itemgroup.md index dced501..499ceeb 100644 --- a/docs/src/odm/itemgroup.md +++ b/docs/src/odm/itemgroup.md @@ -1,17 +1,37 @@ +## Body + + (Description?, ItemRef*, Alias*) + ## Attributes -ItemGroup node should get attributes: +* OID oid +* Name name +* Repeating (Yes | No) +* IsReferenceData (Yes | No) (optional) +* SASDatasetName sasName (optional) +* Domain text (optional) +* Origin text (optional) +* Role name (optional) Deprecated +* Purpose text (optional) +* Comment text (optional) + +## Contained in + +* MetaDataVersion + +An ItemGroupDef describes a type of item group that can occur within a study. + +The Repeating flag indicates that this type of item group can occur repeatedly within the containing form (or reference data). + +If IsReferenceData is Yes, this type of item group can occur only within a ReferenceData element. If IsReferenceData is No, this type of item group can occur only within a ClinicalData element. The default for this attribute is No. -* OID -* Name -* Repeating (`Yes` or `No`) +The Domain, Origin, Purpose, and Comment attributes carry submission information as described in the CDISC Submission Metadata Model located in the SDTM Metadata Submission Guidelines. -Optional attributes: +Note: The Role attribute can be considered a synonym for Purpose. New applications should use Purpose rather than Role. -* IsReferenceData (`Yes` or `No`) -* SASDatasetName -* Domain -* Origin -* Role (Deprecated) -* Purpose -* Comment +Based on +Specification for the Operational Data Model (ODM) +Version 1.3.2 Production +Source File: ODM1-3-2.htm +Last Update: 2013-12-01 Copyright © CDISC 2013. +http://www.cdisc.org/odm \ No newline at end of file diff --git a/docs/src/odm/metadata.md b/docs/src/odm/metadata.md new file mode 100644 index 0000000..6f0797c --- /dev/null +++ b/docs/src/odm/metadata.md @@ -0,0 +1,24 @@ +## Body + + (Include?, Protocol?, StudyEventDef*, FormDef*, ItemGroupDef*, ItemDef*, CodeList*, ImputationMethod*Deprecated, Presentation*, ConditionDef*, MethodDef*) + +## Attributes + +* OID oid +* Name name +* Description text (optional) + +## Contained in: + +* Study + +A metadata version defines the types of study events, forms, item groups, and items that form the study data. + +The Include element references a prior metadata version. This causes all the definitions in that prior metadata version to be automatically included in this one. Any of the included definitions can be replaced (overridden) by explicitly giving a new version of the definition (with the same OID) in the new metadata version. See Include for more information on how the Include element works. New definitions (with new OIDs) can be added in the same way. + +Based on +Specification for the Operational Data Model (ODM) +Version 1.3.2 Production +Source File: ODM1-3-2.htm +Last Update: 2013-12-01 Copyright © CDISC 2013. +http://www.cdisc.org/odm \ No newline at end of file diff --git a/docs/src/odm/odm.md b/docs/src/odm/odm.md index 11833b3..dedc727 100644 --- a/docs/src/odm/odm.md +++ b/docs/src/odm/odm.md @@ -1,26 +1,34 @@ -## Attributes: - -Optional attributes: - -* Description -* FileType -* Granularity -* Archival -* FileOID -* CreationDateTime -* PriorFileOID -* AsOfDateTime -* ODMVersion -* Originator -* SourceSystem -* SourceSystemVersion -* ID +# ODM + +Description of main structural parts provided bellow. Only few elements descibed and only for imformation purpose. **An official version of ODM specificatoion document is available on the ODM page of the CDISC website http://www.cdisc.org/odm.** + ## Body -* Study* -* AdminData* -* ReferenceData* -* ClinicalData* -* Association* -* ds:Signature* \ No newline at end of file + (Study*, AdminData*, ReferenceData*, ClinicalData*, Association*, ds:Signature*) + +## Attributes + +* Description text (optional) The sender should use the Description attribute to record any information that will help the receiver interpret the document correctly. +* FileType ( Snapshot | Transactional ) Snapshot means that the document contains only the current state of the data and metadata it describes, and no transactional history. A Snapshot document may include only one instruction per data point. For clinical data, TransactionType in a Snapshot file must either not be present or be Insert. Transactional means that the document may contain more than one instruction per data point. Use a Transactional document to send both what the current state of the data is, and how it came to be there. +* Granularity ( All | Metadata | AdminData | ReferenceData | AllClinicalData | SingleSite | SingleSubject ) (optional) Granularity is intended to give the sender a shorthand way to describe the breadth of the information in the document, for certain common types of documents. All means the entire study; Metadata means the MetaDataVersion element; AdminData and ReferenceData mean the corresponding elements; AllClinicalData, SingleSite, and SingleSubject are successively more tightly focused subset of the study's clinical data. If these shorthand categories are not sufficient, use the Description attribute to give details. +* Archival (Yes | No) (optional) Set this attribute to Yes to indicate that the file is intended to meet the requirements of an electronic record as defined in 21 CFR 11. See Single Files and Collections for an fuller discussion of the meaning of this attribute, as well as its interaction with other ODM attributes. +* FileOID oid A unique identifier for this file. +* CreationDateTime datetime Time of creation of the file containing the document. +* PriorFileOID oidref (optional) Reference to the previous file (if any) in a series. +* AsOfDateTime datetime (optional) The date/time at which the source database was queried in order to create this document. +* ODMVersion ( 1.2 | 1.2.1 | 1.3 | 1.3.1 | 1.3.2 ) (optional) The version of the ODM standard used. +* Originator text (optional) The organization that generated the ODM file. +* SourceSystem text (optional) The computer system or database management system that is the source of the information in this file. +* SourceSystemVersion text (optional) The version of the "SourceSystem" above. +* ID ID (optional) May be used by the ds:Signature element to refer back to this element. + + +An element group consists of one or more element names (or element groups) enclosed in parentheses, and separated with commas or vertical bars. Commas indicate that the elements (or element groups) must occur in the XML sequentially in the order listed in the group. Vertical bars indicate that exactly one of the elements (or element groups) must occur. An element or element group can be followed by a ? (meaning optional), a * (meaning zero or more occurrences), or a + (meaning one or more occurrences). + +Based on +Specification for the Operational Data Model (ODM) +Version 1.3.2 Production +Source File: ODM1-3-2.htm +Last Update: 2013-12-01 Copyright © CDISC 2013. +http://www.cdisc.org/odm \ No newline at end of file diff --git a/docs/src/odm/study.md b/docs/src/odm/study.md new file mode 100644 index 0000000..51e5bb9 --- /dev/null +++ b/docs/src/odm/study.md @@ -0,0 +1,20 @@ +## Body + + (GlobalVariables, BasicDefinitions?, MetaDataVersion*) + +## Attributes + +* OID oid + +## Contained in + +* ODM + +This element collects static structural information about an individual study. + +Based on +Specification for the Operational Data Model (ODM) +Version 1.3.2 Production +Source File: ODM1-3-2.htm +Last Update: 2013-12-01 Copyright © CDISC 2013. +http://www.cdisc.org/odm \ No newline at end of file