Using Translatable Validation Messages

1 Introduction

Setting up validation rules should be relatively straightforward. For each object or process, you want to have a single microflow that is in charge of the validation. That microflow has the required input parameters and validates all values. If a value is invalid, the microflow will execute the Validation feedback activity. When completing the microflow, it will return a Boolean value (true/false) depending on whether the object has been successfully validated.

These types of validation actions should be used throughout your app.

However, you will often run into situations where you need to be able to show or process your validation rules in a different way than just giving validation feedback. One option that gives you more control is building one large string message variable. The validation microflow should return that message. If anything has been returned, the object is invalid.

Or if you need to differentiate between the different validation messages, you can also build a list of (non-)persistable objects. Instead of appending a message, you should create an object and add the object to a list. Also take a look at the validation best practices.

2 Simple Alternative for Translating Messages

There is one big problem with this second solution: you loose the ability to translate your validation message. String variables or attributes cannot be translated by the platform. If you only have a handful of these types of validation rules, you might want to consider modeling out all language combinations. For each validation message, you have to add decisions and activities per language. This could become a lot of work, but as long as you only have to do this at a couple of places, it might not worth the time to use the more complicated solution described in the next section.

3 Translating Validation Rules

If you have to translate multiple validation rules, it it worth it to develop a more advanced validation module which supports you in your maintenance of all these rules and messages.

Prepare a validation entity in the domain model:

Create an enumeration containing all validation messages:

Reference the model below for messages you should store in the entity:

The GetI18NText microflow validates and acquires the text like this. This is done to prevent any nullpointers in case of incorrect modeling.

The text is replaced by this microflow. The input includes the translated text, the variable (parameter) text you want to add to the text, and the token number to indicate the position (as in, {1}, {2}, {3}).