===== WSDL =====

The following file can be used to read out the current WSDL: > <JBOSSPFAD>/server/default/data/wsdl/loom.ear/loom-ejb.jar/ProcessInstanceManager<Number>.wsdl\\
Because a new WSDL is generated for every Restart, the most current WSDL of the ProcessInstanceManager has to be read! The method createProcessInstanceByPDName is needed to start a processinstance. 
<note important>For this documentation SoapUI is used afterwards.</note>

----

{{  :software:tim:soapui_einlesen_wsdl.jpg?900}}On the right side a structure for the call is shown. The following parameter are expected:

  * Processdefinitionname
  * WSEntity (This will contain the processname, if it should be set.)
  * WSEntity (This will contain the processvariables and the corresponding values.)

----

====== XML structure for transmission======

The following structure needs to be adhered to, to start a corresponding process. All values in uppercase have to be adjusted to the appropriate wishes.

<code xml>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<loom:createProcessInstanceByPDName xmlns:loom="http://www.loom-gmbh.de/ProcessInstanceManager">
<arg0>PROZESSDEFINITIONSNAME</arg0>
<arg1>
  <id>0</id>
  <className>ProcessInstance</className>
  <properties>
    <name>name</name>
    <value>PROCESSINSTANCENAME</value>
  </properties>
</arg1>
<arg2>
  <id>0</id>
  <className>ProcessVariable</className>
  <properties>
     <name>PROCESSVARIABLENAME1</name>
     <value>PROCESSVARIABLEWERT1</value>
  </properties>
  <properties>
     <name>PROCESSVARIABLENAME2</name>
     <value>PROCESSVARIABLEWERT2</value>
  </properties>
</arg2>
</loom:createProcessInstanceByPDName>
</soap:Body>
</soap:Envelope>

</code>

<note tip>The part can optionally be removed, if a [[en:software:tim:actionhandler:renameinstancehandler|RenameInstanceHandler]] is already used in the process</note>

<code xml>
  <properties>
    <name>name</name>
    <value>PROCESSINSTANCENAME</value>
  </properties>
</code>

—–

==== Start a processinstance from SoapUI ====

{{  :software:tim:instanzstart_aus_soapui.jpg?600}}Building on the structure a webservicecall is sent to TIM. Herefor the XML, which should be sent to the webservice, has to be input on the right part of SoapUI. In this example we will start the process "Wiki WS-Call" and create processvariables, which apparent in the smartform.

^  Processvariables  ^|
^Variable's name^Variable's value|
|var1|value1|
|var2|value2|

Herefor the XMl is filled appropriately and copied into the right section of SoapUI. Then the user, who is allowed to start the process, + password have to be input into the tab **Auth**. If everything is filled out, the call can be executed via the "Play"-Button and gets a XML as a reply, where TIM's reply is included.

----

===== Reply and  Review=====

{{  :software:tim:soapui_antwort.jpg?300}}{{  :software:tim:gestarte_instanz_tim.jpg?300}}

If everything has been able to be processed, TIM gives back the started process' information, which can be used for further processing on the server. If the user logs into TIM the started instance can be shown under **My instances**. 

\\