NIH | National Cancer Institute | NCI Wiki  

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Deleted the Page Information macro & removed Multi-excerpt macros because they are not in use. Deleted 4.4 phrase because it's no longer recent.

...

Anchor
top
top

Section
Column
width40%
Panel
titleTopic Links

Table of Contents
maxLevel4
minLevel2

Column

This section provides instructions for registering, updating, and amending Complete and Abbreviated trials via the NCI CTRP Trial Registration REST Service.

Introduction

Trial Registration REST Service is a CTRP Web Service that provides the following operations in a REST-like fashion:

  • Register an Abbreviated trial in CTRP from ClinicalTrials.gov using a ClinicalTrials.gov Trial Identifier
  • Update an Abbreviated trial in CTRP
  • Register a Complete interventional or non-interventional trial in CTRP
  • Update a Complete trial in CTRP
  • Amend a Complete trial in CTRP

The service uses XML for data exchange.

Note
titleProgram Codes

The program codes feature (not to be confused with NCI Divisions and Programs) has been enhanced for the 4.4 release. The system ignores program codes unless the trial is one of the following:

  • Complete trial with a lead organization as a member of your cancer center family of organizations.
  • Abbreviated trial where such a member is a participant.

The system validates program code values against those listed on the Manage Program Codes Master List page for your affiliated cancer center. For details, refer to Managing Program Codes.

Service Endpoints

...

Inside the NIH Firewall (VPN required)

Outside of the NIH Firewall

Access Requirements

...

To use the service, you must have a valid NCI LDAP account and a CTRP account. For instructions, refer to Creating New NCI CTRP User Accounts. All service endpoints require HTTP Basic authentication with your NCI LDAP username and password.

XML Schema

...

The service uses XML for data exchange.All XML elements going in or out of the service are defined and validated against the following XML schemas:

XML schemas are well-annotated with inline documentation that explains the purpose and meaning of various elements, types, and attributes. These schemas specify which elements are required and the required order of those elements. Specific elements required for service operations are explained in the sections below.

Persons and Organizations - Requirements and Recommendations

...

Registering or amending Complete trials in the CTRP involves organizations and persons that have the following roles in clinical trials: lead organization, sponsor, principal investigator, and so on. CTRP does not manage information about persons and organizations; instead, this is delegated to the Person and Organization Curation Portal, also known as PO. For more information, refer to the Person and Organization Curation Portal User's Guide.

Note
You must have a user account with appropriate LDAP membership to access the PO User's Guide.

Before registering a trial, ensure that organizations and persons acting on the trial exist already in PO. Use person identifiers (PO IDs) and organization identifiers (CTEP IDs) when you register a trial whenever possible. If they do not already exist, request that they be created prior to trial registration, by submitting a request to the CTRO at ncictro@mail.nih.gov.

Tip
titleUse PO Web Services API

We strongly recommended that you exercise PO Web Services API separately in order to find persons and organizations of interest prior to registering a trial. For instructions, refer to Person and Organization Service. Once you find a person or organization, you can use their IDs within a trial registration packet as shown in API examples below. This helps to minimize duplicates in the CTRP system.

 

API Specification

Register an Abbreviated Trial

...