Testing the Web Services interface

Edit online

You can test and demonstrate the IBM® Cognos® Command Center Web Services interface by using a web services browser. The following procedure uses the open source soapUI tool.

Before you begin

This test example shows how to start a process through the Web Services interface. The test requires a process that can be started in the Cognos Command Center repository and assumes the following objects exist in the Command Center repository:
  • An ecosystem named WS Test that contains an environment named WS Test.
  • A process named WS Test that has a process variable named MSG.

Procedure

  1. Start soapUI and create a new project.
    Tip: The WSDL file is in INSTALLDIR\Server\config\schemas.staranalytics.com.sfcc.wsdl.
  2. Double-click on the Projects > StartProcess > Request node in the navigator.
  3. In the Request window, edit the endpoint of the url to point to Cognos Command Center.
    For example, http://127.0.0.1:9003/Sfcc.
  4. In the Request window, Edit the SOAP header to include the to address.
    For example, 
    <soap:Header>
  <To soap:mustUnderstand="1" xmlns="http://www.w3.org/2005/08/addressing">
  http://127.0.0.1:9003/Sfcc
  </To>
</soap:Header>
  5. Edit the SOAP body to include names that match the target Cognos Command Center system and optionally, add ecosystem and process variable values.
    For example,
    <soap:Body>
  <sfcc: StartProcess>
    <sfcc:ecosystem>WS Test</sfcc:ecosystem>
    <sfcc:environment>WS Test</sfcc:environment>
    <sfcc:process>WS Test</sfcc:process>
    <sfcc:args>
      <sfcc:NameValuePair>
        <sfcc:Name>MSG</sfcc:Name>
        <sfcc:Value>Hello from soapUI</sfcc:Value>
      </sfcc:NameValuePair>
    </sfcc:args>
  </sfcc: StartProcess>
</soap:Body>
  6. Issue the request from the soapUI tool and inspect the result.