NIH | National Cancer Institute | NCI Wiki  

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Three versions of NCI Enterprise services are supported at any point of time - the most recent version and the previous two versions. As new versions are released, the oldest version will be retired and will no longer be accessible; although CTRP/NES development is fast-paced, it is intended that clients will have to upgrade no more than once a year. For example, as of August 2010, we support NES 3.2, as well as NES 3.1 and 3.0. NES 3.0 has reached the end-of-life (EOL) status and will be retired upon the release of NES 3.3 (late fall/early winter 2010); all users of NES 3.0 are encouraged to upgrade to 3.2 as soon as possible.

Background information

The PO/PA grid services are ISO 21090 compliant. To construct valid XML messages to send to the services, you should be familiar with the ISO 21090 Published Standard(login required). Also read the 21090 PIM (platform independent model) specification, as well as the PO and PA service PIMs available athttps://ncisvn.nci.nih.gov/svn/coppa/trunk/documents/analysis_and_design/service_specifications/

Consuming Secure Services (PO/PA)

...

If you're using the Integration tier, you can use the existing coppagridtest account (password is Coppa#12345).  If you're using the Stage grid or would like to have your own account added to the integration tier, please email NES-USERS-L@LIST.NIH.GOVwith the grid identity to be added.  If you're using your own local installations of PO/PA, see Add your own Grid Identity to PO and/or PA.

Java HOW-TO

Tip

Each day before you start using the services, you'll need to Login to Dorian using the GAARDS UI to extend your local grid identity certificates. They are valid for no more than 12 hours.

...

Code Block
titleLaunch GAARDS-UI (ant security)

steve-matyass-macbook-pro-2:cagrid smatyas$ pwd
/Users/smatyas/dev/cagrid/caGrid
steve-matyass-macbook-pro-2:caGrid smatyas$ ant security
...
  1. Click Login button and specify the following:
    Code Block
    titleSpecify Login Credentials
    
    Credential Provider: Training
    Organization: Training
    Username: matyass
    Password: *********
    

To access the services using java clients, you may want to start with our sample Introduced-generated clients - instructions for running these clients via ant are available.  IDs and search terms are hard-coded in those clients, so you'll need to change them and recompile as needed.  You can call into those clients from your own code; we have a client package prepared for the Trial Registration Serviceto make it easier for you, and client packages for the rest of the services will be available soon.

SoapUI HOW-TO

SoapUI is a web service testing tool that allows for creating SOAP messages and using them to invoke web service end points.  This tool can be convenient if you would like to call services without any coding, such as in QA.  Please see these instructions for how to add grid credentials to SoapUI in order to call secure services

...

.

Consuming Unsecured Services (PO/PA)

Note

Unsecure Services were available prior to v3.1 of PO & PA

Wiki Markup
If you just want to call the services, you can use a tool like SoapUI to generate XML from the WSDLs listed below (which is what QA does).  To get more involved, you can use the sample java code in coppa/code/po-grid/src/gov/nih/nci/coppa/services/\[entities \| structuralroles\]/\[ServiceName\]/client/\[ServiceName\]Client.java.  There are similar clients for PA under coppa/code/pa-grid.

and will be retired when v3.3 is released.

You can access the unsecured services via java the same way you would access the secured services (see above), skipping the steps that involve obtaining grid credentials.  You can also use SoapUI without going through the security steps described aboveThe grid services are ISO 21090 compliant. To construct valid XML messages to send to the services, you should be familiar with the ISO 21090 Published Standard (login required). Also read the 21090 PIM (platform independent model) specification, as well as the PO and PA service PIMs available at https://ncisvn.nci.nih.gov/svn/coppa/trunk/documents/analysis_and_design/service_specifications/.

PO Services

The PO services on the Integration tier are only available from within the NIH firewall, while the services on the Demo tier are accessible outside the firewall.

...