How to retrieve the business data structure of a process

Q&A
1

Hi everyone

I’m new to Bonita and I’m trying to work with deployed processes via Engine API, so I need a documentation which can helps me to find the way, but I only have found the below documentation:
https://documentation.bonitasoft.com/bonita/7.6/engine-api-overview
which wasn’t clear about all of the Engine API features.
For example:
I want to use the Engine API to work with the process I have deployed. I want to know how to show the schema of business data which my process needs, then I have to send some values to start a process and I totally don’t know how to send data and and I also don’t know how to make the data structure which I want to instantiate the process with that.

I hope that someone helps me to find my way

2

Hello, to get the data you need to start a process using the Engine API use:

apiAccessor.processAPI.getProcessContract(processDefinitionId)

To start a process fulfilling the contract use:

apiAccessor.processAPI.startProcessWithInputs(processDefinitionId, instantiationInputs)

startProcessWithInputs
ProcessInstance startProcessWithInputs(long processDefinitionId,
Map<String,Serializable> instantiationInputs)
throws ProcessDefinitionNotFoundException,
ProcessActivationException,
ProcessExecutionException,
ContractViolationException

Start an instance of the process with the specified process definition id, and provides inputs to fulfill Process Contract. See ContractDefinition for details on contracts.
Parameters:processDefinitionId - The identifier of the process definition for which an instance will be started.instantiationInputs - The couples of input name/value that allows to start a process with an instantiation contract.Returns:An instance of the process.Throws:InvalidSessionException - If the session is invalid, e.g. the session has expired.ProcessDefinitionNotFoundException - If no matching process definition is found.ProcessActivationException - If an exception occurs during activation.ProcessExecutionException - If a problem occurs when starting the process.ContractViolationException - If inputs don’t fit with task contractSince:

3

Hello, to get the data you need to start a process using the Engine API use:

apiAccessor.processAPI.getProcessContract(processDefinitionId)

To start a process fulfilling the contract use:

apiAccessor.processAPI.startProcessWithInputs(processDefinitionId, instantiationInputs)

startProcessWithInputs
ProcessInstance startProcessWithInputs(long processDefinitionId,
Map<String,Serializable> instantiationInputs)
throws ProcessDefinitionNotFoundException,
ProcessActivationException,
ProcessExecutionException,
ContractViolationException

Start an instance of the process with the specified process definition id, and provides inputs to fulfill Process Contract. See ContractDefinition for details on contracts.
Parameters:processDefinitionId - The identifier of the process definition for which an instance will be started.instantiationInputs - The couples of input name/value that allows to start a process with an instantiation contract.Returns:An instance of the process.Throws:InvalidSessionException - If the session is invalid, e.g. the session has expired.ProcessDefinitionNotFoundException - If no matching process definition is found.ProcessActivationException - If an exception occurs during activation.ProcessExecutionException - If a problem occurs when starting the process.ContractViolationException - If inputs don’t fit with task contractSince: