Valtimo documentation
  • Welcome to Valtimo
  • Fundamentals
    • â„šī¸What is Valtimo
    • đŸ™ī¸Architectural overview
      • Choosing the right setup
      • âš™ī¸Available modules
    • Process Exchange
      • Process blueprints
      • Building blocks
    • 📖How to use this documentation
    • đŸ–ąī¸Getting started
      • Configuring the database
      • Modules
        • Core modules
          • Audit
          • Authorization
          • Camunda
          • Case
          • Connector
          • Contract
          • Core
          • Dashboard
          • Document
          • Document generation
          • Exporter
          • Form
          • Form flow
          • Form flow Valtimo
          • Importer
          • Localization
          • Local document generation
          • Local mail
          • Mail
          • Mandrill
          • Milestones
          • Plugins
          • Outbox
            • Outbox RabbitMQ
          • Process document
          • Resource
          • Temporary resource storage
          • Test utils common
          • Value resolvers
          • Valtimo dependencies
          • Valtimo dependency versions
          • Web
            • CORS
        • GZAC modules
          • Besluit
          • Besluiten API
          • Catalogi API
          • Contactmoment
          • Documenten API
          • Haalcentraal BRP
          • Klant
          • Notificaties API
          • Notificaties API Authentication
          • Objecten API
          • Objecten API Authentication
          • Object management
          • Objects API
          • Objecttypen API
          • OpenZaak
          • OpenZaak Plugin Authentication
          • OpenZaak resource
          • Portaaltaak
          • SmartDocuments
          • Valtimo GZAC dependencies
          • Verzoek
          • Wordpress mail
          • Zaken API
      • Compatibility matrix
  • Features
    • 🔏Access control
      • Configurable elements
      • Configuring roles
      • Configuring permissions
      • Configuring conditions
      • Configuring context conditions
      • For developers
        • Front-end access control
        • Creating a resource
        • Creating a relation to another resource
        • Running custom code without access control
    • đŸ—ƒī¸Case
      • Configuration
      • Document definition
      • List
      • Notes
      • Processes
      • Search fields
      • Statuses
      • Tabs
      • Tags
      • Widgets
        • Fields widget
        • Custom component widget
        • Form.io widget
        • Table widget
        • Collection widget
      • For developers
        • Search fields API
        • Case list tab order
        • Custom case list columns
        • Custom case tabs
        • Case migration
        • Custom case headers
        • Register Angular component
    • 📊Dashboard
      • Widget data sources
      • Widget display types
      • For developers
        • Custom dashboards
        • Custom data sources
        • Custom display types
        • Widget translations
    • 📋Forms
      • Creating FormIO forms in Valtimo
      • Interpolating data in Form.io
      • Configuring an Objecten API object form
      • For developers
        • Form field data resolver
    • 🔀Form flow
      • Creating a form flow definition
      • For developers
        • Custom form flow component
        • Whitelisting Spring beans for Form flow
    • 🌍Localization
      • For developers
    • Logging
      • For developers
    • âœ‰ī¸Outbox
      • For developers
    • 🔌Plugins
      • Configuring plugins
      • SmartDocuments plugin
      • Exact Plugin
      • For developers
        • Custom plugin definitions
    • ⭕Process
      • System processes
      • Correlating messages
      • Job service
      • For developers
        • Integrating spring beans in a process
        • Whitelisting Spring beans for Camunda
    • 🔗Process links
      • Creating a process link
      • Editing a process link
      • Unlinking a process link
    • ✅Tasks
      • Task list columns
    • đŸ”ĸValue resolvers
      • For developers
    • 📃ZGW
      • Documents
        • Access control
        • Uploading to Documenten API with metadata
      • Creating extra case tabs for Zaakobjects
      • ZGW plugins
        • Besluiten Plugin
        • Catalogi API plugin
        • Documenten API plugin
        • Object Token Auhentication Plugin
        • Objecten API Plugin
        • Objecttypen API Plugin
        • Open Zaak plugin
        • Portaaltaak Plugin
        • Verzoek Plugin
        • Zaken API plugin
  • Release notes
    • Release notes
    • 12.x.x
      • 12.0.0
        • Valtimo backend libraries
        • Valtimo frontend libraries
        • Migration
          • Spring Boot 3
      • 12.1.0
      • 12.2.0
      • 12.3.0
        • 12.3.1
      • 12.4.0
        • 12.4.1
      • 12.5.0
      • 12.6.0
        • 12.6.1
      • 12.7.0
        • 12.7.1
        • 12.7.2
      • 12.8.0
      • 12.9.0
      • 12.10.0
        • 12.10.1
        • 12.10.2
      • 12.11.0
      • 12.12.0
    • 11.x.x
      • 11.3.0
        • Valtimo backend libraries
        • Valtimo frontend libraries
      • 11.2.0 (RC)
        • Valtimo backend libraries
        • Valtimo frontend libraries
      • 11.1.5
        • Valtimo frontend libraries
      • 11.1.4
        • Valtimo backend libraries
        • Valtimo frontend libraries
      • 11.1.1
        • Valtimo backend libraries
        • Valtimo frontend libraries
      • 11.1.0
        • Valtimo backend libraries
        • Valtimo frontend libraries
      • 11.0.0
        • Valtimo backend libraries
        • Valtimo frontend libraries
        • Migration
    • 10.x.x
      • 10.8.3
        • Valtimo backend libraries
      • 10.8.2
        • Valtimo frontend libraries
      • 10.8.0
        • Valtimo backend libraries
        • Valtimo frontend libraries
      • 10.7.0
        • Valtimo backend libraries
        • Valtimo frontend libraries
      • 10.6.0
        • Valtimo backend libraries
        • Valtimo frontend libraries
        • Migration
      • 10.5.3
        • Valtimo backend libraries
      • 10.5.2
        • Valtimo backend libraries
      • 10.5.1
        • Valtimo backend libraries
        • Valtimo frontend libraries
      • 10.5.0
        • Valtimo backend libraries
        • Valtimo frontend libraries
        • Migration
      • 10.4.0
        • Valtimo backend libraries
        • Valtimo frontend libraries
      • 10.3.0
        • Valtimo backend libraries
        • Valtimo frontend libraries
      • 10.2.0
        • Valtimo backend libraries
        • Valtimo frontend libraries
      • 10.1.0
        • Valtimo backend libraries
        • Valtimo frontend libraries
        • Migration
      • 10.0.1
        • Valtimo frontend libraries
      • 10.0.0
        • Valtimo backend libraries
        • Valtimo frontend libraries
        • Migration
    • 9.x.x
      • 9.26.2/5.15.1
        • Valtimo backend libraries (9.26.2)
        • Migration
      • 9.26.1/5.15.1
        • Valtimo backend libraries (9.26.1)
        • Valtimo frontend libraries (5.15.1)
      • 9.26.0/5.15.0
        • Valtimo backend libraries (9.26.0)
        • Valtimo frontend libraries (5.15.0)
        • Migration
      • 9.25.0/5.14.0
        • Valtimo backend libraries (9.25.0)
        • Valtimo frontend libraries (5.14.0)
      • 9.24.0/5.13.0
        • Valtimo backend libraries (9.24.0)
        • Valtimo frontend libraries (5.13.0)
      • 9.23.0/5.12.0
        • Valtimo backend libraries (9.23.0)
        • Valtimo frontend libraries (5.12.0)
      • 9.22.0/5.11.0
        • Valtimo backend libraries (9.22.0)
        • Valtimo frontend libraries (5.11.0)
        • Migration
      • 9.21.0/5.10.0
        • Valtimo backend libraries (9.21.0)
        • Valtimo frontend libraries (5.10.0)
        • Migration
      • 9.20.0/5.9.1
        • Valtimo backend libraries (9.20.0)
        • Valtimo frontend libraries (5.9.1)
        • Migration
      • 9.19.0/5.8.0
        • Valtimo backend libraries (9.19.0)
        • Valtimo frontend libraries (5.8.0)
        • Migration
      • 9.18.0/5.6.0
        • Valtimo backend libraries (9.18.0)
        • Valtimo frontend libraries (5.6.0)
        • Migration
      • 9.17.0/5.5.0
        • Valtimo backend libraries (9.17.0)
        • Valtimo frontend libraries (5.5.0)
      • 9.16.0/5.4.0
        • Valtimo backend libraries (9.16.0)
        • Valtimo frontend libraries (5.4.0)
  • Running Valtimo
    • Application configuration
      • Temporary file-storage
      • Configuring CORS
      • REST API endpoint security test
      • Content Security Policy (CSP)
      • Configuring Keycloak
      • Temporary file storage
      • Feature toggles
  • Customizing Valtimo
    • Front-end customization
      • Customizing Carbon theme
      • Custom logo
      • Custom components
        • Custom case management tab
  • Contributing to Valtimo
    • Contributing to Valtimo
    • Docs style guide for contributing
    • Branching and release strategy
    • Extend the core or build a plugin
