> For the complete documentation index, see [llms.txt](https://docs.oneweb.tech/oneweb/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.oneweb.tech/oneweb/design-and-develop-oneweb-apps/design-and-develop-process/integration/integrate-process-with-microflow.md).

# Integrate Process with Microflow

Process can be integrated with an external UX/UI or can be integrated with other systems using the REST APIs provided by ONEWEB Process Designer. Though Process Runtime provides REST APIs sometimes they are integrated using Microflows to provide a common API for integrating with multiple systems. In this section we will talk about how to control and execute the process flow using Microflow engine.

In the Microflow we will use the Web Service node to call the different APIs of the process Runtime.

**Start a Process from Microflow** \
Assume if you need to start a process inside your Microflow. \
1\. Add a Web Service Node to your Microflow & click on the Web Service Node to open Configuration Panel \
2.Open the Web Service Parameter tab \
3\. Select Web Service Type as REST \
4\. Click on the REST Tab

![](https://2015371994-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMpDjHWFRUtZ5nJcSfVXd%2Fuploads%2Fgi9D5GSQNbugb9HPEIIE%2Fimage.png?alt=media\&token=35129310-e9b5-4e72-a759-59bb1360aa4d)

5\. In the REST tab enter the details for the Process API to start flow \
&#x20;           **URL** -http\://:/BPMREST/service/runtime/process//start \
&#x20;           **HTTP Type** - POST \
&#x20;           **Header** - Application/json Content \
&#x20;           **Type** - application/json \
&#x20;           **Authentication** - Basic

![](https://2015371994-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMpDjHWFRUtZ5nJcSfVXd%2Fuploads%2FojfU5kOLv6T5uenB9qjL%2Fimage.png?alt=media\&token=b717d047-221f-4c4f-a6ee-ad1ce285f197)

6\. Click on Open Mapping Parameter to map the input as given below.

![](https://2015371994-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMpDjHWFRUtZ5nJcSfVXd%2Fuploads%2FFUO3clW05Ba1d6W42yI1%2Fimage.png?alt=media\&token=852c8754-74ae-4e77-8502-a0f19c20fa6d)

7\. Click on 'Done' once completed.

{% hint style="success" %}
Now the user can deploy the Microflow and call this microflow to start your process.
{% endhint %}

**Get Task list of a Process from Microflow** \
Once a process is started, if there is a human task to be completed, user needs to retrieve the taskID for the task to claim that task. In this section we will show how to retrieve a task using your Microflow.&#x20;

1\. Add a Web Service Node to your Microflow & click on the Web Service Node to open Configuration Panel

2\. Open the Web Service Parameter tab&#x20;

3\. Select Web Service Type as REST&#x20;

4\. Click on the REST Tab

![](https://2015371994-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMpDjHWFRUtZ5nJcSfVXd%2Fuploads%2FperaoEuXmFpmcph9nv6w%2Fimage.png?alt=media\&token=d8333a08-7ffd-4249-9c71-cfa3452505a3)

5\. In the REST tab enter the details for the Process API to complete the task \
&#x20;           **URL** - http\://:/BPMREST/service/runtime/tasks//complete?user= \
&#x20;           **HTTP Type** - POST \
&#x20;           **Header** - Application/json \
&#x20;           **Content Type** - application/json \
&#x20;           **Authentication** - Basic

![](https://2015371994-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMpDjHWFRUtZ5nJcSfVXd%2Fuploads%2Fy6ic3W2FnVj6hqPz9ONY%2Fimage.png?alt=media\&token=64fa2dec-98eb-4da7-b012-0049285dcc5d)

6\. Click on Open Mapping Parameter to map the input and output as given below.

![](https://2015371994-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMpDjHWFRUtZ5nJcSfVXd%2Fuploads%2FCBq6tz4lcXXJNTCHrlnk%2Fimage.png?alt=media\&token=a2017e5d-4fca-488c-9d41-d90c238dcab6)

Output

![](https://2015371994-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMpDjHWFRUtZ5nJcSfVXd%2Fuploads%2F62dPTP1RbHzIfxud7J1B%2Fimage.png?alt=media\&token=1b2218e4-b586-45b0-8937-76ddd73f0508)

7\. Click on 'Done' once completed.

**Complete a Process from Microflow** \
Once a process is started, user needs to complete each task in the process. In this section we will show how to complete a task using your Microflow. Before you start you need the taskID of the instance which needs to be completed. \
&#x31;**.** Add a Web Service Node to your Microflow & click on the Web Service Node to open Configuration Panel \
2\. Open the Web Service Parameter tab \
3\. Select Web Service Type as REST \
4\. Click on the REST Tab

![](https://2015371994-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMpDjHWFRUtZ5nJcSfVXd%2Fuploads%2FDHqQLcLUoKB7xHlVWa4P%2Fimage.png?alt=media\&token=c540012a-3102-48da-afb9-89b05379a21c)

5\. In the REST tab enter the details for the Process API to complete the task \
&#x20;           **URL** - http\://:/BPMREST/service/runtime/tasks//complete?user= \
&#x20;           **HTTP Type** - POST \
&#x20;           **Header** - Application/json \
&#x20;           **Content Type** - application/json \
&#x20;           **Authentication** - Basic

![](https://2015371994-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMpDjHWFRUtZ5nJcSfVXd%2Fuploads%2F1r2G5ITyHumGRZ415Z2N%2Fimage.png?alt=media\&token=f80fa30e-3a15-4f5e-88a4-a3e80730e5cf)

6\. Click on Open Mapping Parameter to map the input as given below.

![](https://2015371994-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMpDjHWFRUtZ5nJcSfVXd%2Fuploads%2FSXQpNsgsSY568qT7lOZy%2Fimage.png?alt=media\&token=8e2d83dd-e576-45f5-8b7e-0aa04365970e)

7\. Click on 'Done' once completed.

{% hint style="info" %}
**NOTE***:* A process can be integrated with a microflow, which can further be easily integrated to page and thus we can achieve the integration of a page with process. To know about integrating Page with Microflow please refer [6.3.6.2. Page Integration with Microflow](/oneweb/design-and-develop-oneweb-apps/design-and-develop-ux-ui/ux-ui-integration-with-process-micro-flow-external-ui/page-integration-with-microflow.md).
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.oneweb.tech/oneweb/design-and-develop-oneweb-apps/design-and-develop-process/integration/integrate-process-with-microflow.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
