Jump to: navigation, search

Stardust/Knowledge Base/Web Service API/Starting Processes with Document Attachments

This example demonstrates how to start a process instance with document attachments using the WS-API.

Create a simple process with ID: "TestProcess1"

Stardust Process Instance Document Attach WS API

Enable Process Attachments

Stardust Process Instance Enable Process Attach

One manual activity to show the data submitted on process start and to allow checking if the document is added as process attachment.

A manual trigger is not required to allow process starts via the WS API.

Stardust Process Instance Manual Activity


In Stardust version > 5.2 WS Security (optional) is supported. Hence the WSDL URLs for http basic authentication have changed. The new URLs are:

http://localhost:8080/project/services/soap/WorkflowServiceHttpBasicAuthSsl?wsdl

http://localhost:8080/project/services/soap/AdministrationServiceHttpBasicAuthSsl?wsdl

http://localhost:8080/project/services/soap/DocumentManagementServiceHttpBasicAuthSsl?wsdl

http://localhost:8080/project/services/soap/UserServiceHttpBasicAuthSsl?wsdl

http://localhost:8080/project/services/soap/QueryServiceHttpBasicAuthSsl?wsdl

After starting the server, it should be possible to import the WSDL into SOAP UI or to read it with another client

(http://localhost:8080/project/services/soap/WorkflowServiceHttpBasicAuthSsl?wsdl)

  • Start an instance of the example process TestProcess1
  • Submit a value for the process data TestStringData
  • Attach a text document to the process
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" 
     xmlns:api="http://infinity.com/bpm/ws/v2009a/api">
   <soapenv:Header/>
   <soapenv:Body>
      <api:startProcess>
         <!--type: string-->
         <api:processId>TestProcess1</api:processId>
         <api:parameters>
            <!--Zero or more repetitions:-->
            <api:parameter>
               <!--type: string-->
               <api:name>TestStringData</api:name>
               <api:primitive>My test data</api:primitive>
            </api:parameter>
         </api:parameters>
         <!--type: boolean-->
         <api:startSynchronously>true</api:startSynchronously>
         <!--Optional:-->
         <api:attachments>
            <!--Zero or more repetitions:-->
	   <api:inputDocument>
               <api:documentInfo>
                  <api:name>mydoc.txt</api:name>
                               <api:type>api:Document</api:type>
                        <api:description>My document description</api:description>
                <api:contentType>text/plain</api:contentType>
            <!--Optional:-->
            <api:owner>motu</api:owner>
            <api:dateCreated>20010-07-15E13:40:00</api:dateCreated>
            <api:dateLastModified>20010-07-15E14:00:00</api:dateLastModified>
            <api:metaDataType></api:metaDataType>
               </api:documentInfo>
               <!--Optional:-->
               <api:content>VGhpcyBpcyBhIHRlc3Q=</api:content>
               <!--Optional:-->
               <api:versionInfo>
                  <api:label></api:label>
               </api:versionInfo>
               <api:targetFolder></api:targetFolder>
            </api:inputDocument>
         </api:attachments>
      </api:startProcess>
   </soapenv:Body>
</soapenv:Envelope>

The credentials to be used for the login to the Stardust service (http basic authentication, motu/motu) can be changed in the properties of the request.

Stardust Create PI Acess Service

After a successful execution of the example startProcess request on IWorkflowServiceSoapBinding, a new work list entry for the Administrator should exist:

Stardust PI Worklist

The activity panel which opens for this work item should show

  • The submitted process data
  • The document attached to the process

Stardust Create PI Activity Panel