Waiting for engine...
Skip to main content

Execute Process operation

You use the Execute Process operation to asynchronously run a process on a particular Runtime.

The Execution Request object leverages the existing functionality provided by the Execute Process operation. Although both are available for use, Boomi recommends using the Execution Request object. For more information about detailing additional benefits, refer to the Execution Request object topic.

The Execute Process operation is an asynchronous call that submits the process to run and returns results immediately. The operation does not wait for the run to complete.

Parameters​

The following parameters are required to perform the executeProcess operation:

Parameter
Description

processId or processName
The ID or name of the process to be run. If using the name, it must be unique within the account.

atomId
The ID of the Runtime on which to run the process.

note

The API also accepts dynamic process properties. Their specified values override corresponding values persisted from previous runs. Dynamic process property names must match exactly. The API does not accept process property components.

SOAP implementation​

To perform an executeProcess operation, use the executeProcess operation from the WSDL. The following example shows a SOAP envelope (without WS-Security headers) for running a process.

Request:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:api="http://api.platform.boomi.com/">
   <soapenv:Header>
      <wsse:Security
       xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">
        <wsse:UsernameToken wsu:Id="UsernameToken" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
          <wsse:Username>ATOMSPHERE_USER_NAME</wsse:Username>
          <wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordText">
              ATOMSPHERE_PASSWORD
          </wsse:Password>
        </wsse:UsernameToken>
      </wsse:Security>
   </soapenv:Header>
   <soapenv:Body>
      <api:executeProcess xmlns:ns1="http://api.platform.boomi.com/">
         <api:properties processId="789abcde-f012-3456-789a-bcdef0123456" atomId="3456789a-bcde-f012-3456-789abcdef012">
             <api:ProcessProperties>
               <api:ProcessProperty>
                  <api:Name>priority</api:Name>
                  <api:Value>medium</api:Value>
               </api:ProcessProperty>
            </api:ProcessProperties>
         </api:properties>
      </api:executeProcess>
   </soapenv:Body>
</soapenv:Envelope>

Response:

<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
   <S:Body>
      <bns:executeProcessResponse xmlns:bns="http://api.platform.boomi.com/"/>
   </S:Body>
</S:Envelope>
On this Page