source-test-enqueued-ids-xml

Synopsis

nodeset source-test-enqueued-ids-xml(source);
nmtoken source;

Parameters

• nmtoken source - Find ids for enqueued tests for this source. (Required)

Return Value

• nodeset - An XML node containing the ids of the source tests enqueued for the source.

Exceptions

• source-test-enqueued-ids - Thrown when there is an error retrieving the list of enqueued job-ids for the given source.

Authentication

Like all Watson Explorer Engine API functions with the exception of ping, the source-test-enqueued-ids-xml function requires authentication.

When using REST, you can simply pass v.username and v.password as CGI parameters via HTTP or HTTPS to authenticate the REST call to the source-test-enqueued-ids-xml function.

When using the SOAP API, you can pass credentials as parameters on an endpoint, or you can leverage the authentication method that is supported by all Watson Explorer Engine functions. Each provides a setAuthentication method that can be passed an authentication object to provide the username and password under which a function executes. An example of this in Java for a SOAP call to the source-test-enqueued-ids-xml function is the following:

    Authentication authentication = new Authentication();
    authentication.setUsername("joe-user");
    authentication.setPassword("joes-password");

    SourceTestEnqueuedIdsXml foo = new SourceTestEnqueuedIdsXml();
    foo.setAuthentication(authentication);

A single authentication object would typically be reused throughout each individual application.