Powered by GitBook
On this page
  • How does the plugin work
  • Configure the plugin
  • Configuring the task completion process
  • Custom process
  • Available actions
  • Create Portaaltaak
  • Complete Portaaltaak

Was this helpful?

  1. Features
  2. ZGW
  3. ZGW plugins

Portaaltaak Plugin

PreviousOpen Zaak pluginNextVerzoek Plugin

Last updated 10 months ago

Was this helpful?

The Portaaltaak plugin is used to generate "taak" (task) objects within the Objecten API for a BPMN user task. These tasks can then be completed via external applications, such as the NL Portal. This feature empowers Valtimo to assign certain tasks to other systems that are more adept at performing these specific tasks. Furthermore, it enables users who lack access to the Valtimo frontend to access these tasks.

How does the plugin work

The lifecycle of a portaaltaak is as follows:

  1. When a process instance reaches a user task configured with the action an instance of the task is created in Valtimo as usual. Additionally, a taak object is created in the Objecten API of object type Taak. The status of the taak object will be open. The taak object includes information on who the intended recipient is. This is the person or organization that is supposed to complete the task.

  2. External applications, such as the NL Portal, can retrieve the task information and offer a way to complete the task. Often this will be a form to input data.

  3. When the user completes the task in the external system, this system will update the taak object with the new data and change the status in the object to ingediend.

  4. The Objecten API should send a notification to the Notificaties API indicating the object has been updated.

  5. Valtimo should be subscribed to notifications from the Notificaties API as part of the plugin setup and will receive the notification. When an update notification for a taak object is received Valtimo will check the status. If this is set to ingediend the updated data from the taak object will be stored based on the value resolver configuration, and the handling process will be started.

  6. As part of the handling process the action should be used. This action will complete the task in Valtimo and update the zaak object status to verwerkt, indicating the taak has been processed.

