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.
Study Objective, CDISC USDM 4.0, NCI C142450

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).

AttributeTypeCard.Definition
idrequiredstringcardinality 1The identifier of this object, unique within the file.Inherited from SyntaxTemplate
namerequiredstringcardinality 1The literal identifier (i.e., distinctive designation) of the study objective.Inherited from SyntaxTemplate
labelstringcardinality 0..1The short descriptive designation for the study objective.Inherited from SyntaxTemplate
descriptionstringcardinality 0..1A narrative representation of the study objective. (BRIDG)Inherited from SyntaxTemplate
textrequiredstringcardinality 1An instance of structured text that represents the study objective.Inherited from SyntaxTemplate
notesCommentAnnotationcardinality 0..*A brief written record relevant to the study objective.Inherited from SyntaxTemplate
dictionaryIdSyntaxTemplateDictionaryby idcardinality 0..1A USDM relationship between the Objective and SyntaxTemplateDictionary classes which provides the set of dictionary entries related to study objectives.Inherited from SyntaxTemplate
levelrequiredCodecardinality 1A characterization or classification of the study objective that determines its category of importance relative to other study objectives.USDM codelist C188725, 3 values
endpointsEndpointcardinality 0..*A USDM relationship between the Objective and Endpoint classes which identifies the set of endpoints associated with the study objective.
extensionAttributesExtensionAttributecardinality 0..*Extension attributes attached to this object, for information the standard does not define. Added by the API; not part of the logical model.
instanceTyperequiredstringcardinality 1The 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

CodeTermDefinition
C163559Exploratory Objectivealso: Trial Exploratory Objective; Study Exploratory ObjectiveAdditional scientific question(s) within the study that enable further discovery research, beyond the primary and secondary objectives.
C85826Primary Objectivealso: Trial Primary Objective; Study Primary ObjectiveThe main scientific question(s) the study is designed to answer. [After ICH E8; ICH E6 6.3] (CDISC Glossary)
C85827Secondary Objectivealso: Trial Secondary Objective; Study Secondary ObjectiveThe 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.

Objective, required attributes only
{
  "id": "Objective_1",
  "name": string,
  "text": string,
  "level": Code,
  "instanceType": "Objective"
}

Where Objective is used

These classes hold or point to a Objective.

Example

A Objective from the example study. Coded values are shortened to one line.

Objective_1
{
  "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"
}

Other classes in objectives, endpoints and estimands:

← All 86 classes