Case tabs
Case tabs are the tabs that are shown on the case detail page. They are used to break up the information of a case into logical categories. The tabs that are shown can be configured per case type.
By default, each newly created case type has a number of tabs that are preconfigured. A list of default tabs is available on the reference page.
Case tab can be configured manually using the Admin UI, or by using autodeployment.
Enabling case tabs
To enable case tabs, set the enableTabManagement
feature toggle to true
in your front-end implementation. For more information on this feature toggle, visit this page.
Different types of case tabs
Valtimo supports the following 4 different types of case tabs:
Standard tabs
Valtimo comes with a number of tabs that support different features. These range from showing a summary form, or showing an audit log to showing the current state of the BPMN process.
The standard tabs that are available are listed on the reference page.
Form.io tabs
Form.io tabs are tabs that show a single Form.io form as the tab content. Any Form.io form that has been registered with valtimo can be chosen. This is purely meant to display information, as there is no way to submit the information even if a submit button has been added to the form definition.
Widget tabs
Widget tabs are tabs that show data by using widgets. These widgets can be configured to show specific data as fields, tables and more.
For more information, visit this page
Custom tabs
When you want tab with functionality that is not covered by the other tab types you can create a custom Angular component that is used as a case tab. These Angular components have to be registered in the Angular application as a potential tab.
app.module.ts
app.module.ts
Configuration using the Admin menu
The case tab menu is found under the admin menu. Admin privileges are required to configure case tabs.
Go to the Admin menu
Go to the 'Cases' menu
Click on the case for which tabs need to be configured
Click on the 'Add tab' button
Select which tab type you want to configure
Fill in the form. If no name is set, then the key will be used for translation (in your translation files, add the key under 'dossier.tabs.{YOUR_TAB_KEY}')
Optionally choose whether the task list will show on the tab you are configuring.
Click the button 'Add tab'
If there are no tabs to be configured for one specific type, then the button in the Step 5 modal will be disabled.
This can occur for one of two reasons:
You have already configured all possible tabs of a type
There are no tabs provided for configuration (i.e. no form definitions or no configurations for custom tabs)
Auto deploying case tabs
Case tabs can be auto-deployed from a JSON file at startup. This is useful to keep the case tab configuration identical across multiple environments. Case tabs are auto-deployed by scanning files on the classpath that end in .case-tabs.json
.
Changesets
Every deployment file for represents a changeset. These files are required to contain a changesetId that should be unique over all deployment files that use changesets. When starting up, changesets that have already been executed will be ignored. A checksum of the changeset is created when it is executed. Changesets that have already been deployed should not change. Changesets that have been changed since a previous time will result in an error and failure to start the application.
All changesets can be executed again, even when the content has changed, by setting the valtimo.changelog.case-tabs.clear-tables
property to true
.
Example
You can find an example of the JSON below.
In this example a tab is created with type standard
. Different tab types can be used to customize the tab. The types that are available can be found on the reference page.
Last updated