Configure the plugin

A plugin configuration is required before the plugin can be used. A general description on how to configure plugins can be found .

If the Portaaltaak plugin is not visible in the plugin menu, it is possible the application is missing a dependency. Instructions on how to add the Portaaltaak Plugin dependency can be found .

To configure this plugin the following properties have to be entered:

  • Notification API plugin (notificatiesApiPluginConfiguration). Reference to another plugin configuration that will be used to receive notification on updates to objects. This is needed for completing tasks of which the status has been updated.

  • Object management configuration (objectManagementConfigurationId). Reference to the object management configuration that can be used to store the taak objects. If no option is available in this field, an object management configuration has to be created first.

  • Process to complete Portaaltaak (completeTaakProcess). Reference to the process that will be started to handle completion of tasks. This can do additional steps like handling the file attachments. A process task should be configured in this process definition to handle the completion itself. This can be done using the plugin action. The process 'Process completed Portaaltaak' that is shipped with Valtimo can be used here. See on how to set up this process.

Configuring the task completion process

When a task object is updated and Valtimo receives the notification, a process is started to handle additional steps needed for completing the task. Because the task can only be considered completed when all other processing of data has happened, the actual completion of the task in the BPMN engine is also part of the plugin action that should be configured in this process.

The process that is started needs to be configured in the plugin properties by setting the 'Uploaded documents handler process' property. Valtimo ships with the Process completed Portaaltaak process which has two tasks.

