Skip to main content

Using a Content Model

Outdated documentation page

This is an old version of the documentation for Flowable until version 3.13 and for the Angular-based Flowable Design 3.14/3.15. If you are running the latest version of Flowable please check out the current version of this page.

Adding a Content Model in Flowable Design

For a content model with two metadata values, policy name, and document number, the first step is to create a new Form in Flowable Design. The form is basic with two simple Data entry>Text fields. If one of the metadata values is required, then the field must have the Validation>Required checkbox set.

775 form editor

With the Form defined, the next step is to create the Content model, which can be done in the Work section of Flowable Design. The initial state and sub-state can be filled-in to define the initial values when a new content item is created connected to this content model. This is left empty for this example. To connect the metadata Form to this content model, the Action value edit should be filled-in, and the newly created Form should be selected from the dropdown.

775 content model

To be able to use the content model in a simple BPMN Process, a Process with one user task is created.

775 process editor

The start event and user task should point to the same Form to show that the metadata values that are filled-in when starting the process are available in the task form. Let us create the new Form with a Data entry>Text field with the label Product name and Data entry>Attachment labeled Policy document.

775 form upload editor

To enable the content model selection possibility for a user of Flowable Work or Engage the Details>Has content model checkbox is enabled. To make the content model selection required before completing the form also the Details>Require content model checkbox must be enabled.

In the final step in Flowable Design, a new app definition is created, and the newly created BPMN model, the metadata Form and the Content model (part of the Work section) are selected. Now the app definition can be published.

Using a Content Model in Flowable Work or Engage

With the newly created app and included models published, a new process instance can be created in the Work or Process App. After choosing the process definition, the following start form is presented and notice that the content type is red because it is required and not selected at this point.

775 start form work

After selecting the content type that was created in the previous section, the metadata form is shown in the start form. Now the user can fill in the metadata values for the content item.

775 start form content

After filling in the metadata values and completing the start form, the process instance gets created, and the uploaded file gets stored in the content engine together with the filled-in metadata values. In the task form, the selected content type and filled-in metadata values should now be available as well.

775 task form content

The user can now still change the metadata values to update them and could even select another content type for the uploaded file and fill in the metadata values for that content type. With the Java and REST API the content item, the rendition items (thumbnail and PDF) are created for the uploaded file, and the metadata values are retrieved as needed.