Receiving results of SubmitAsync

To receive the results, a web service must be implemented that implements the function ReplyAsync if the request was sent using the 'bare' variant (itpserver.asmx), or the function ReplyAsyncWrapped if the request was sent using the 'wrapped' variant (itpserverwrapped.asmx). These functions receive as parameters:

jobResult

The result/error indication of running the job (in string format).

OutDocuments

An array of files generated by the ITP/Server service.

CorrelationId

The call identification that was specified when submitting the job. The function ReplyAsync(Wrapped) should return a result/error string, which, except for optional logging, is discarded.

itpserverreply.dll

itpserverreply.dll provides a reference implementation that serves to specify the interface. First, you have to install the Web Services interface. For more information, refer to ITP/Server Installation Guide chapter Installing the ASP.NET Web Services interface, or chapter Installing the J2EE Web Services interface. Then, browse to the following URLs for sample request and reply messages:

• http://<host:port>/<folder>/itpserverreply.asmx?WSDL for the WSDL specification
• http://<host:port>/<folder>/itpserverreply.asmx?op=ReplyAsync
• http://<host:port>/<folder>/itpserverreply.asmx?op=ReplyAsyncWrapped

"<host:port>/<folder>" is the machine/folder in which the Web Services interface is installed, e.g., localhost:8080/itpserver.

The web service implemented by you must adhere to this interface specification.

Sample request (bare version)

POST /itpserver/itpserverreply.asmx HTTP/1.1

Host: localhost

Content-Type: text/xml; charset=utf-8

Content-Length: length

SOAPAction: "http://www.aia-itp.com/itpserver/wsdl/ReplyAsync"

<?xml version="1.0" encoding="utf-8"?>

<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <jobResult xmlns="http://www.aia-itp.com/itpserver/wsdl">string</jobResult>
    <outDocuments xmlns="http://www.aia-itp.com/itpserver/wsdl">
      <Doc>
        <id>string</id>
        <content>base64Binary</content>
      </Doc>
      <Doc>
        <id>string</id>
        <content>base64Binary</content>
      </Doc>
    </outDocuments>
    <correlationId xmlns="http://www.aia-itp.com/itpserver/wsdl">string</correlationId>
  </soap:Body>
</soap:Envelope>

Sample reply (bare version)

HTTP/1.1 200 OK

Content-Type: text/xml; charset=utf-8

Content-Length: length

<?xml version="1.0" encoding="utf-8"?>

<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <result xmlns="http://www.aia-itp.com/itpserver/wsdl">string</result>
  </soap:Body>
</soap:Envelope>

Sample request (wrapped version)

POST /itpserver/itpserverreply.asmx HTTP/1.1

Host: localhost

Content-Type: text/xml; charset=utf-8

Content-Length: length

SOAPAction: "http://www.aia-itp.com/itpserver/wsdl/ReplyAsyncWrapped"

<?xml version="1.0" encoding="utf-8"?>

<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <ReplyAsyncWrapped xmlns="http://www.aia-itp.com/itpserver/wsdl">
      <jobResult>string</jobResult>
      <outDocuments>
        <Doc>
          <id>string</id>
          <content>base64Binary</content>
        </Doc>
        <Doc>
          <id>string</id>
          <content>base64Binary</content>
        </Doc>
      </outDocuments>
      <correlationId>string</correlationId>
    </ReplyAsyncWrapped>
  </soap:Body>
</soap:Envelope>

Sample reply (wrapped version)

HTTP/1.1 200 OK

Content-Type: text/xml; charset=utf-8

Content-Length: length

<?xml version="1.0" encoding="utf-8"?>

<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <ReplyAsyncWrappedResponse xmlns="http://www.aia-itp.com/itpserver/wsdl">
      <result>string</result>
    </ReplyAsyncWrappedResponse>
  </soap:Body>
</soap:Envelope>