Systemvariablen

Systemvariablen sind für die dynamische Verwendung von z.B. Attributen unumgänglich. Im Folgenden werden diese erklärt und durch gängige Beispiele veranschaulicht.

Erklärung

Systemvariablen sind ein technischer Schlüssel, mit denen bestimmte Objekte innerhalb des Systems ausgegeben werden können.

Beispiel: system.user bezieht sich auf Benutzer im System.

Bei der Zusammensetzung dieser Schlüssel entsteht ein Pfad durch das System.

Beispiele:

• system.user.role bezieht sich auf das Benutzerrecht eines Benutzers

• system.user.role.department bezieht sich auf die Benutzergruppe, der ein Benutzer durch sein Benutzerrecht angehört

Durch diese Form der Zusammensetzung können unterschiedliche Informationen innerhalb des System abgerufen werden, sodass diese z.B. für vorausgefüllte Werte oder die Zuweisung innerhalb von Aktionen benutzt werden können.

Wo finden Systemvariablen Verwendung

Systemvariablen können an folgenden Punkten in der Software eingesetzt werden:

• Für vorausgefüllte Werte für Formular- und Aufgabenfelder

• Für Verwendung in Aufgaben- und Formularaktionen in

  • Aktions-Bedingungen

  • Zuweisungen für Folgeaufgaben und Benachrichtigungen

  • Beschreibungstexte für Folgeaufgaben

  • Inhalt von Benachrichtigungen

An den genannten Punkten werden die richtigen Schlüssel bei Auswahl der Option "Benutzerdefinierte Systemvariablen" und "Attribut der Benutzergruppe" oder "Attribut des Benutzerrechts" bereits voreingestellt und müssen nur für den speziellen Anwendungsfall ergänzt werden.

Anpassung der Standard-Schlüssel

Ein möglicher voreingestellter Schlüssel für z.B. Attribute aus Benutzergruppen lautet:

system.user.role.department.additional_attributes.YOUR_SET_KEY.YOUR_FIELD_ID.resolved_value

Ein möglicher Schlüssel für Attribute aus Benutzerrechten lautet:

system.user.role.additional_attributes.YOUR_SET_KEY.YOUR_FIELD_ID.resolved_value

In beiden Fällen müssen die groß geschriebenen Ausdrücke YOUR_SET_KEY und YOUR_FIELD_ID noch durch die individuellen Informationen ergänzt werden. Diese finden sich in der Bearbeitungsmaske eines Attributsatzes.

Vorausgefüllte Felder mit Werten aus Attributen

Für das Verwenden von Attributen in vorausgefüllten Feldern weichen die Schlüssel je nach Feldtyp ab. Dieser Schlüssel ist per Default für jeden Feldtyp bereits korrekt hinterlegt.

Für ein Auswahlfeld lautet der Schlüssel für ein Attribut einer Benutzergruppe z.B.

system.user.role.department.additional_attributes.YOUR_SET_KEY.YOUR_FIELD_ID.request_value

Hier müssen lediglich die groß geschriebenen Ausdrücke YOUR_SET_KEY und YOUR_FIELD_ID ausgetauscht werden, sodass die Werte aus dem hinterlegten Attribut übernommen werden.

Gängige Beispiele

Nr.	Beschreibung	Schlüssel
1	In einem Auswahlfeld (Objekte) einer Aufgabe oder eines Formulars wird eine Benutzergruppe ausgewählt. Eine bestimmte Person, die bei der Benutzergruppe in den Attributen hinterlegt ist, soll durch eine Aktion eine Folgeaufgabe zugewiesen bekommen. (Bsp.: Der Bezirksleiter einer Filiale)	field.YOUR_FIELD_ID.resolved_value.additional_attributes.YOUR_SET_KEY.YOUR_FIELD_ID.resolved_value Erklärung: YOUR_FIELD_ID wird durch die ID des Feldes ersetzt, in dem die Benutzergruppe ausgewählt wird. YOUR_SET_KEY und YOUR_FIELD_ID werden wie oben beschrieben durch die Informationen aus dem Attributsatz ersetzt. Dieser Schlüssel wird dann als Systemvariable in der Aufgabenzuweisung der Aktion verwendet.
2	Ergänzend zu Nr. 1 soll nun auf ein Attribut bei der zuerst angesteuerten Person zugegriffen werden. (Bsp.: Der Chef des Bezirksleiters)	field.YOUR_FIELD_ID.resolved_value.additional_attributes.YOUR_SET_ID.YOUR_FIELD_ID.resolved_value.role.additional_attributes.YOUR_SET_ID.YOUR_FIELD_ID.resolved_value Erklärung: Wie in Nr. 1 müssen hier alle groß geschriebenen Ausdrücke ersetzt werden.
3	Wenn das Attribut einer Benutzergruppe einen bestimmten Wert hat, soll eine spezielle Folgeaufgabe oder Benachrichtigung ausgelöst werden. (Bsp.: Die Filiale hat in den Attributen den Wert "Sonntagsfiliale" hinterlegt und deshalb sind andere Folgeaufgaben nötig.)	Der Schlüssel aus Nr. 1 wird an der Stelle ebenfalls benutzt, nur wird dieser nicht für die Zuweisung einer Folgeaufgabe verwendet, sondern als Bedingung einer Aktion.