NIH | National Cancer Institute | NCI Wiki  

Error rendering macro 'rw-search'

null

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Revised based on reply from Denise.
Excerpt
hiddentrue

Started drafting content: Revising content copied from Word document for DSRMWS-1162. 

For caDSR II, the URL has been updated slightly from the legacy caDSR but returns the data in the same format as legacy caDSR.

...

Parameter

Description

<Target Format>

Result format (GetXML, GetJSON, or GetHTML). Use the prefix Get followed by the format (one of XML, JSON, or HTML) concatenated as one word:  

  • If your Target Format is XML, use … /GetXML?query= … to return Target in the form XML.
  • If your Target Format is JSON, use … /GetJSON?query= … to return Target in the form JSON.
  • If your Target Format is HTML, use … /GetHTML?query= … to return Target in the form HTML.

<Target>

Result class name. Use a valid caDSR Class name, such as DataElement , Form, (full list TBD).or Form. For a full list, refer to the caDSR II Domain Class Browser:

https://cadsrapi.cancer.gov/caDSR/domain/browser.dsp

For example, use … query=Form[ … ] to return caDSR Form class information.

<Criteria>

The criteria class that identifies the association to be traversed when retrieving the target/result class. The Criteria constrain the target/result based on the associated ID and ID_VALUE pair or pairs that you provide in the square brackets [ … ].

You can nest Criteria in the square brackets [ … ]. If the Criteria is the Target, then you can use a shorthand and the system assumes the Criteria to be equal to the Target. (This is considered Implicit Criteria.)

  • Implicit Example: Use GetXML?query=DataElement[@publicId=62] to return a Data Element with Data Element publicId=62 in XML format.
  • Nested and Implicit Example: Use GetXML?query=Form[Protocol[@preferredName=C3D ADOPTER TEMPLATES],@publicId=2392775] to return Form with Protocol preferredName=C3D ADOPTER TEMPLATES and Form publicId=2392775

<ID>

Attribute of the Criteria class used to constrain the query. For more than one attribute, use a comma between each attribute. The query performs the AND operation for all ID and ID_VALUE pair parameters you have provided for the Criteria class you have identified.

For example, use [@publicId= …] combined with the ID_VALUE to identify the constraints for the result returned.

<ID_VALUE>

A string identifying the qualified criteria class data to be used as a filter on the result set. One :

  • For version: Do not use both version and latestVersionIndicator together. Specify a version number, or specify latestVersionIndicator=Yes (to return only the latest version), or specify latestVersionIndicator=No (to return all versions).
  • Otherwise, one or more ID-criteria pairs may be used.

For example, use [@publicId=62,@version=6] to identify the qualified criteria class. 

...