User Tools

Site Tools


Plugin installed incorrectly. Rename plugin directory 'swiftmail.backup' to 'swiftmail'.
This translation is older than the original page and might be outdated. See what has changed.
en:software:tim:webservices:startpibypdname

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.

For this documentation SoapUI is used afterwards.

soapui_einlesen_wsdl.jpgOn 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.

<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>
The part can optionally be removed, if a RenameInstanceHandler is already used in the process
  <properties>
    <name>name</name>
    <value>PROCESSINSTANCENAME</value>
  </properties>

—–

Start a processinstance from SoapUI

instanzstart_aus_soapui.jpgBuilding 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 nameVariable's value
var1value1
var2value2

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

soapui_antwort.jpggestarte_instanz_tim.jpg

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.


en/software/tim/webservices/startpibypdname.txt · Last modified: 2021/07/01 09:52 (external edit)