Module 5

Add confirmation step

In this module you are adding a process step in the application.

Topics covered in this module:

  • Process
  • Confirmation step
  • Authorization rules
  • Validation
  • Replace standard texts

Tasks

An Altinn App has a process flow that describes the different steps in the flow. The standard flow for a newly created application consists of one task; the fill out step.

Standard process flow illustrated

Your task is to expand the standard process flow with a confirmation step as illustrated below. The confirmation page is added automatically when the step is added to the BPMN file.

Updated process flow illustrated

Standard process flow is available on GitHub. Can you find the one that matches the flow we wish to achieve here?

If you want an extra challenge you can edit the process flow manually or in a BPMN editor, using the template for process flow with data and confirmation step as an inspiration.

Requirements from the municipality

At this point in the workflow, the user should be able to:

  1. View an overview of the data entered
  2. Exit the workflow without submitting the form
  3. Exit the workflow and submit the form

Useful documentation

Knowledge check

  • Which Altinn-specific traits are on every process task?
  • Which limitations would an external BPMN editor have when editing the process description of an Altinn app?
  • Is it possible for the process flow to go both ways? From filling in to confirmation and from confirmation to filling in?

Your application’s policy file is adapted to a standard process flow. Update the policy file so that the authorization rules cover the new process step.

Requirements from the municipality

  • The same role requirements should apply to both fill out and confirm an instance.

Useful documentation

Knowledge check

  • What will happen when the process flow proceeds to the confirmation step without the authorization rules being updated?
  • What happens if you don’t specify which roles are allowed to perform an action in an authorization rule?

Requirements from the municipality

  • It should only be possible for the user who owns the instance to submit the form, even if others may hold the necessary roles.

Useful documentation

Knowledge check

  • Which change could be made to meet this requirement without adding custom validation at this step?

Requirements from the municipality

The user should be presented with the following text before submitting the form.

Du er nå klar for å sende inn melding om tilflytting til Sogndal kommune.

Ved å sende inn dette skjemaet samtykker du til at dataen du har fylt ut kan lagres og benyttes
til å tilpasse kommunens tilbud til deg de neste 18 månedene.

Før du sender inn vil vi anbefale å se over svarene dine. Du kan ikke endre svarene etter at du har sendt inn.

Useful documentation

Summary

In this module you have expanded the application with a confirmation step, customized the view and implemented validation and authorization rules attached to the process step.

The service should be able to run on your local computer with local test and you should be able to test the new process step and confirm that the view is as desired.

Remember to push your local changes, so that they are available in Altinn Studio when you’re happy with them

Solution

If you did not manage to complete all the steps, we have an example solution that you can use as inspiration.

Screenshot of confirmation page

Screenshot of confirmation page