Objective
One objective of the study with its level (primary, secondary, exploratory) and its endpoints.
- Kind
- Concrete class
- Attributes
- 11, 5 required
- NCI code
- C142450
Official definition
The reason for performing a study in terms of the scientific questions to be answered by the analysis of data collected during the study.
In practice
In a protocol document: A row in the objectives and endpoints table.
Inheritance
Objective is a kind of SyntaxTemplate and inherits its attributes. Wherever the model asks for a SyntaxTemplate, a Objective can be used.
Attributes
11 attributes, 5 of them required by the USDM API schema and 1 holding the id of another object instead of the object itself (marked by id).
| Attribute | Type | Card. | Definition |
|---|---|---|---|
| idrequired | string | cardinality 1 | The identifier of this object, unique within the file.Inherited from SyntaxTemplate |
| namerequired | string | cardinality 1 | The literal identifier (i.e., distinctive designation) of the study objective.Inherited from SyntaxTemplate |
| label | string | cardinality 0..1 | The short descriptive designation for the study objective.Inherited from SyntaxTemplate |
| description | string | cardinality 0..1 | A narrative representation of the study objective. (BRIDG)Inherited from SyntaxTemplate |
| textrequired | string | cardinality 1 | An instance of structured text that represents the study objective.Inherited from SyntaxTemplate |
| notes | CommentAnnotation | cardinality 0..* | A brief written record relevant to the study objective.Inherited from SyntaxTemplate |
| dictionaryId | SyntaxTemplateDictionaryby id | cardinality 0..1 | A USDM relationship between the Objective and SyntaxTemplateDictionary classes which provides the set of dictionary entries related to study objectives.Inherited from SyntaxTemplate |
| levelrequired | Code | cardinality 1 | A characterization or classification of the study objective that determines its category of importance relative to other study objectives.USDM codelist C188725, 3 values |
| endpoints | Endpoint | cardinality 0..* | A USDM relationship between the Objective and Endpoint classes which identifies the set of endpoints associated with the study objective. |
| extensionAttributes | ExtensionAttribute | cardinality 0..* | Extension attributes attached to this object, for information the standard does not define. Added by the API; not part of the logical model. |
| instanceTyperequired | string | cardinality 1 | The name of the class, carried by every object in a USDM JSON file. Added by the API; not part of the logical model. |
Allowed values
The coded attributes of Objective that use a codelist defined by USDM, with every value in it. A file carries the code; the term is its decode.
levelcodelist C188725, not extensible
| Code | Term | Definition |
|---|---|---|
| C163559 | Exploratory Objectivealso: Trial Exploratory Objective; Study Exploratory Objective | Additional scientific question(s) within the study that enable further discovery research, beyond the primary and secondary objectives. |
| C85826 | Primary Objectivealso: Trial Primary Objective; Study Primary Objective | The main scientific question(s) the study is designed to answer. [After ICH E8; ICH E6 6.3] (CDISC Glossary) |
| C85827 | Secondary Objectivealso: Trial Secondary Objective; Study Secondary Objective | The supportive or ancillary scientific question(s) the study is designed to answer. [After ICH E8] (CDISC Glossary) |
Smallest valid Objective
The attributes a JSON file must carry for a Objective, and the kind of value each takes. This is the shape, with types named in place of values. Everything else in the table above is optional.
{
"id": "Objective_1",
"name": string,
"text": string,
"level": Code,
"instanceType": "Objective"
}
Where Objective is used
These classes hold or point to a Objective.
- StudyDesign.objectivesnested
Example
A Objective from the example study. Coded values are shortened to one line.
{
"id": "Objective_1",
"name": "PRIMARY_OBJECTIVE",
"label": "Primary objective",
"text": "To evaluate the effect of EX-101 10 mg once daily compared with placebo on seated systolic blood pressure after 12 weeks of treatment.",
"level": { "code": "C85826", "decode": "Primary Objective", … },
"endpoints": [
{
"id": "Endpoint_1",
"name": "PRIMARY_ENDPOINT",
"label": "Primary endpoint",
"text": "Change from baseline in mean seated systolic blood pressure at Week 12.",
"purpose": "Efficacy",
"level": { "code": "C94496", "decode": "Primary Endpoint", … },
"instanceType": "Endpoint"
}
],
"instanceType": "Objective"
}
Related classes
Other classes in objectives, endpoints and estimands: