Die Besonderheit einer Multi-Select-Akteneigenschaft liegt darin, dass sie mehrere Werte gleichzeitig annehmen kann. Die Anlage von Akteneigenschaften und deren Typen wird im Artikel Akteneigenschaften näher ausgeführt.
Die Reihenfolge, in welcher die selektierten Felder hinzugefügt werden, wird dabei ebenfalls abgespeichert. Für das Auslesung der Werte spielt die Reihenfolge jedoch keine Rolle.
1. Multi-Select-Wert per HTML-Variable auslesen
Sie können im HTML-Editor im Kapitel „Akteneigenschaften“ das von Ihnen erstellte und benannte Multi-Select-Feld auswählen und als Platzhalter in Ihren Textbaustein einfügen. Im folgenden Beispiel heißt die angelegte Akteneigenschaft „Multi-Select-Test“:
Um ein Leerzeichen zwischen die damit ausgelesenen Werte einzufügen, fügen Sie der Variable am Ende | join “ „ hinzu. Die HTML-Variable sieht beispielhaft dann so aus:
{{Akteneigenschaften.Multi-Select-Test| join: " "}}
Sie können im Befehl an Stelle des Leerzeichens in den Anführungszeichen auch einen beliebigen Text eintragen, der jedes Mal vor dem jeweils nächsten Multi-Select-Eintrag eingefügt wird, z.B. um die Einträge durch ein „,“ (Komma) oder ein „und“ zu trennen.
2. Spezifische Werte per HTML-Variable auslesen
Wie oben bereits erwähnt, wird auch die Reihenfolge der ausgewählten Multi-Select-Felder gespeichert. Dem ersten ausgewählten Wert wird die 0 zugeordnet, dem zweiten ausgewählten Wert die 1, dem dritten Wert die 2, etc.
Im obigen Beispiel wird der ausgewählte Wert „Variante a)“ also der 0 zugeordnet. „Variante c)“ wird der 1 zugeordnet.
Das erste ausgewählte Feld kann also mit [0] im Befehl abgerufen werden, das zweite Feld mit [1], die anderen Felder mit auf die gleiche Weise (Feld-Nummer – 1 in eckigen Klammern).
Hier ein Beispiel zur Verdeutlichung:
Wenn, wie im Beispiel oben zwei von drei Multi-Select-Feldern ausgewählt sind, jedoch das dritte Feld mit {{Akteneigenschaften.Multi-Select-Test[2]}} ausgelesen werden soll, bleibt die Ausgabe leer.
3. Multi-Select-Variablen in Bedingungen
Die Multi-Select-Eigenschaften können zusätzlich dazu auch mit einem IF-Block kombiniert werden.
Als Beispiel hier eine Funktion, die einen vorgegebenen Text, wenn ein bestimmtes Multi-Select-Feld ausgewählt ist:
{% if Akteneigenschaften.Multi-Select-Test contains "Variante a)" %}
Bestimmter Text, wenn Variante a) ausgewählt wurde!
{% endif %}
In dem Befehl wird in der IF-Abfrage die Funktion contains benutzt. Diese Funktion überprüft, ob das Nachstehende, in diesem Fall „Variante a)“, auch ausgewählt wurde. Wenn ja, wird der Text innerhalb des IF-Blocks ausgegeben, andernfalls bleibt die Ausgabe leer:
Es gibt auch die Möglichkeit, die Abfragen miteinander zu kombinieren. Die Kombination kann durch and oder or durchgeführt werden.
Hierbei gilt es folgendes zu beachten:
Wenn „and“ genutzt wird, müssen alle abgefragten Felder ausgewählt sein.
{% if Akteneigenschaften.Multi-Select-Test contains "Variante a)" and Akteneigenschaften.Multi-Select-Test contains "Variante c)" %}
Variante a) und Variante c) sind angekreuzt!
{% endif %}
Wenn „or“ genutzt wird, reicht es, wenn nur eins der Felder ausgewählt ist.
{% if Akteneigenschaften.Multi-Select-Test contains "Variante b)" or Akteneigenschaften.Multi-Select-Test contains "Variante c)" %}
Variante b) oder Variante c) sind angekreuzt!
{% endif %}
4. Fortgeschritten: Verwendung in FOR-Schleifen
Eine weitere praktische Methode ist das Iterieren über die ausgewählten Multi-Select-Felder. Mit anderen Worten wird in einer FOR-Schleife jedes ausgewählte Multi-Select-Feld der Reihenfolge nach ausgelesen. Innerhalb der Schleife kann an Stelle des üblichen Befehls mit {{Feld}} auf die Akteneigenschaft zugegriffen werden. Die Bezeichnung „Feld“ kann dabei beliebig gewählt werden, Feld ist in diesem Beispiel der gewählte Name.
{% for Feld in Akteneigenschaften.Multi-Select-Test %}
{{Feld}}
{% endfor %}
Der obige Befehl erzeugt in diesem Beispiel folgende Ausgabe:
Bei Verwendung einer IF-Abfrage innerhalb der FOR-Schleife empfiehlt sich nicht die Nutzung von „contains“, wie oben beschrieben, sondern der direkte Abgleich des momentanen Wertes mittels ==.
Anders gesagt: Verwenden Sie „contains“ für Listen mit mehreren Elementen, und „==“ für einzelne Werte.
Da in der FOR-Schleife dem „Feld“ der aktuelle Wert des Multi-Select-Feldes einzeln zugeordnet wird, sollte die direkte Abfrage mit == in etwa so aussehen:
{% for Feld in Akteneigenschaften.Multi-Select-Test %}
{% if Feld == "Variante c)" %}
Variante c ist ausgewählt.
{% else %}
Eine andere Variante war ausgewählt.
{% endif %}
{% endfor %}
Die Implementierung von FOR-Schleifen und IF-Blöcken ist eine Kombination aus jur|nodes-Befehlen und den Befehlen der verwendeten Liquid-Template Programmiersprache. Eine Übersicht zu Schleifen und anderen verwendeten Liquid-Befehlen zum Einlesen für Fortgeschrittene finden Sie hier: Iteration – Liquid template language oder in unserer internen Übersicht: HTML-Bausteine.