Registrierungsregeln

Registrierungsregeln definieren automatisierte Aktionen, die ausgeführt werden, wenn Nutzerdaten in der imc Learning Suite gespeichert werden. Sie dienen dazu, Nutzerinformationen anzureichern, Zuweisungen wie Gruppen, Mandanten, Zertifizierungen oder Jobprofile zu verwalten und auf Basis definierter Bedingungen automatisch Zugriffsrechte zu vergeben.

Alle Einstellungen zu Registrierungsregeln werden im LMS verwaltet. Verweise auf eine frühere dateibasierte Speicherung außerhalb der Anwendung sind für diese Funktionsbeschreibung nicht mehr relevant.

Registrierungsregeln werden typischerweise angewendet, wenn ein Nutzerprofil manuell erstellt oder aktualisiert wird, wenn Nutzerdaten durch einen Import verarbeitet werden, oder wenn Nutzerinformationen über verbundene Interfaces aktualisiert werden.

Zweck und Nutzen

Registrierungsregeln unterstützen die Automatisierung wiederkehrender administrativer Logik. Dies reduziert manuellen Aufwand und trägt dazu bei, dass nutzerbezogene Einstellungen konsistent angewendet werden.

Nutzerattribute können automatisch auf Basis anderer Attribute gesetzt werden.
Nutzer können automatisch organisatorischen Einheiten wie Gruppen, Mandanten, Zertifizierungen oder Jobprofilen zugewiesen werden.
Freigaben können automatisch für definierte Nutzer, Gruppen, Mandanten, Führungskräfte oder Eigentümer vergeben werden.
Die Regeln werden in der Reihenfolge ihrer Definition sequenziell verarbeitet.

Wo Registrierungsregeln verwaltet werden

Registrierungsregeln werden im LMS konfiguriert. Je nach Szenario können sie in der Konfiguration von Imports und verwandten Verwaltungsbereichen innerhalb des Systems gepflegt werden.

Werden Nutzerimporte verwendet, können Registrierungsregeln zusätzlich mit der entsprechenden Importkonfiguration verknüpft werden, sodass die definierte Logik während der Verarbeitung angewendet wird.

Aufbau von Registrierungsregeln

Eine Registrierungsregel besteht aus vier logischen Bausteinen.

Baustein	Zweck
Rule	Definiert eine logische Verarbeitungseinheit.
Condition	Legt fest, ob die Befehle der Regel ausgeführt werden.
Command	Definiert die Aktion, die ausgeführt wird, wenn die Bedingung als wahr ausgewertet wird.
Hashtable	Stellt eine Wertzuordnung für Befehle bereit, wenn ein Eingabewert in einen Ausgabewert übersetzt werden muss.

Es können mehrere Regeln definiert werden. Jede Regel kann eine oder mehrere Bedingungen sowie einen oder mehrere Befehle enthalten. Ist eine Wertzuordnung erforderlich, kann ein Hashtable vom entsprechenden Befehl referenziert werden.

Die Bestandteile einer Regel werden sequenziell gelesen. Die Reihenfolge der Definition ist daher für das Endergebnis relevant.

Ausführungslogik

Registrierungsregeln werden immer dann ausgeführt, wenn ein Nutzerprofil gespeichert wird. Dazu zählen typischerweise folgende Ereignisse:

manuelle Erstellung eines Nutzers
manuelle Aktualisierung eines Nutzers
importbasierte Verarbeitung von Nutzerdaten
interfacebasierte Aktualisierung von Nutzerdatensätzen

Da Regeln beim Speichern ausgeführt werden, sollte das resultierende Verhalten stets zusammen mit der Quelle und Häufigkeit der jeweiligen Nutzeraktualisierungen betrachtet werden.

Bedingungen

Bedingungen wirken als Filter. Ein Befehl wird nur dann ausgeführt, wenn die Bedingung der Regel als wahr ausgewertet wird.

Die folgenden logischen Bedingungstypen stehen zur Verfügung:

andCondition – alle enthaltenen Bedingungen müssen als wahr ausgewertet werden
orCondition – mindestens eine der enthaltenen Bedingungen muss als wahr ausgewertet werden
notCondition – die enthaltene Bedingung muss als falsch ausgewertet werden

Jede Bedingung kann Attribute wie den zu prüfenden Ausdruck, den Vergleichsoperator, den Vergleichswert und, falls erforderlich, den Modus oder das Listentrennzeichen verwenden.

Unterschiedliche Bedingungstypen können nicht beliebig ineinander verschachtelt werden. Ist komplexere Logik erforderlich, sollte sie auf mehrere Regeln aufgeteilt werden.

Vergleichsoperatoren

Die verfügbaren Vergleichsoperatoren bestimmen, wie der Ausdruck ausgewertet wird.

Unterstützte Vergleichsoperatoren anzeigen

EQUAL – true if expression equals value
UNEQUAL – true if expression does not equal value
GREATER – true if expression is greater than value
SMALLER – true if expression is smaller than value
ISEMPTY – true if no value exists
ISNOTEMPTY – true if a value exists
EXISTS – true if the referenced attribute exists
NOTEXISTS – true if the referenced attribute does not exist
HASELEMENT – true if a list contains the defined value
INLIST – list comparison similar to HASELEMENT
HASSUBSTRING – true if the value is contained in the expression
STARTSWITH – true if the expression starts with the value
ENDSWITH – true if the expression ends with the value

