Clinical Trials

This section provides information about the Clinical Trials source , listing each field available for Clinical Trials, with details about the field value type, including whether it may be used as a facet and whether it is a multi-value field. The table also contains information about whether the field may be used in the where section and whether the field the field may be used in the entity fields filter. The page also lists the fields included in each fieldset available for Clinical Trials, and each aggregation indicator available.

Clinical Trials Fields

Fields are used to perform searches on the source they belong to.

Field	Type	Multi?	Filter?	Facet?	Description
`abstract`	Literal: string				Abstract or description of the clinical trial.
`acronym`	Literal: string		✓		Acronym of the clinical trial.
`active_years`	Literal: integer	✓	✓	✓	List of active years for a clinical trial.
`altmetric`	Literal: float		✓		Altmetric Attention Score.
`associated_grant_ids`	Literal: string	✓	✓		Dimensions IDs of the grants associated to the clinical trial (see also: Clinical Trials Links section).
`brief_title`	Literal: string		✓		Brief title of the clinical trial.
`category_bra`	Entity: categories	✓	✓	✓	Broad Research Areas
`category_for`	Entity: categories	✓	✓	✓	ANZSRC Fields of Research classification
`category_hra`	Entity: categories	✓	✓	✓	Health Research Areas
`category_hrcs_hc`	Entity: categories	✓	✓	✓	HRCS - Health Categories
`category_hrcs_rac`	Entity: categories	✓	✓	✓	HRCS – Research Activity Codes
`category_icrp_cso`	Entity: categories	✓	✓	✓	ICRP Common Scientific Outline
`category_icrp_ct`	Entity: categories	✓	✓	✓	ICRP Cancer Types
`category_rcdc`	Entity: categories	✓	✓	✓	Research, Condition, and Disease Categorization
`conditions`	Literal: string	✓	✓		List of medical conditions names, e.g. ‘Breast cancer’ or ‘Obesity’.
`date`	Literal: date		✓		Start date of a clinical trial.
`date_inserted`	Literal: date		✓		Date when the record was inserted into Dimensions (note: this field does not support exact match on the data, only range filters e.g. <= or `>=’).
`dimensions_url`	Literal: string				Link pointing to the Dimensions web application
`funder_countries`	Entity: countries	✓	✓	✓	The country group the funding organisations.
`funders`	Entity: organizations	✓	✓	✓	GRID funding organisations that are involved with the clinical trial.
`gender`	Literal: string		✓		The gender of the clinical trial subjects e.g. ‘Male’, ‘Female’ or ‘All’.
`id`	Literal: string		✓		Dimensions clinical trial ID
`interventions`	Literal: json	✓	✓		Structured JSON object containing information about the clinical trial’s interventions according to the research plan or protocol created by the investigators. 1
`investigators`	Literal: json	✓	✓		Additional details about investigators, including affiliations and roles.
`linkout`	Literal: string				Original URL for the clinical trial.
`mesh_terms`	Literal: string	✓	✓	✓	Medical Subject Heading terms as used in PubMed.
`phase`	Literal: string		✓		Phase of the clinical trial, as a string.
`publication_ids`	Literal: string	✓	✓		Publications mentioned in clinical trials (excluding resulting publications), as a list of Dimensions identifiers.
`publications`	Entity: publication_links	✓	✓	✓	Publications mentioned in clinical trials (excluding resulting publications), as a structured entity.
`registry`	Literal: string		✓		The platform where the clinical trial has been registered, e.g. ‘ClinicalTrials.gov’ or ‘EU-CTR’.
`research_orgs`	Entity: organizations	✓	✓	✓	GRID organizations involved, e.g. as sponsors or collaborators.
`researchers`	Entity: researchers	✓	✓	✓	Dimensions researchers IDs associated to the clinical trial.
`title`	Literal: string				The title of the clinical trial.

1

Returned objects contain: type, name, description, arm_group_labels, other_names.

For example:

{
    "interventions":[
        {
            "type":"Drug",
            "name":"INCB024360",
            "description":"INCB024360: Oral daily dosing",
            "arm_group_labels":"MEDI4736 + INCB024360",
            "other_names":""
        },
        {
            "type":"Drug",
            "name":"MEDI4736",
            "description":"MEDI4736 administered intravenously (IV) every two weeks (q2w)",
            "arm_group_labels":"MEDI4736 + INCB024360",
            "other_names":""
        }
    ]
}                                     

Clinical Trials Links

The diagram below provides an overview of the outgoing links from Clinical Trials to other sources.

Clinical Trials Fieldsets

Fieldsets are used to specify fields groups in the context of a return statement.

Fieldset	Fields
`extras`	`abstract` `conditions` `gender` `linkout` `phase` `registry`
`categories`	`category_bra` `category_for` `category_hra` `category_hrcs_hc` `category_hrcs_rac` `category_icrp_cso` `category_icrp_ct` `category_rcdc`
`basics`	`active_years` `id` `investigator_details` `title`

Clinical Trials Indicators

Indicators are used to aggregate results in the context of a facet query.

Indicator	Description
`count`	Total count

Clinical Trials Search Indexes

Search indexes are used to perform full-text searches on the source they belong to. The default search index, which is used if none other is specified, is full_data.

Search index	Supports multi-index search	Description
`title_only`	✓	Search for keywords in title only.
`title_abstract_only`	✓	The keywords will be searched for in the title and description/summary.
`investigators`		Search for keywords in the investigators fields of a clinical trial.
`full_data`	✓	The keyword will be searched for in all data fields that are found for that document. In cases where the full text is indexed in the background this will also be searched, even though the full text may not be available to see within Dimensions itself. This will mean that many results that are returned may not include mention of the searched keyword on the document page, but are returned in the search because the keyword can be found in the full text which cannot be read.

Clinical Trials Deprecations

This section lists fields and search fields that have been deprecated and should not be used.

Warning

This fields will be supported in versions 1.x and removed in the next major release. To ensure full compatibility with the upcoming major release, it is recommend to stop using deprecated fields as soon as possible.

Deprecated Fields

Field	Deprecation Note
`FOR`	Deprecated in favor of: `category_for`
`FOR_first`	Deprecated in favor of: `category_for`
`funder_groups`	Deprecated as this functionality will be delivered via the new “My Groups” feature of the Dimensions Analytics webapp
`HRCS_HC`	Deprecated in favor of: `category_hrcs_hc`
`HRCS_RAC`	Deprecated in favor of: `category_hrcs_rac`
`investigator_details`	Deprecated in favor of: `investigators`
`organizations`	Deprecated in favor of: `research_orgs`
`RCDC`	Deprecated in favor of: `category_rcdc`

Partially Deprecated Fields

Clinical Trials source has no partially deprecated fields.

Deprecated Search Indexes

Search Index	Deprecation Note
`researchers`	Deprecated in favor of: `investigators`