Flowable Open Source Documentation

Flowable Open Source Documentation

  • Guides
  • Javadocs
  • Open source home

›Forms User Guide

Flowable Open Source

  • Open Source Details

BPMN User Guide

  • Getting Started
  • Configuration
  • The Flowable API
  • Spring integration
  • Spring Boot
  • Deployment
  • BPMN 2.0 Introduction
  • BPMN 2.0 Constructs
  • Forms
  • Process Instance Migration
  • JPA
  • History
  • Identity management
  • REST API
  • CDI integration
  • LDAP integration
  • Advanced
  • Tooling

CMMN User Guide

  • Configuration
  • The Flowable CMMN API
  • Spring integration
  • Deployment
  • CMMN 1.1
  • Architecture
  • REST API

Event Registry User Guide

  • Configuration
  • The Flowable Event Registry API
  • Spring integration
  • Deployment
  • Event Registry Introduction
  • REST API

DMN User Guide

  • Configuration
  • The Flowable DMN API
  • Spring integration
  • Deployment
  • DMN 1.1 Introduction
  • REST API

Forms User Guide

  • Configuration
  • The Flowable Form API
  • Spring integration
  • Deployment
  • Form Introduction
  • REST API

Applications Guide

  • Flowable applications
  • Eclipse Designer

Migration from v5

  • Flowable Migration Guide : Flowable or Activiti v5 to Flowable V6

Disclaimer

  • Disclaimer

REST API

General Flowable REST principles

Installation and Authentication

Flowable includes a REST API to the Flowable engine that can be installed by deploying the flowable-rest.war file to a servlet container like Apache Tomcat. However, it can also be used in another web-application by including the servlet (and/or its mappings) in your application and add all flowable-rest dependencies to the classpath.