Ist ein Attribut mit einer Auswahlliste verknüpft, erfolgt der Vergleich anhand der Objekt-ID und nicht anhand des angezeigten Schlüssels.

Befehle

Befehle legen fest, welche Aktion ausgeführt wird, wenn die Bedingung der Regel erfüllt ist.

Set Command

Der Set Command schreibt einen Wert in ein Attribut. Es können sowohl System- als auch benutzerdefinierte Attribute angesprochen werden.

die Sprache kann aus dem Land abgeleitet werden
der Hauptmandant kann automatisch gesetzt werden
Standardwerte können auf Nutzer angewendet werden, die definierte Bedingungen erfüllen

Assign Command

Der Assign Command erstellt Zuweisungen für den Nutzer. Je nach Kontext kann dies Gruppen, Mandanten, Zertifizierungen oder Jobprofile umfassen.

Der Ausführungsmodus ist besonders relevant:

ONCE – die Zuweisung wird einmalig ausgeführt, vergleichbar mit einer manuellen Zuweisung
ALWAYS – die Zuweisung wird als importgesteuert behandelt und bei späteren Ausführungen erneut angewendet

Erweiterte Zuweisungstypen können auch für organisatorische Beziehungen wie Vorgesetzte oder Vertretung verwendet werden, sofern das entsprechende Szenario dafür konfiguriert ist.

Grant Command

Der Grant Command legt fest, welche Nutzer oder organisatorischen Einheiten Freigaben auf den erstellten oder aktualisierten Nutzer erhalten.

Je nach Kontext können Freigaben vergeben werden an:

bestimmte Nutzer
Gruppen
Mandanten
Führungskraft-Beziehungen
Eigentümer-Beziehungen

Freigabestufen können entweder über vordefinierte Schlüsselwörter wie _view und _full oder über Dezimalwerte bereitgestellt werden, sofern eine genauere Zugriffsdefinition erforderlich ist.

Hashtables

Hashtables werden verwendet, wenn ein Eingabewert in einen anderen Wert übersetzt werden muss, bevor ein Befehl ausgeführt wird.

Typische Beispiele sind die Zuordnung von:

Land zu Gruppen-ID
Land zu Zeitzone
externem Quellwert zu interner Auswahllisten-ID

Ein Hashtable enthält eine Kennung, einen Standardwert und eine oder mehrere Zuordnungen. Der Standardwert wird immer dann angewendet, wenn der Eingabewert keiner definierten Zeile entspricht.

Hashtable-Zeilen

Statische Zuordnungen können direkt über Zeilen definiert werden. Jede Zeile enthält einen Eingabewert und einen Ausgabewert.

SQL-basierter Hashtable-Lookup

Ein Hashtable kann seinen Ausgabewert auch über eine SQL-Anweisung abrufen. In diesem Fall übergibt der Befehl einen Eingabewert an den Hashtable, und die Abfrage liefert genau ein Ergebnis zurück.

In einer SQL-basierten Hashtable-Anweisung ist nur ein Platzhalter zulässig. Die Anweisung muss genau einen Wert zurückgeben.

Wird ein Hashtable verwendet, muss er vor den Regeln definiert werden, die ihn referenzieren.

Typische Anwendungsfälle

automatische Zuweisung zu einer länderspezifischen Lerngruppe
automatisches Setzen des Hauptmandanten, falls kein Mandant angegeben ist
automatische Zuweisung einer Zertifizierung zu als relevant markierten Nutzern
automatische Vergabe von Anzeige- oder Bearbeitungsrechten auf Basis organisatorischer Daten
automatische Zuweisung von vorgesetztenbezogenen Gruppenrollen

Regeln und Einschränkungen

Regeln werden sequenziell verarbeitet.
Bedingungen unterschiedlicher logischer Typen können nicht frei ineinander verschachtelt werden.
Mehrfachverneinungen sollten in der Regel mit einer and-Bedingung und UNGLEICH-Vergleichen modelliert werden.
Auswahllistenbasierte Prüfungen verwenden interne Objekt-IDs.
Das Verhalten von ONCE und ALWAYS sollte insbesondere in Importszenarien sorgfältig gewählt werden.
Der Standardwert eines Hashtable ist verpflichtend und sollte mit Sorgfalt definiert werden.

Für wartbare Konfigurationen sind einfache Regeln mit klar getrennter Logik hochgradig verdichteten Regelwerken in der Regel vorzuziehen.

Praktische Überlegungen zur Prüfung

Bevor eine Regel im produktiven Einsatz aktiviert wird, sollten folgende Aspekte geprüft werden:

welches Ereignis den Nutzer speichert und damit die Regel auslöst
ob die Quellwerte im erwarteten Format geliefert werden
ob referenzierte IDs im Zielmandanten oder -kontext existieren
ob eine wiederholte Ausführung vorherige Zuweisungen erhalten oder überschreiben soll
ob Fallback-Werte in Hashtables zu einem gültigen Ergebnis führen