These tasks need to be configured with process links before the process can be used. The following actions should be configured:

Custom process

Instead of using the Process completed Portaaltaak process it is possible to create another process that will handle task completion in a different way. The process is started with a few process variables that can be used when designing another process definition. These variables are:

  • portaalTaakObjectUrl. The URL of the taak object.

  • objectenApiPluginConfigurationId. The id of the Objecten API plugin configuration that can be used to get or edit the taak object.

  • verwerkerTaakId. The id of the task to be completed.

  • documentUrls. A list of document URLs of documents stored in the Documenten API. Can be used as Collection in BPMN multi-instance elements to iteratte over the list.

Available actions

The portaaltaak plugin supports the following actions that can be configured in process links in order to create and complete user tasks through external systems like the NL Portal.

Create Portaaltaak

The Create portal taak action is linked to a user task that can be completed in an external system. A taak object is created when the task is reached, in the Objecten API as configured for the object management configuration referenced in the plugin configuration.

When creating a process link the following properties have to be entered:

  • Form type. The type of form to be used for completing the user task. Options are:

    • Form definition. Use a form definition that the receiving system is supposed to understand

    • URL' when using. a url to the form definition.

  • Formulier ID. The identifier of the form in the receiving system. Field is only available when using form type 'Form definition'.

  • Formulier URL. The URL of the form definition. Field is only available when using form type 'URL'.

  • Task data for the recipient. The data in Valtimo that is relevant to the task and should be included for prefilling in the task form. This fills a json object of data in the taak object. Every key is a json pointer to the property in the taak object data. The value is a value resolver string that is used to fill the property.

  • Information entered by the recipient. This is the mapping used to transfer the data received in the taak back to the case. Every key is a value resolver string that is used to update the data in Valtimo. The corresponding value is a json pointer to the property in the taak object that contains the data.

  • Receiver. Indicates how to find the recipient of the task. Options are:

    • Case initiator. Use the user that is linked by the zaak rol as the initiator of the case.

    • Other. Manually select a recipient.

  • Identification key. Indicates what kind of recipient the task has. Required when choosing receiver type 'Other'. For example 'bsn' can be used to identify a user where BSN is the key.

  • Identification value. Indicates which user is the recipient of the task. Required when choosing receiver type 'Other'. For example when Identification key 'bsn' is used, the value could be '059861095' to indicate that is the BSN of the user.

  • Number of days for the task to expire. The number of days from the creation time until the task expires. This will only be used in the portaaltaak. The BPMN due date needs to be configured separately.

Complete Portaaltaak

The Complete Portaaltaak action should be used in the Process to complete Portaaltaak to do the last step in handling the update from the objects API. When executed it will complete the user task and update the status of the taak object to verwerkt. After this plugin action has been selected, the user does not have to input any configuration data.

An example plugin configuration:

Link document to zaak - in the Zaken API plugin

Update Portaaltaak Status - in the Portaaltaak plugin

A general description on how to create process links can be found .

An example process link configuration:

📃
here
here
here
Create Portaaltaak
Complete Portaaltaak
Complete Portaaltaak
this section
Complete Portaaltaak
Link document to zaak
Process completed Portaaltaak
img.png