By default the Flowable engine will connect to an in-memory H2 database. You can change the database settings in the flowable-app.properties file in the WEB-INF/META-INF/flowable-app folder. The REST API uses JSON format (http://www.json.org) and is built upon the Spring MVC (http://docs.spring.io/spring/docs/current/spring-framework-reference/html/mvc.html).

All REST-resources require a valid user with the rest-access-api privilege to be authenticated by default. If any valid user should be able to call the REST API, the flowable.rest.app.authentication-mode can be set to any-user (this was the default in older versions of Flowable).

A default user that can access the REST API can be configured by settings the following properties:

flowable.rest.app.admin.user-id=rest-admin
flowable.rest.app.admin.password=test
flowable.rest.app.admin.first-name=Rest
flowable.rest.app.admin.last-name=Admin

When the REST app boots up, the user is created if it doesn’t exist or fetched otherwise. This user will be given the access-rest-api privilege which is needed by default to access the REST API. Do not forget to change the password of this user afterwards. If the flowable.rest.app.admin.user-id is not set, no users or privileges will be created. So, after the initial setup, removing this property will not remove the user nor the privilege that has been configured before.

Basic HTTP access authentication is used, so you should always include a Authorization: Basic …​== HTTP-header when performing requests or include the username and password in the request-url (for example, http://username:password@localhost:8080/xyz).

We recommend that you use Basic Authentication in combination with HTTPS.

Configuration

The Flowable REST web application uses Spring Java Configuration for starting the Flowable Form engine, defining the basic authentication security using Spring security, and to define the variable converters for specific variable handling. A small number of properties can be defined by changing the flowable-app.properties file you can find in the WEB-INF/META-INF/flowable-app/flowable-app.properties folder. If you need more advanced configuration options there’s the possibility to override the default Spring beans in XML in the flowable-custom-context.xml file you can also find in the WEB-INF/classes folder. An example configuration is already in comments in this file. This is also the place to override the default RestResponseFactory by defining a new Spring bean with the name restResponsefactory and use your custom implementation class for it.

Usage in Tomcat

Due to default security properties on Tomcat, escaped forward slashes (%2F and %5C) are not allowed by default (400-result is returned). This may have an impact on the deployment resources and their data-URL, as the URL can potentially contain escaped forward slashes.

When issues are experienced with unexpected 400-results, set the following system-property:

-Dorg.apache.tomcat.util.buf.UDecoder.ALLOW_ENCODED_SLASH=true

It’s best practice to always set the Accept and Content-Type (in case of posting/putting JSON) headers to application/json on the HTTP requests described below.

Methods and return-codes

HTTP-methods and corresponding operations
Method Operations

GET

Get a single resource or get a collection of resources.

POST

Create a new resource. Also used for executing resource-queries which have a too complex request-structure to fit in the query-URL of a GET-request.

PUT

Update properties of an existing resource. Also used for invoking actions on an existing resource.

DELETE

Delete an existing resource.

HTTP-methods response codes
Response Description

200 - Ok

The operation was successful and a response has been returned (GET and PUT requests).

201 - Created

The operation was successful and the entity has been created and is returned in the response-body (POST request).

204 - No content

The operation was successful and entity has been deleted and therefore there is no response-body returned (DELETE request).

401 - Unauthorized

The operation failed. The operation requires an Authentication header to be set. If this was present in the request, the supplied credentials are not valid or the user is not authorized to perform this operation.

403 - Forbidden

The operation is forbidden and should not be re-attempted. This implies an issue with authorization not authentication, it’s an operation that is not allowed. Example: deleting a task that is part of a running process is not allowed and will never be allowed, regardless of the user or process/task state.

404 - Not found

The operation failed. The requested resource was not found.

405 - Method not allowed

The operation failed. The method is not allowed for this resource. For example, trying to update (PUT) a deployment-resource will result in a 405 status.

409 - Conflict

The operation failed. The operation causes an update of a resource that has been updated by another operation, which makes the update no longer valid. Can also indicate a resource that is being created in a collection where a resource with that identifier already exists.

415 - Unsupported Media Type

The operation failed. The request body contains an unsupported media type. Also occurs when the request-body JSON contains an unknown attribute or value that doesn’t have the right format/type to be accepted.

500 - Internal server error

The operation failed. An unexpected exception occurred while executing the operation. The response-body contains details about the error.

The media-type of the HTTP-responses is always application/json unless binary content is requested (for example, deployment resource data), the media-type of the content is used.

Error response body

When an error occurs (both client and server, 4XX and 5XX status-codes) the response body contains an object describing the error that occurred. An example for a 404-status when a task is not found:

{
  "statusCode" : 404,
  "errorMessage" : "Could not find a task with id '444'."
}

Request parameters

URL fragments

Parameters that are part of the URL (for example, the deploymentId parameter in http://host/flowable-rest/form-api/form-repository/deployments/{deploymentId}) need to be properly escaped (see URL-encoding or Percent-encoding) in case the segment contains special characters. Most frameworks have this functionality built in, but it should be taken into account. Especially for segments that can contain forward-slashes (for example, deployment resource), this is required.

Rest URL query parameters

Parameters added as query-string in the URL (for example, the name parameter used in http://host/flowable-rest/form-api/form-repository/deployments?name=Deployment) can have the following types and are mentioned in the corresponding REST-API documentation:

URL query parameter types
Type Format

String

Plain text parameters. Can contain any valid characters that are allowed in URLs. In the case of a XXXLike parameter, the string should contain the wildcard character % (properly URL-encoded). This allows you to specify the intent of the like-search. For example, 'Tas%' matches all values, starting with 'Tas'.

Integer

Parameter representing an integer value. Can only contain numeric non-decimal values, between -2.147.483.648 and 2.147.483.647.

Long

Parameter representing a long value. Can only contain numeric non-decimal values, between -9.223.372.036.854.775.808 and 9.223.372.036.854.775.807.

Boolean

Parameter representing a boolean value. Can be either true or false. All other values other than these will cause a '405 - Bad request' response.

Date

Parameter representing a date value. Use the ISO-8601 date-format (see ISO-8601 on wikipedia) using both time and date-components (e.g. 2013-04-03T23:45Z).

JSON body parameters

JSON parameter types
Type Format

String

Plain text parameters. In the case of a XXXLike parameter, the string should contain the wildcard character %. This allows you to specify the intent of the like-search. For example, 'Tas%' matches all values, starting with 'Tas'.

Integer

Parameter representing an integer value, using a JSON number. Can only contain numeric non-decimal values, between -2.147.483.648 and 2.147.483.647.

Long

Parameter representing a long value, using a JSON number. Can only contain numeric non-decimal values, between -9.223.372.036.854.775.808 and 9.223.372.036.854.775.807.

Date

Parameter representing a date value, using a JSON text. Use the ISO-8601 date-format (see ISO-8601 on wikipedia) using both time and date-components (for example, 2013-04-03T23:45Z).

Paging and sorting

Paging and order parameters can be added as query-string in the URL (for example, the name parameter used in http://host/flowable-rest/form-api/form-repository/deployments?sort=name).

Variable query JSON parameters
Parameter Default value Description

sort

different per query implementation

Name of the sort key, for which the default value and the allowed values are different per query implementation.

order

asc

Sorting order which can be 'asc' or 'desc'.

start

0

Parameter to allow for paging of the result. By default the result will start at 0.

size

10

Parameter to allow for paging of the result. By default the size will be 10.

Note

Bear in mind that the start parameter is used as the offset of the query. For example, to get tasks in three pages of three items each (9 items), we would use:

GET /runtime/tasks?start=0&size=3
GET /runtime/tasks?start=3&size=3
GET /runtime/tasks?start=6&size=3

JSON query variable format

{
  "name" : "variableName",
  "value" : "variableValue",
  "operation" : "equals",
  "type" : "string"
}
Variable query JSON parameters
Parameter Required Description

name

No

Name of the variable to include in a query. Can be empty in the case where 'equals' is used in some queries to query for resources that have any variable name with the given value.

value

Yes

Value of the variable included in the query, should include a correct format for the given type.

operator

Yes

Operator to use in query, can have the following values: equals, notEquals, equalsIgnoreCase, notEqualsIgnoreCase, lessThan, greaterThan, lessThanOrEquals, greaterThanOrEquals and like.

type

No

Type of variable to use. When omitted, the type will be deduced from the value parameter. Any JSON text-values will be considered of type string, JSON booleans of type boolean, JSON numbers of type long or integer depending on the size of the number. We recommended you include an explicit type when in doubt. Types supported out of the box are listed below.

Default query JSON types
Type name Description

string

Value is treated as and converted to a java.lang.String.

short

Value is treated as and converted to a java.lang.Integer.

integer

Value is treated as and converted to a java.lang.Integer.

long

Value is treated as and converted to a java.lang.Long.

double

Value is treated as and converted to a java.lang.Double.

boolean

Value is treated as and converted to a java.lang.Boolean.

date

Value is treated as and converted to a java.util.Date. The JSON string will be converted using ISO-8601 date format.

Variable representation

When working with variables (execute decision), the REST API uses some common principles and JSON-format for both reading and writing. The JSON representation of a variable looks like this:

{
  "name" : "variableName",
  "value" : "variableValue",
  "valueUrl" : "http://...",
  "type" : "string"
}
Variable JSON attributes
Parameter Required Description

name

Yes

Name of the variable.

value

No

Value of the variable. When writing a variable and value is omitted, null will be used as value.

valueUrl

No

When reading a variable of type binary or serializable, this attribute will point to the URL from where the raw binary data can be fetched.

type

No

Type of the variable. See table below for additional information on types. When writing a variable and this value is omitted, the type will be deduced from the raw JSON-attribute request type and is limited to either string, double, integer and boolean. We advise you to always include a type to make sure no wrong assumption about the type are made.

Variable Types
Type name Description

string

Value is treated as a java.lang.String. Raw JSON-text value is used when writing a variable.

integer

Value is treated as a java.lang.Integer. When writing, JSON number value is used as base for conversion, falls back to JSON text.

short

Value is treated as a java.lang.Short. When writing, JSON number value is used as base for conversion, falls back to JSON text.

long

Value is treated as a java.lang.Long. When writing, JSON number value is used as base for conversion, falls back to JSON text.

double

Value is treated as a java.lang.Double. When writing, JSON number value is used as base for conversion, falls back to JSON text.

boolean

Value is treated as a java.lang.Boolean. When writing, JSON boolean value is used for conversion.

date

Value is treated as a java.util.Date. When writing, the JSON text will be converted using ISO-8601 date format.

It’s possible to support additional variable-types with a custom JSON representation (either simple value or complex/nested JSON object). By extending the initializeVariableConverters() method on org.flowable.dmn.rest.service.api.DmnRestResponseFactory, you can add additional org.flowable.rest.variable.RestVariableConverter classes to support converting your POJOs to a format suitable for transferring through REST and converting the REST-value back to your POJO. The actual transformation to JSON is done by Jackson.

Deployment

When using Tomcat, please read Usage in Tomcat.

List of Deployments

GET form-repository/deployments
URL query parameters
Parameter Required Value Description

name

No

String

Only return deployments with the given name.

nameLike

No

String

Only return deployments with a name like the given name.

category

No

String

Only return deployments with the given category.

categoryNotEquals

No

String

Only return deployments which don’t have the given category.

tenantId

No

String

Only return deployments with the given tenantId.

tenantIdLike

No

String

Only return deployments with a tenantId like the given value.

withoutTenantId

No

Boolean

If true, only returns deployments without a tenantId set. If false, the withoutTenantId parameter is ignored.

sort

No

'id' (default), 'name', 'deploytime' or 'tenantId'

Property to sort on, to be used together with the 'order'.

REST Response codes
Response code Description

200

Indicates the request was successful.

Success response body:

{
  "data": [
    {
      "id": "10",
      "name": "flowable-form-examples",
      "deploymentTime": "2010-10-13T14:54:26.750+02:00",
      "category": "examples",
      "url": "http://localhost:8081/form-api/form-repository/deployments/10",
      "tenantId": null
    }
  ],
  "total": 1,
  "start": 0,
  "sort": "id",
  "order": "asc",
  "size": 1
}

Get a deployment

GET form-repository/deployments/{deploymentId}
Get a deployment - URL parameters
Parameter Required Value Description

deploymentId

Yes

String

The ID of the deployment to get.

Get a deployment - Response codes
Response code Description

200

Indicates the deployment was found and returned.

404

Indicates the requested deployment was not found.

Success response body:

{
  "id": "10",
  "name": "flowable-form-examples",
  "deploymentTime": "2010-10-13T14:54:26.750+02:00",
  "category": "examples",
  "url": "http://localhost:8081/form-api/form-repository/deployments/10",
  "tenantId" : null
}

Create a new deployment

POST form-repository/deployments

Request body:

The request body should contain data of type multipart/form-data. There should be exactly one file in the request, any additional files will be ignored. The deployment name is the name of the file-field passed in.

An additional parameter (form-field) can be passed in the request body with name tenantId. The value of this field will be used as the identifier of the tenant in which this deployment is done.

Create a new deployment - Response codes
Response code Description

201

Indicates the deployment was created.

400

Indicates there was no content present in the request body or the content mime-type is not supported for deployment. The status-description contains additional information.

Success response body:

{
  "id": "10",
  "name": "simple.form",
  "deploymentTime": "2010-10-13T14:54:26.750+02:00",
  "category": null,
  "url": "http://localhost:8081/form-api/form-repository/deployments/10",
  "tenantId" : "myTenant"
}

Delete a deployment

DELETE form-repository/deployments/{deploymentId}
Delete a deployment - URL parameters
Parameter Required Value Description

deploymentId

Yes

String

The identifier of the deployment to delete.

Delete a deployment - Response codes
Response code Description

204

Indicates the deployment was found and has been deleted. Response-body is intentionally empty.

404

Indicates the requested deployment was not found.

Get a deployment resource content

GET form-repository/deployments/{deploymentId}/resourcedata/{resourceId}
Get a deployment resource content - URL parameters
Parameter Required Value Description

deploymentId

Yes

String

The identifier of the deployment the requested resource is part of.

resourceId

Yes

String

The identifier of the resource to get the data for. Make sure you URL-encode the resourceId in case it contains forward slashes. Fro example, use 'forms%2Fmy-form.form' instead of 'forms/my-form.form'.

Get a deployment resource content - Response codes
Response code Description

200

Indicates both deployment and resource have been found and the resource data has been returned.

404

Indicates the requested deployment was not found or there is no resource with the given ID present in the deployment. The status-description contains additional information.

Success response body:

The response body will contain the binary resource-content for the requested resource. The response content-type will be the same as the type returned in the resources 'mimeType' property. Also, a content-disposition header is set, allowing browsers to download the file instead of displaying it.

Form Definitions

List of Form definitions

GET form-repository/form-definitions
List of form definitions - URL parameters
Parameter Required Value Description

version

No

integer

Only return form definitions with the given version.

name

No

String

Only return form definitions with the given name.

nameLike

No

String

Only return form definitions with a name like the given name.

key

No

String

Only return form definitions with the given key.

keyLike

No

String

Only return form definitions with a name like the given key.

resourceName

No

String

Only return form definitions with the given resource name.

resourceNameLike

No

String

Only return form definitions with a name like the given resource name.

category

No

String

Only return form definitions with the given category.

categoryLike

No

String

Only return form definitions with a category like the given name.

categoryNotEquals

No

String

Only return form definitions which don’t have the given category.

deploymentId

No

String

Only return form definitions which are part of a deployment with the given identifier.

latest

No

Boolean

Only return the latest form definition versions. Can only be used together with 'key' and 'keyLike' parameters, using any other parameter will result in a 400-response.

sort

No

'name' (default), 'id', 'key', 'category', 'deploymentId' and 'version'

Property to sort on, to be used together with the 'order'.

List of form definitions - Response codes
Response code Description

200

Indicates request was successful and the form definitions are returned

400

Indicates a parameter was passed in the wrong format or that 'latest' is used with other parameters other than 'key' and 'keyLike'. The status-message contains additional information.

Success response body:

{
  "data": [
    {
      "id" : "818e4703-f1d2-11e6-8549-acde48001122",
      "url" : "http://localhost:8182/form-repository/form-definitions/simpleForm",
      "version" : 1,
      "key" : "simpleForm",
      "category" : "Examples",
      "deploymentId" : "818e4703-f1d2-11e6-8549-acde48001121",
      "parentDeploymentId" : "2",
      "name" : "The Simple Form",
      "description" : "This is a form for testing purposes",
    }
  ],
  "total": 1,
  "start": 0,
  "sort": "name",
  "order": "asc",
  "size": 1
}

Get a form definition

GET repository/form-definitions/{formDefinitionId}
Get a form definition - URL parameters
Parameter Required Value Description

formDefinitionId

Yes

String

The identifier of the process definition to get.

Get a form definition - Response codes
Response code Description

200

Indicates the form definition was found and returned.

404

Indicates the requested form definition was not found.

Success response body:

{
  "id" : "818e4703-f1d2-11e6-8549-acde48001122",
  "url" : "http://localhost:8182/form-repository/form-definitions/simpleForm",
  "version" : 1,
  "key" : "simpleForm",
  "category" : "Examples",
  "deploymentId" : "818e4703-f1d2-11e6-8549-acde48001121",
  "parentDeploymentId" : "2",
  "name" : "The Simple Form",
  "description" : "This is a form for testing purposes",
}

Get a form definition resource content

GET repository/form-definitions/{formDefinitionId}/resourcedata
Get a form definition resource content - URL parameters
Parameter Required Value Description

formDefinitionId

Yes

String

The identifier of the form definition to get the resource data for.

Response:

Exactly the same response codes/boy as GET form-repository/deployment/{deploymentId}/resourcedata/{resourceId}.

Get a form definition Form model

GET form-repository/form-definitions/{formDefinitionId}/model
Get a form definition Form model - URL parameters
Parameter Required Value Description

formDefinitionId

Yes

String

The identifier of the form definition to get the model for.

Get a form definition Form model - Response codes
Response code Description

200

Indicates the form definition was found and the model is returned.

404

Indicates the requested form definition was not found.

Response body: The response body is a JSON representation of the org.flowable.form.model.FormModel and contains the full form definition model.

Form Instances

Get a form instance

GET form/form-instances/{formInstanceId}
Get a form instance - URL parameters
Parameter Required Value Description

formInstanceId

Yes

String

The identifier of the form instance to get.

Get a form instance - Response codes
Response code Description

200

Indicates the form instance was found and returned.

404

Indicates the requested form instance was not found.

Success response body:

{
   "id":"48b9ac82-f1d3-11e6-8549-acde48001122",
   "url":"http://localhost:8182/form/form-instances/48b9ac82-f1d3-11e6-8549-acde48001122",
   "formDefinitionId":"818e4703-f1d2-11e6-8549-acde48001122",
   "taskId":"88",
   "processInstanceId":"66",
   "processDefinitionId":"oneTaskProcess:1:158",
   "submittedDate":"2013-04-17T10:17:43.902+0000",
   "submittedBy":"testUser",
   "formValuesId":"818e4703-f1d2-11e6-8549-acde48001110",
   "tenantId": null
}

Store a form instance

POST form/form-instances

Request body (start by process definition id):

{
   "formDefinitionId":"818e4703-f1d2-11e6-8549-acde48001122",
   "taskId":"88",
   "processInstanceId":"66",
   "processDefinitionId":"oneTaskProcess:1:158",
   "variables": {
      "input1": "test"
   }
}

Request body (start by form definition key):

{
   "formDefinitionKey":"simpleForm",
   "taskId":"88",
   "processInstanceId":"66",
   "processDefinitionId":"oneTaskProcess:1:158",
   "variables": {
      "input1": "test"
   }
}

Only one of formDefinitionId or formDefinitionKey can be used in the request body. Parameters variables and tenantId are optional. If tenantId is omitted, the default tenant will be used. More information about the variable format can be found in the REST variables section.

Store a form instance - Response codes
Response code Description

201

Indicates the form instance was created.

400

Indicates either the form definition was not found (based on identifier or key), no form instance was stored by sending the given message, or an invalid variable has been passed. Status description contains additional information about the error.

Success response body:

{
   "id":"48b9ac82-f1d3-11e6-8549-acde48001122",
   "url":"http://localhost:8182/form/form-instances/48b9ac82-f1d3-11e6-8549-acde48001122",
   "formDefinitionId":"818e4703-f1d2-11e6-8549-acde48001122",
   "taskId":"88",
   "processInstanceId":"66",
   "processDefinitionId":"oneTaskProcess:1:158",
   "submittedDate":"2013-04-17T10:17:43.902+0000",
   "submittedBy":"testUser",
   "formValuesId":"818e4703-f1d2-11e6-8549-acde48001110",
   "tenantId": null
}

List of form instances

GET form/form-instances
List of form instances - URL query parameters
Parameter Required Value Description

id

No

String

Only return process instance with the given identifier.

formDefinitionId

No

String

Only return form instances with the given form definition identifier.

formDefinitionIdLike

No

String

Only return form instances with a form definition identifier like the given value.

taskId

No

String

Only return form instances with the given task identifier.

taskIdLike

No

String

Only return form instances with a task identifier like the given value.

processInstanceId

No

String

Only return form instances with the given process instance identifier.

processInstanceIdLike

No

String

Only return form instances with a process instance identifier like the given value.

processDefinitionId

No

String

Only return form instances with the given process definition identifier.

processDefinitionIdLike

No

String

Only return form instances with a process definition identifier like the given value.

submittedBy

No

String

Only return form instances with the given submitted by.

submittedByLike

No

String

Only return form instances with a submitted by like the given value.

tenantId

No

String

Only return process instances with the given tenantId.

tenantIdLike

No

String

Only return process instances with a tenantId like the given value.

withoutTenantId

No

Boolean

If true, only returns process instances without a tenantId set. If false, the withoutTenantId parameter is ignored.

sort

No

String

Sort field, should be either one of submittedDate (default) or tenantId.

List of form instances - Response codes
Response code Description

200

Indicates request was successful and the form instances are returned

400

Indicates a parameter was passed in the wrong format. The status message contains additional information.

Success response body:

{
   "data":[
      {
       "id":"48b9ac82-f1d3-11e6-8549-acde48001122",
       "url":"http://localhost:8182/form/form-instances/48b9ac82-f1d3-11e6-8549-acde48001122",
       "formDefinitionId":"818e4703-f1d2-11e6-8549-acde48001122",
       "taskId":"88",
       "processInstanceId":"66",
       "processDefinitionId":"oneTaskProcess:1:158",
       "submittedDate":"2013-04-17T10:17:43.902+0000",
       "submittedBy":"testUser",
       "formValuesId":"818e4703-f1d2-11e6-8549-acde48001110",
       "tenantId": null
      }
   ],
   "total":1,
   "start":0,
   "sort":"submittedDate",
   "order":"asc",
   "size":1
}

Query form instances

POST query/form-instances

Request body:

{
  "formDefinitionId":"818e4703-f1d2-11e6-8549-acde48001122"
}

The request body can contain all possible filters that can be used in the List process instances URL query.

The general paging and sorting query-parameters can be used for this URL.

Query form instances - Response codes
Response code Description

200

Indicates request was successful and the form instances are returned

400

Indicates a parameter was passed in the wrong format. The status message contains additional information.

Success response body:

{
   "data":[
      {
       "id":"48b9ac82-f1d3-11e6-8549-acde48001122",
       "url":"http://localhost:8182/form/form-instances/48b9ac82-f1d3-11e6-8549-acde48001122",
       "formDefinitionId":"818e4703-f1d2-11e6-8549-acde48001122",
       "taskId":"88",
       "processInstanceId":"66",
       "processDefinitionId":"oneTaskProcess:1:158",
       "submittedDate":"2013-04-17T10:17:43.902+0000",
       "submittedBy":"testUser",
       "formValuesId":"818e4703-f1d2-11e6-8549-acde48001110",
       "tenantId": null
      }
   ],
   "total":1,
   "start":0,
   "sort":"submittedDate",
   "order":"asc",
   "size":1
}

Form Engine

Get form engine info

GET form-management/engine

Returns a read-only view of the engine that is used in this REST-service.

Success response body:

{
   "name":"default",
   "version":"6.6.0",
   "resourceUrl":"file://flowable/flowable.form.cfg.xml",
   "exception":null
}
Get engine information - Response codes
Response code Description

200

Indicates the form engine information is returned.

← Form IntroductionFlowable applications →
  • General Flowable REST principles
    • Installation and Authentication
    • Configuration
    • Usage in Tomcat
    • Methods and return-codes
    • Error response body
    • Request parameters
  • Deployment
    • List of Deployments
    • Get a deployment
    • Create a new deployment
    • Delete a deployment
    • Get a deployment resource content
  • Form Definitions
    • List of Form definitions
    • Get a form definition
    • Get a form definition resource content
    • Get a form definition Form model
  • Form Instances
    • Get a form instance
    • Store a form instance
    • List of form instances
    • Query form instances
  • Form Engine
    • Get form engine info
Flowable Open Source Documentation
Documentation
GuidesJavadocs
Legal
DisclaimerPolicies
Copyright © 2022 Flowable AG