Administration - Workflows
Allgemeines

Workflows dienen der Automatisierung von Aktionen, welche ausgeführt werden, sobald bestimmte Bedingungen erfüllt sind. Die Bedingungen beziehen sich dabei auf Attribute von Configuration Items (CIs / Tickets), die einer CI-Kategorie oder einem CI-Typ angehören, der beim Anlegen des Workflows festgelegt wird. Die konfigurierten Workflows können sowohl ereignis- als auch zeitgesteuert ausgelöst werden. Zur Konfiguration der Workflows steht ein grafischer Workflow-Editor zur Verfügung, mit dem die Elemente (Bausteine) der Workflows per Drag-and-Drop angeordnet und zum Regelwerk verbunden werden können.
Die Art der Auslösung entscheidet darüber, welche CIs ein Lauf erfasst:
Ein zeitgesteuerter Workflow verarbeitet bei jedem Lauf alle aktiven CIs der beim Anlegen referenzierten CI-Kategorie bzw. des referenzierten CI-Typs einschließlich der darunter liegenden Ebenen. Der Ausführungsplan legt nur den Zeitpunkt des Laufs fest, nicht dessen Umfang.
Ein ereignisgesteuerter Workflow verarbeitet nur das CI, dessen Anlegen oder Ändern ihn ausgelöst hat.
Welche der erfassten CIs tatsächlich verändert werden, entscheiden erst die Bedingungsbausteine. Dauerhaft vom Durchlauf ausgenommen sind nur zwei Gruppen: deaktivierte CIs, die ein zeitgesteuerter Lauf gar nicht erst lädt, und CIs mit einem Eintrag des Bedingungs-Trackings, die von folgenden Läufen desselben Workflows übersprungen werden.
Hinweis
Aktionen können in zwei Situationen entstehen: Die CIs sind mit ihren Attributwerten bereits vorhanden, und erst das Erstellen/Aktivieren eines Workflows führt zu Aktionen – oder die Workflows sind bereits erstellt/aktiviert, und die CIs werden danach angelegt oder verändert. Beide Fälle sind bei der Planung und Umsetzung von Workflows zu berücksichtigen. Insbesondere bei den systemseitig bereitgestellten WF-Triggern ist in diesem Zusammenhang zwischen den "Create"- und den "Update"-Triggern zu unterscheiden.
Workflow-Übersicht
Die Workflow-Übersicht zeigt alle definierten Workflows in Tabellenform. In der Übersicht werden neue Workflows erstellt sowie bestehende Workflows bearbeitet oder gelöscht. Außerdem lassen sich hier ein oder mehrere Workflows (Mehrfachselektion) direkt aktivieren oder deaktivieren.
Die Liste ist über Administration > Workflows > Workflow-Übersicht erreichbar.

Die Spalte "Aktiv" zeigt, ob der Workflow von der Workflow-Engine berücksichtigt wird. "Geplant" kennzeichnet Workflows mit einem Ausführungsplan; nur für diese sind "Letzte Ausführung" und "Nächste geplante Ausführung" gefüllt. Die Spalte "Aktivierbar" kennzeichnet Workflows, die in sich vollständig sind; nur für diese erscheinen die Schaltflächen "Aktivieren" und "Deaktivieren". Die Spalte "Version" erhöht dot4 bei jedem Speichern eines bestehenden Workflows um eins; Version und "Workflow ID" erscheinen auch im Workflow-Log und ordnen einen Log-Eintrag damit einem bestimmten Konfigurationsstand zu. Über die Spaltenauswahl in der Werkzeugleiste lassen sich die standardmäßig ausgeblendeten Spalten "Erstellt durch", "Erstellt am", "Letzte Aktualisierung durch" und "Letzte Aktualisierung am" einblenden. Die Spalten "Aktivierbar" und "Workflow-Trigger" sind bereits eingeblendet, liegen in der Abbildung aber rechts außerhalb des sichtbaren Bereichs; sichtbar werden sie durch waagerechtes Scrollen oder durch Anpassen der Spaltenbreiten.
Hinweis
Durch die Workflow-Engine werden nur aktive Workflows berücksichtigt.
Hinweis
Bei einer großen Menge an Workflows empfiehlt sich die Filter-Option in der Übersichtstabelle, insbesondere auf CI-Kategorie / CI-Typ. Beispielsweise kann mit der Option "Beginnt mit" auch auf alle Workflows gefiltert werden, die unterhalb einer CI-Kategorie liegen.
Allgemeines zur Erstellung von Workflows
Beim Erstellen eines neuen Workflows wird die CI-Kategorie bzw. der CI-Typ angegeben, auf die bzw. den sich der Workflow bezieht (Pflichtfeld).
Hinweis
Eine spätere Änderung von CI-Kategorie/-Typ ist nicht möglich.
Für den CI-Typ "Genehmigung" lässt sich kein Workflow anlegen; dot4 weist das Speichern ab. Genehmigungen entstehen ihrerseits durch den Bedingungsbaustein "Genehmigung".
Workflow-Bausteine
Allgemeines zu Workflow-Bausteinen
Jeder Workflow-Baustein, der einen Attributwert verändert, speichert diesen sofort ab. Nachfolgende Bausteine (z. B. Bedingungsbausteine) greifen auf diese aktualisierten Werte zurück und nicht auf die Attributwerte, die ein CI beim Start des Workflows hatte.
Alle Workflow-Bausteine bis auf UND- und ODER-Bedingungen enthalten ein HTML-Feld "Baustein-Dokumentation" mit unbegrenzter Zeichenanzahl. Es dient der Dokumentation und hat keinen Einfluss auf die im Workflow verarbeiteten CIs.
Jeder Workflow enthält die Bausteine "Start" und "Ende", die nicht entfernt werden können. Über den Baustein "Start" lassen sich während der Workflow-Bearbeitung folgende Parameter ändern:
der "Name",
die "Beschreibung",
die "Workflow Trigger",
der "Ausführungsplan" des Workflows.
Workflows sind an die Option "Pflichtfeld" von CI-Attributen nicht gebunden. Ein Workflow kann ein CI also speichern, ohne dass ein als Pflichtfeld definiertes Attribut befüllt ist.
Bedingungsbausteine im Allgemeinen
Bedingungsbausteine stehen oft am Beginn eines Workflows und entscheiden, ob die Aktionen des Workflows für die gewählte CI-Kategorie bzw. den gewählten CI-Typ ausgeführt werden. Außerdem können Bedingungsbausteine zu bedingungsabhängigen Verzweigungen innerhalb eines Workflows führen.
Hinweis
In Bedingungsbausteinen stehen immer nur die CI-Attribute zur Überprüfung zur Verfügung, die sich aus der beim Erstellen des Workflows referenzierten CI-Kategorie/-Typ ergeben.
Hinweis
CI-Attribute, welche auf CI-Typ-Ebene definiert wurden, stehen auch nur für Workflows zur Verfügung, die sich genau auf diesen CI-Typ beziehen. Da z. B. ein Lebenszyklusmodell immer nur auf CI-Typ-Ebene definiert wird, ist die Überprüfung des Lebenszyklus nur möglich, wenn der Workflow auf Ebene des CI-Typs definiert ist und diesem CI-Typ ein Lebenszyklusmodell zugeordnet ist.
Hinweis:
Bei Attributen vom Datentyp "HTML-Text" funktionieren die Vergleichsoperatoren "ist gleich", "ist nicht gleich", "beginnt mit" und "endet mit" wegen der im Text enthaltenen HTML-Steuerzeichen ggf. nicht einwandfrei. Für diesen Datentyp empfehlen sich die Vergleichsoperatoren "Beinhaltet" und "Beinhaltet nicht".
Nicht jedes Attribut der referenzierten CI-Kategorie/-Typ lässt sich in einer Bedingung prüfen. Attribute der folgenden Datentypen stehen in der Auswahl nicht zur Verfügung: "Anhang", "Passwort", "QR-Code", "Tag", "Komplex", "Datumsintervall", "Datum und Zeit Intervall", "Zeitintervall", "Beziehungsliste" und "Workflow Trigger". Nicht als Bedingung verwendbar sind außerdem die System-Datentypen, die dot4 selbst pflegt und die an einem CI-Attribut nicht auswählbar sind (darunter Versionsstand und Systembild).
Unabhängig vom Datentyp stehen außerdem nicht zur Auswahl:
Mehrfach-Attribute,
Subattribute komplexer Attribute,
das System-Attribut für die Punktzahl (ausgeliefert unter dem Namen "Punktzahl"),
das System-Attribut für die Benutzer-Id (ausgeliefert unter dem Namen "Benutzer Id").
Das Attribut für den Lebenszyklusstatus (ausgeliefert unter dem Namen "Lebenszyklusstatus") fehlt in der Auswahl vollständig. Das Attribut der Lebenszyklusphase erscheint nicht unter seinem ausgelieferten Namen, sondern unter der Bezeichnung "Lebenszyklus".
Hinweis
Die genannten Attributnamen sind Auslieferungsbezeichnungen und im Mandanten änderbar. Der Ausschluss hängt am Attribut selbst, nicht an seinem Namen: Ein umbenanntes Attribut bleibt ausgeschlossen.
Diese Aufzählung gilt für die Bedingungsbausteine "Bedingung" und "Switch". Der Aktionsbaustein "Aktion - Änderung" und der Bedingungsbaustein "Eindeutigkeit" filtern die Attributauswahl jeweils anders und kommen zu einem anderen Ergebnis: Der Baustein "Eindeutigkeit" bietet auch Mehrfach-Attribute an, schließt dafür aber die Datentypen "Boolesch" und "Kategorie" aus, die in einer normalen Bedingung zulässig sind.
BedingungsTracking
Das Tracking einer Bedingung ist nur bei Workflows mit einem Zeittrigger aktiv. Über das Feld "Tracking" wird festgelegt, welcher Ausgang der Bedingung getrackt werden soll. Zur Auswahl stehen "Wahr", "Falsch" und "Wahr und Falsch"; bleibt das Feld leer, findet kein Tracking statt. Das Feld erscheint nur bei eigenständigen Bedingungsbausteinen — in Bausteinen, die zu einer UND- oder ODER-Bedingung gehören, steht es nicht zur Verfügung.
Wird ein Zeittrigger ausgelöst, prüft dieser immer, ob ein Tracking für das gerade behandelte CI existiert. Ist das Tracking einmal erfüllt, behandelt der Workflow dieses CI nicht mehr. Getrackt wird dabei ausschließlich, dass der Workflow dieses CI bereits behandelt hat; der damalige Attributwert wird nicht gespeichert.
Das Tracking für ein CI setzt sich zurück, sobald das Attribut, auf welches die Bedingung sich bezieht, tatsächlich einen anderen Wert erhält. Danach behandelt der Workflow das CI wieder.
Beispiel
Ein täglich ausgeführter Workflow prüft "Priorität ist gleich Hoch" und benachrichtigt anschließend den Bearbeiter. Wird der Ausgang "Wahr" getrackt, erhält der Bearbeiter die Benachrichtigung einmal und nicht an jedem folgenden Tag erneut. Wechselt die Priorität später auf einen anderen Wert und wieder zurück auf "Hoch", benachrichtigt der Workflow erneut.
Bedingungsbaustein "Bedingung"
Der Bedingungsbaustein "Bedingung" verzweigt den Workflow anhand einer Bedingung. Das Kriterium der Bedingung wird in einer Baumauswahl mit vier Gruppen gewählt:
CI-Attribut
Sicherheitsgruppe-Zugehörigkeit
Workflow Rolle
Systemvariablen
Die Gruppe "Sicherheitsgruppe-Zugehörigkeit" erscheint nur, wenn die Rolle des Benutzers die Berechtigung "Anzeigen" unter "Sicherheitsgruppenadministration" besitzt. Sie enthält die Einträge "In keiner Sicherheitsgruppe", "In irgendeiner Sicherheitsgruppe" und "Sicherheitsgruppenzugehörigkeit".
Die Gruppe "Workflow Rolle" enthält den Eintrag "Anwender". Diese Bedingung prüft, ob der im Ticket eingetragene "Anwender" dieselbe Person ist wie die, unter deren Identität der Workflow ausgeführt wird — bei ereignisgesteuerten Workflows also die Person, die die Änderung gespeichert hat. Die Bedingung hat deshalb keinen Operator und keinen Vergleichswert. Sie trifft nur auf Ticket-Typen zu; bei allen anderen CI-Typen folgt der Workflow immer dem Ausgang FALSCH.
Der Baustein führt die konfigurierte Überprüfung durch und leitet den Workflow je nach Ergebnis in einen der beiden Ausgänge (WAHR oder FALSCH).
Welche Vergleichsoperatoren im Baustein "Bedingung" zur Verfügung stehen, hängt vom Datentyp des gewählten Kriteriums (CI-Attribut, Sicherheitsgruppe oder Workflow-Rolle) ab. Die Operatoren sind weitgehend selbsterklärend und werden hier nicht einzeln beschrieben.
Bei Attributen mit Datums- bzw. Zeit-Datentyp und bei Systemvariablen wird zusätzlich der "Vergleichstyp" festgelegt. Zur Auswahl stehen:
| Vergleichstyp | Bedeutung |
|---|---|
| Wert | Vergleich mit einem festen Datum bzw. einer festen Uhrzeit |
| CI Attribut | Vergleich mit dem Wert eines anderen Attributs desselben CIs |
| Zeitversatz zur Workflow-Ausführungszeit | Vergleich mit einem Zeitpunkt, der relativ zur Ausführungszeit berechnet wird |
| Systemvariable | Vergleich mit dem Wert einer Systemvariablen |
Beim "Zeitversatz zur Workflow-Ausführungszeit" werden ein Wert und eine Einheit angegeben. Ein positiver Wert bezeichnet einen Zeitpunkt in der Zukunft, ein negativer einen in der Vergangenheit. Als Einheit stehen "Minuten", "Stunden", "Tage", "Wochen", "Monate" und "Jahre" zur Verfügung.
Beispiel
Die Bedingung "Erstellt am" mit dem Operator "<" und einem Zeitversatz von -14 Tagen ist für alle CIs wahr, die zum Zeitpunkt der Workflow-Ausführung älter als 14 Tage sind.
Das Rückführen des Ausgangs eines weiter unten liegenden Bausteins auf den Eingang des Workflow-Bausteins "Bedingung" ist nicht möglich.
Bedingungsbaustein "Switch"
Der Bedingungsbaustein "Switch" verzweigt den Workflow anhand mehrerer Bedingungen für sowohl mehrere Ein- als auch Ausgänge. Für jeden Verbindungspunkt (Ausgang) wird eine Bedingung bzw. Bedingungsgruppe eingestellt; auch komplexe Und- bzw. Oder-Verknüpfungen/-Gruppierungen sind möglich.
Ein typisches Beispiel für den Einsatz dieses Bausteins zeigt folgendes Diagramm:

Die Verbindungspunkte sind durchnummeriert und werden gemäß der Nummerierung abgearbeitet: Bei der Ausführung läuft der Workflow über den ersten Verbindungspunkt weiter, dessen Bedingung erfüllt ist. Ist keine Bedingung erfüllt, folgt der Workflow dem mit "D" (für Default) gekennzeichneten Pfad.
Die folgende Abbildung zeigt einen beispielhaft konfigurierten Dialog:

Über den "+ Neuer Filter"-Button werden eine oder mehrere Bedingungen definiert, die erfüllt sein müssen, damit der jeweilige Verbindungspunkt gewählt wird. Geprüft werden können z. B. Eigenschaften von Attributen wie "Name enthält abc" oder eine Workflow-Rolle.
Werden mehrere Filter auf einer Ebene geprüft, gilt für sie je nach gesetztem Schalter eine Und- oder eine Oder-Verknüpfung.
Sollen mehrere Filter einer Ebene wie ein einzelner Filter behandelt werden, werden sie über den "+ Neue Gruppe"-Button zu einer Gruppe zusammengefasst.
Der "+ Hinzufügen"-Button legt einen weiteren Verbindungspunkt an.
Bedingungsbaustein "UND-Bedingung"
Der Baustein "UND-Bedingung" verbindet zwei oder mehrere Bausteine durch eine logische UND-Verknüpfung. Nur, wenn alle Bedingungen erfüllt sind, läuft der Workflow über den Ausgangspfad WAHR weiter, ansonsten über den Ausgangspfad FALSCH.
Konfigurationshinweis: Zuerst wird der Baustein "UND-Bedingung" per Drag-and-Drop in den Konfigurationsbereich gezogen, danach die benötigte Anzahl an Bausteinen "Bedingung" ebenfalls per Drag-and-Drop auf den Baustein "UND-Bedingung".
Für den Inhalt einer UND- oder ODER-Bedingung gilt dabei:
Hineinziehen lassen sich ausschließlich die Bausteine "Bedingung" und "Genehmigung". Andere Bausteine nimmt der Editor nicht an.
Eine UND-Bedingung kann eine ODER-Bedingung aufnehmen und umgekehrt, aber keine Verknüpfung derselben Art — und nur eine Ebene tief. Eine Verknüpfung, die selbst schon in einer anderen liegt, nimmt keine weitere auf.
Bausteine werden direkt in die Verknüpfung hineingezogen: Ein Baustein, der bereits außerhalb im Konfigurationsbereich liegt, lässt sich nachträglich nicht in eine Verknüpfung verschieben.

Bedingungsbaustein "ODER-Bedingung"
Der Baustein "ODER-Bedingung" verbindet zwei oder mehrere Bausteine "Bedingung" durch eine logische ODER-Verknüpfung. Wenn eine der Bedingungen erfüllt ist, läuft der Workflow über den Ausgangspfad WAHR weiter. Wenn keine der Bedingungen erfüllt ist, über den Ausgangspfad FALSCH.
Konfigurationshinweis: Zuerst wird der Baustein "ODER-Bedingung" per Drag-and-Drop in den Konfigurationsbereich gezogen, danach die benötigte Anzahl an Bausteinen "Bedingung" ebenfalls per Drag-and-Drop auf den Baustein "ODER-Bedingung".
Für Inhalt und Schachtelung gelten dieselben Regeln wie bei der UND-Bedingung.

Bedingungsbaustein "Genehmigung"
Der Baustein "Genehmigung" erstellt ein CI vom CI-Typ "Genehmigung", benachrichtigt den/die Genehmiger und führt den Workflow abhängig von der Genehmigungsentscheidung weiter. Der Baustein hat drei Ausgänge: "Ja" für die Zustimmung, "Nein" für die Ablehnung und "Exp." für den Ablauf der Genehmigungsfrist. Über welchen Ausgangspfad der Workflow weiterläuft, ergibt sich aus dem Ergebnis der "Genehmigung".

Den Ausgang "Exp." beschreitet der Workflow, wenn die Genehmigung innerhalb der unter "Max. Genehmigungsdauer (Tage)" gesetzten Frist weder genehmigt noch abgelehnt wurde. dot4 setzt die Genehmigung dann auf den Lebenszyklusstatus "Abgelaufen" des Lebenszyklusmodells "Genehmigungen Lebenszyklus" und führt den Workflow über diesen Ausgang weiter. Der an diesen Ausgang angeschlossene Pfad legt fest, wie der Workflow auf eine unbeantwortete Genehmigung reagiert — etwa mit einer Benachrichtigung oder einer Eskalation.
Hinweis
In Workflows, die den Baustein "Genehmigung" bereits vor dem Release-Update genutzt haben, ist der Ausgang "Exp." automatisch mit dem Baustein "Ende" verbunden. Diese Workflows verhalten sich damit wie bisher, bis die Verbindung durch einen eigenen Pfad ersetzt wird.
Die folgende Abbildung zeigt einen Workflow aus einer Fassung vor dem Release-Update: Der Baustein "Genehmigung" trägt dort nur die beiden Ausgänge "Ja" und "Nein", der Ausgang "Exp." fehlt noch.
Name: Pflichtfeld für den Betreff einer E-Mail zur Genehmigung, für den Titel einer Tool-internen Systemnachricht zur Genehmigung sowie für den Namen/Titel des CIs vom CI-Typ "Genehmigung".
Beschreibung: Optionale Angabe (maximal 2000 Zeichen) für die Beschreibung in E-Mail, Systemnachricht und CI vom CI-Typ "Genehmigung".
Mögliche Empfänger: Anders als beim Baustein "Benachrichtigung" steht hier keine Rolle als Empfängerkreis zur Auswahl.
Anwender: Der Genehmiger ist der Benutzer, der die Beziehung "Person ist Anwender von Service Operation Ticket" zum CI hat.
Hinweis
Anwender als Genehmiger steht nur zur Verfügung, wenn der Workflow sich auf die CI-Kategorie "Service Operation" oder darunter liegende CI-Kategorie/Typen bezieht.
Benutzer: Auswahl eines Benutzers, der benachrichtigt werden soll.
Hinweis
Als Genehmiger kann ein beliebiger Benutzer definiert werden. Dieser Benutzer benötigt die Bearbeitungsberechtigung für CIs unter der CI-Kategorie "Aufgaben".
Benutzergruppen: Auswahl einer Personengruppe, deren Mitglieder benachrichtigt werden (siehe Konfiguration von "Personengruppen").
Hinweis
Das Feld "Mindestanzahl von Zustimmungen" legt fest, wie viele Zustimmungen erforderlich sind, damit die Genehmigung erteilt ist und der Baustein "Genehmigung" über den "WAHR"-Pfad weitergeführt wird. Das Feld erscheint nur, wenn als Genehmiger eine Benutzergruppe gewählt ist.
Hinweis
Zusätzliche Möglichkeiten bei Workflows, die sich auf die CI-Kategorie "Service Operation" beziehen: - Automatische Kategorisierung: Benutzergruppe, die sich anhand der automatischen Kategorisierung ergibt (siehe Konfiguration von "Kategorisierung"). - Zuständige 1st/2nd/3rd Level Benutzergruppe: Benutzergruppe, die sich anhand der Zuständigkeiten ergibt (siehe Konfiguration von "Zuständigkeiten"). - Zuständige Benutzergruppe: Benutzergruppe, die die Beziehung "Personengruppe bearbeitet Service Operation Ticket" zum betroffenen CI hat.
Beziehungen zu Benutzer/Benutzergruppe: Der ausgewählte Benutzer oder die Mitglieder der ausgewählten Benutzergruppe, die in einer Beziehung zum CI stehen, wird/werden benachrichtigt.
CI-Ersteller: Benachrichtigt wird der Benutzer, der das CI (z. B. ein Ticket) angelegt hat (siehe bei allen CIs das Attribut "Erstellt durch").
Kundenverantwortlicher: Der Genehmiger ist der Benutzer, der die Beziehung "ist Kundenverantwortlicher von" zu dem Unternehmen hat, dem auch der Anwender des CI über die Beziehung "Unternehmen hat Mitarbeiter Person" zugehörig ist.
Hinweis: Kundenverantwortlicher als Genehmiger steht nur zur Verfügung, wenn der Workflow sich auf die CI-Kategorie "Service Operations" oder darunter liegende CI-Kategorie/Typen bezieht.
Vorgesetzter: Benachrichtigt wird der Benutzer, der die Beziehung "Person ist Vorgesetzter von Person" zu der Person hat, die die Beziehung "Person ist Anwender von Service Operation Ticket" zum CI hat.
Hinweis: Für die Zuständigkeit 'Vorgesetzter' einer Genehmigung wird als Genehmiger der Vorgesetzte des Anwenders eines CIs ermittelt. Ist kein Anwender angegeben, wird die Genehmigung dem Vorgesetzten des CI-Erstellers vorgelegt. Maßgeblich ist dabei die Beziehung "Person ist Vorgesetzter von Person".
Zuständiger Benutzer: Benutzer, der die Beziehung "xyz" zum betroffenen CI hat.
Max. Genehmigungsdauer (Tage): Anzahl der Tage, die die Genehmigungsanfrage gültig ist und vom Genehmiger genehmigt oder abgelehnt werden kann. Zulässig sind nur Werte ab 1.
Erinnerung (alle x Tage): Ist ein Wert zwischen 1 und 30 eingetragen, erinnert dot4 die Genehmiger in diesem Abstand per E-Mail, solange die Genehmigung offen ist. Erinnert wird nur, wer noch nicht abgestimmt hat und in seinen persönlichen Einstellungen den Mailversand für Genehmigungsanfragen aktiviert hat. Ist eine Ablauffrist gesetzt und abgelaufen, werden keine Erinnerungen mehr verschickt. Der Text der Erinnerung wird im E-Mail-Template "Erinnerung an Genehmigung" mit der auslösenden Aktion "RequestApprovalReminder" gepflegt (siehe E-Mail Templates).
Ausstehende Genehmigungen: Das Feld erscheint nur, wenn zu diesem Baustein noch offene Genehmigungen vorliegen. Es nennt deren Anzahl und bietet die Möglichkeit, sie zu löschen.
Begründung bei Genehmigen: Ist der Schalter aktiviert, ist die Begründung für die Genehmigung obligatorisch.
Begründung bei Ablehnen: Ist der Schalter aktiviert, ist die Begründung für die Ablehnung obligatorisch.
Zusätzliche Authentifizierung: Ist der Schalter aktiviert, muss sich der Benutzer bei der Abstimmung über eine Genehmigung erneut authentifizieren, auch wenn er bereits angemeldet ist.
Hinweis
In den Feldern "Name" und "Beschreibung" können Platzhaltervariablen ($Variablen$) verwendet werden: Dies können Werte aus den Attributen des CIs sein, das den Workflow initiiert hat, oder in den Systemeinstellungen > Systemvariablen definierte Werte. Beziehen sich die Platzhaltervariablen auf CI-Attribute, stehen nicht die Anzeigenamen der Attribute, sondern die technischen Namen der Attribute zur Verfügung. Die Liste der nutzbaren Platzhaltervariablen wird automatisch angezeigt, wenn das $-Zeichen eingegeben wird.
Die von dot4 ausgelieferten Systemvariablen sind beim Aktionsbaustein "Aktion - Änderung" aufgeführt.
Hinweis
Jeder Benutzer kann unter seinen persönlichen Einstellungen festlegen, ob er die Benachrichtigung zur Genehmigung per E-Mail und/oder Systemnachricht erhalten möchte. Erreichen Benachrichtigungen einen Benutzer nicht, ist diese Einstellung zu prüfen.
Bedingungsbaustein "Eindeutigkeit"

Der Baustein "Eindeutigkeit" prüft, ob ein Wert in einem Attribut bereits bei einem anderen CI vorkommt. Damit lassen sich Dubletten erkennen, bevor der Workflow sie weiterverarbeitet. Der Baustein hat die beiden Ausgänge "Wahr" und "Falsch":
"Wahr": Der Wert ist eindeutig, also bei keinem anderen CI vergeben.
"Falsch": Der Wert ist bereits vergeben — oder er ließ sich nicht ermitteln. Ein Konfigurationsfehler lässt ein CI also nie als eindeutig durchlaufen.

Der Dialog "Eindeutigkeit prüfen" enthält folgende Einstellungen:
Zu prüfendes Attribut: Angeboten werden die Attribute des CI-Typs, die genau einen vergleichbaren Wert tragen — Attribute der Datentypen "Einzeiliger Text", "Mehrzeiliger Text", "Auswahlliste", "Statischer Verweis", "Dynamischer Verweis", "RDP Verweis", "Ganzzahl", "Gleitkommazahl", "Dezimalzahl", "CI-Auswahl", "Datum", "Datum und Zeit", "Zeit", "Monat und Jahr" und "Jahr". Die Option "Mehrfach-Attribut" schränkt die Auswahl nicht ein; auch Mehrfach-Attribute stehen zur Verfügung. Attribute jedes anderen Datentyps stehen nicht zur Auswahl — insbesondere "Boolesch" (zwei Zustände können über mehrere CIs nie eindeutig sein), "Kategorie", "Auto-Nummer", "Auto-Name" und "Beziehung". Ebenfalls nicht zur Auswahl stehen die Lebenszyklus-Attribute, die System-Attribute "Erstellt am", "Letzte Aktualisierung am", "Letzter Vergleich am", "Erstellt durch", "Letzte Aktualisierung durch" und "Benutzer Id" sowie die Subattribute komplexer Attribute.
Der Wert, der auf Eindeutigkeit geprüft wird (Pflichtfeld). Die Schaltfläche neben dem Feld wechselt zwischen der direkten Eingabe und der Auswahl einer Systemvariable. Die Schaltfläche erscheint nur, wenn Systemvariablen mit einem zum gewählten Attribut passenden Datentyp vorhanden sind.
Baustein-Dokumentation: optionale Beschreibung, die auch die Suche im Arbeitsbereich durchsucht.
Verglichen wird innerhalb des CI-Typs, an dem das Attribut definiert ist, und aller darunter liegenden CI-Typen — dieselbe Menge, die auch die Attribut-Option "Eindeutig" absichert. Das gerade verarbeitete CI selbst zählt nicht mit.
Hinweis
Der zu prüfende Wert ist ein Pflichtfeld; ohne Wert lässt sich der Baustein nicht speichern. Löst ein Platzhalter oder eine Systemvariable zur Laufzeit dennoch auf einen leeren Wert auf, gilt dieser als eindeutig und führt über den Ausgang "Wahr", ohne dass dot4 die Datenbank befragt. Auch die Attribut-Option "Eindeutig" prüft einen leeren Wert nicht.
Aktionsbaustein "Aktion - Änderung" bzw. "CI-Attribut ändern"
Der Baustein "Aktion - Änderung" ermöglicht die Modifikation von CI-Attributen des betroffenen CIs. Zunächst wird unter "Zu ändernde Attribute" das Attribut ausgewählt; in der daraufhin erscheinenden Zeile wird der neue Wert eingetragen. Die zu setzenden Werte variieren hierbei in Abhängigkeit vom Datentyp des Attributs.
Die Auswahl "Zu ändernde Attribute" ist nicht identisch mit der Attributauswahl der Bedingungsbausteine. Ausgeschlossen sind zunächst dieselben Datentypen wie dort (siehe Bedingungsbausteine im Allgemeinen) — mit zwei Ausnahmen: Attribute mit der Option "Mehrfach-Attribut" und Attribute vom Datentyp "Komplex" sind hier wählbar (siehe Attribute mit der Option "Mehrfach-Attribut" und Attribute vom Datentyp "Komplex"). Zusätzlich stehen in diesem Baustein nicht zur Auswahl:
Attribute der Datentypen "Auto-Nummer" und "Auto-Name" — diese Werte vergibt dot4 selbst,
Subattribute komplexer Attribute einzeln — sie kommen mit ihrem komplexen Attribut (siehe Attribute vom Datentyp "Komplex"),
die System-Attribute für Ersteller, letzten Bearbeiter, Asset-Nummer und Benutzer-Id (ausgeliefert unter den Namen "Erstellt durch", "Letzte Aktualisierung durch", "Asset Nummer" und "Benutzer Id").
Umgekehrt lässt sich das System-Attribut für die Punktzahl ("Punktzahl") hier — anders als in Bedingungsbausteinen — ändern. Das Attribut für den Lebenszyklusstatus ("Lebenszyklusstatus") fehlt in der Auswahl vollständig; das Attribut der Lebenszyklusphase erscheint unter der Bezeichnung "Lebenszyklus". Auch hier sind die genannten Namen Auslieferungsbezeichnungen: Der Ausschluss hängt am Attribut selbst, ein umbenanntes Attribut bleibt also ausgeschlossen.
In Attributen vom Datentyp "Text" können Platzhaltervariablen ($Variablen$) verwendet werden: Dies können Werte aus den Attributen des CIs sein, das den Workflow initiiert hat, oder in den Systemeinstellungen > Systemvariablen definierte Werte.
In Attributen vom Datentyp "Beziehung" oder "CI-Auswahl" können Werte aus einer Systemvariable ($tnt_, $wfr_) vom Datentyp "CI-ID" geholt und gespeichert werden: Dazu wird die Systemvariable zunächst unter "Administration > Systemeinstellungen > Systemvariablen" definiert und anschließend von einem Workflow-Baustein des Typs "Aktion - Systemvariable ändern" befüllt. Im Baustein "Aktion - Änderung" steht sie dann zur Verfügung, sobald der Wechsel-Button neben dem Wertfeld gedrückt wird.
Weitere zu ändernde Attribute werden ebenfalls aus dem Drop-Down-Menü gewählt. Das Papierkorb-Symbol in einer Zeile entfernt die jeweilige Attributänderung wieder.
Attribute mit der Option "Mehrfach-Attribut"

Attribute mit der Option "Mehrfach-Attribut" können mehrere Werte gleichzeitig tragen. Der Baustein setzt je Attributzeile genau einen Wert; wie dieser Wert auf die vorhandenen Werte wirkt, legt deshalb eine zusätzliche Auswahl in der Zeile fest:
"Überschreiben": Löscht die vorhandenen Werte des Attributs und setzt den neuen Wert. Das ist die Vorgabe.
"Hinzufügen": Fügt den Wert zu den vorhandenen Werten hinzu.
"Leeren": Löscht alle Werte des Attributs. Ein Wert wird dann nicht mehr abgefragt; das Attribut ist danach leer.
Attribute vom Datentyp "Komplex"
Ein Attribut vom Datentyp "Komplex" fasst mehrere Subattribute zu einem Wertesatz zusammen. Wird es unter "Zu ändernde Attribute" ausgewählt, erscheint eine Zeile mit dem Namen des komplexen Attributs und darunter je eine Eingabezeile für seine Subattribute. Die Subattribute werden als ein Wertesatz geschrieben; angeboten werden deshalb nur Subattribute, deren Datentyp dot4 im Workflow schreiben kann — "Einzeiliger Text", "Mehrzeiliger Text", "Auswahlliste", "Statischer Verweis", "Dynamischer Verweis", "RDP Verweis", "Boolesch", "Kategorie", "Ganzzahl", "Gleitkommazahl", "Dezimalzahl", "CI-Auswahl", "Datum", "Datum und Zeit", "Zeit", "Monat und Jahr" und "Jahr". Ein komplexes Attribut ohne ein einziges solches Subattribut steht nicht zur Auswahl.
Hat das komplexe Attribut zusätzlich die Option "Mehrfach-Attribut", trägt seine Zeile dieselbe Auswahl "Überschreiben" / "Hinzufügen" / "Leeren" wie ein einfaches Mehrfach-Attribut. In den Modi "Überschreiben" und "Hinzufügen" muss dann mindestens ein Subattribut gefüllt sein — andernfalls meldet dot4 beim Speichern, dass für das komplexe Attribut kein Wert angegeben ist. Bei einem einfachen komplexen Attribut ist ein leerer Wertesatz zulässig; er leert das Attribut, wie es ein leerer Wert bei jedem anderen Attribut tut.
Das Entfernen wirkt immer auf das ganze komplexe Attribut: Der Papierkorb in der Zeile des komplexen Attributs nimmt seine Subattribut-Zeilen mit.
Hinweis
Beziehen sich die Platzhaltervariablen auf CI-Attribute, stehen nicht die Anzeigenamen der Attribute, sondern die technischen Namen der Attribute zur Verfügung. Die Liste der nutzbaren Platzhaltervariablen wird automatisch angezeigt, wenn das $-Zeichen eingegeben wird.
Neben den selbst definierten Systemvariablen ($tnt_, $wfr_) liefert dot4 15 Systemvariablen mit dem Präfix
$sys_ aus. Sie stehen überall dort zur Verfügung, wo Platzhaltervariablen erlaubt sind. Die Namen werden
klein geschrieben und in Dollarzeichen eingeschlossen:
| Allgemeine Systemvariablen | Kommentarbezogene Systemvariablen |
|---|---|
$sys_now$ |
$sys_last_comment$ |
$sys_systemlink$ |
$sys_last_comment_datetime$ |
$sys_tenant_name$ |
$sys_last_comment_user_name$ |
$sys_technical_tenant_name$ |
$sys_last_comment_user_id$ |
$sys_workflowname$ |
$sys_last_comment_person_id$ |
$sys_workflowtrigger$ |
$sys_last_comment_private_type$ |
$sys_workflow_triggered_by_user$ |
$sys_comment_amount$ |
$sys_new_comment$ |
Hinweis
Die kommentarbezogenen Systemvariablen tragen nur dann einen Wert, wenn am betroffenen CI ein letzter Kommentar existiert. Ist kein Kommentar vorhanden, bleiben sie leer.
Hinweis
Läuft der Workflow zeitgesteuert, ist kein Benutzer angemeldet: $sys_workflow_triggered_by_user$ enthält dann "System" und $sys_workflowtrigger$ einen automatisch erzeugten Text.
Aktionsbausteine "Aktion - Übernahme (Holen/Setzen)"
Mit diesen Bausteinen werden die Werte von Attributen eines CIs auf ein anderes CI übertragen. Die beiden CIs sind dabei über eine Beziehung miteinander verbunden. Beim Baustein Setzen werden Werte des Quell-CIs (das CI, auf dem der Workflow gerade läuft) auf Attribute des Ziel-CIs übertragen. Beim Baustein Holen werden Werte aus dem verbundenen CI gelesen und in das CI, auf dem der Workflow gerade läuft, geschrieben. Quell- und Ziel-Attribute müssen jeweils den gleichen Datentyp haben.
Der Baustein "Aktion - Übernahme" benötigt folgende Einstellungen:
Beziehungstyp: Sowohl bei "Übernahme (Setzen)" als auch bei "Übernahme (Holen)" stehen alle aktiven Beziehungstypen zur Auswahl, an denen der CI-Typ des Workflows beteiligt ist — in beiden Leserichtungen und unabhängig von der Kardinalität des Beziehungstyps. Die Kardinalität schränkt die Auswahl nicht ein; eine Einschränkung auf bestimmte Kardinalitäten gibt es nur beim Aktionsbaustein "Aktion - Beziehung".
Attributfilter, Operator und Filterattribut
Wenn nicht alle CIs der gewählten Beziehung und des CI-Typs durch diesen Workflow-Baustein geändert werden sollen, kann zusätzlich ein Attributfilter gesetzt werden. Es werden dann nur die CIs geändert, die die Filterbedingung erfüllen. Der Wert des Filters kann erst gesetzt werden, wenn das Attribut (bzw. der Attributname) eingestellt ist.
Mindestens ein CI-Attribut, dessen Wert aus dem Quell-CI gelesen wird: Als Quell-CI-Attribute stehen Attributtypen zur Auswahl, die den nachfolgenden Kriterien entsprechen:
eindeutig bei einer Kardinalität von 1:1 oder 1:N
keine Mehrfach-Attributtypen
der Datentyp entspricht einem der Folgenden: ein-/mehrzeiliger Text, Boolesch, Zahl, Version, Auto-Nummer, Auto-Name, Tag, E-Mail, IP-Adresse
Zu jedem gelesenen CI-Attribut muss ein CI-Attribut im betroffenen Ziel-CI zugeordnet werden, dessen Wert überschrieben wird: Als Ziel-CI-Attribute stehen Attributtypen zur Auswahl, die den nachfolgenden Kriterien entsprechen:
eindeutig bei einer Kardinalität von 1:1 oder N:1
keine Mehrfach-Attributtypen
der auswählbare Datentyp ist durch den Datentyp des Quell-CI-Attributs eingeschränkt
der Datentyp entspricht einem der Folgenden: ein-/mehrzeiliger Text, Boolesch, Zahl, Version, Auto-Nummer, Auto-Name, Tag, E-Mail, IP-Adresse
Beispiel: Für Personen im Raum 123 soll in der benutzten Hardware der Benutzername vom Personen-CI ins Hardware-CI übertragen werden. Hierfür wird zunächst ein Workflow für den CI-Typ "Person" gewählt. Im Baustein wird der Beziehungstyp "Person verwendet Hardware" eingestellt, der die Kardinalität 1:N hat. Die Bedingung "Raum 123" wird über einen Attributfilter erreicht. Als Quell-CI-Attribut wird "Name" gewählt, als Ziel-CI-Attribut "Benutzername".

Aktionsbaustein "Aktion - CI erstellen"
Der Baustein "Aktion - CI erstellen" erstellt als Aktion ein neues Configuration Item (CI). Der CI-Typ des neuen CIs ist dabei frei wählbar.
Der Baustein "Aktion - CI erstellen" bietet folgende Einstellungen:
CI-Kategorie/-Typ: Pflichtfeld zur Festlegung des CI-Typs, für den das CI angelegt wird.
Beziehungstyp: Option zur Festlegung einer Beziehung zwischen dem initialen CI und dem neu anzulegenden CI. Zur Auswahl stehen die Beziehungen, die zwischen den CI-Typen der beiden CIs möglich sind.
Attribut hinzufügen: Optional können hier mehrere Attribute des neu zu erstellenden CIs ausgewählt werden, die der Workflow mit Werten befüllt. In der Konfigurationsoberfläche des Bausteins entsteht dadurch je Attribut eine weitere Zeile, die sich über das Lösch-Icon wieder entfernen lässt.
Name: Pflichtangabe; das Attribut "Name" ist ein Pflichtfeld-Attribut und muss für das neue CI mit einem Wert befüllt werden.
Weitere Attribute: Die übrigen Pflichtfeld-Attribute des neuen CIs werden automatisch angezeigt und müssen mit Werten befüllt werden.
Hinweis
In Attributen des zu erstellenden CI vom Datentyp Text können Platzhaltervariablen ($Variablen$) verwendet werden: Dies können Werte aus den Attributen des CIs sein oder in den Systemeinstellungen > Systemvariablen definierte Werte. Beziehen sich die Platzhaltervariablen auf CI-Attribute, stehen nicht die Anzeigenamen der Attribute, sondern die technischen Namen der Attribute zur Verfügung. Die Liste der nutzbaren Platzhaltervariablen wird automatisch angezeigt, wenn das $-Zeichen eingegeben wird.
Die von dot4 ausgelieferten Systemvariablen sind beim Aktionsbaustein "Aktion - Änderung" aufgeführt.
Aktionsbaustein "REST"
Dieser Baustein ruft einen externen REST-fähigen HTTP-Endpunkt auf.
Der Baustein "REST" benötigt folgende Eingaben:
Name des zuvor eingerichteten HTTP-Endpunktes
Hinweis
Beim Aufruf des Endpunktes übergibt der Baustein alle Attribute des CIs, das vom Workflow verarbeitet wird, als JSON-Payload-Daten an den REST-Aufruf.
Aktionsbaustein "Http Request"
Dieser Baustein sendet eine im Baustein selbst konfigurierte HTTP-Anfrage an eine beliebige Adresse. Anders als der Baustein "REST" benötigt er keinen zentral eingerichteten HTTP-Endpunkt: Methode, URI, Header, Query-Parameter, Cookie, Body und Timeout werden im Dialog des Bausteins festgelegt. Die Zugangsdaten dagegen liegen nicht im Baustein: Unter "Erweiterte Einstellungen" wird eine der zentral gepflegten HTTP-Authentifizierungen ausgewählt oder "Keine Authentifizierung". Der Statuscode der Antwort wird in eine Systemvariable vom Datentyp "Ganzzahl", der Antworttext in eine Systemvariable vom Datentyp "Text" geschrieben; beide Variablen sind Pflichtangaben. Der Baustein hat zwei Ausgänge: "Erfolg" bei einem Status 2xx mit lesbarem Textinhalt, sonst "Fehler". Mit dem Button "Testen" führt der Dialog die Anfrage einmal gegen ein ausgewähltes CI aus, ohne etwas zu speichern. Das Testergebnis nennt zunächst nur das Urteil und die Eckdaten – Status, Inhaltstyp, Dauer und aufgerufene Adresse. Darunter stehen zwei Bereiche, die beide zugeklappt beginnen und sich unabhängig voneinander öffnen lassen: "Antwort" zeigt den Antworttext, "Gesendete Anfrage" zeigt, was dot4 tatsächlich geschickt hat – mit allen aufgelösten Platzhaltern: Methode, Adresse einschließlich Query-Parameter, alle Header und Cookies mit ihren Werten, der Body sowie das tatsächlich verwendete Timeout, die verwendete HTTP-Authentifizierung und gegebenenfalls das Client-Zertifikat. Passwörter, Keys und Tokens, die dot4 selbst speichert, werden dabei nur angerissen: Vom Wert sind die ersten Zeichen zu sehen, der Rest ist durch "… (gekürzt)" ersetzt. Dieser Bereich ist vor allem dann nützlich, wenn die Anfrage fehlschlägt – und er wird auch dann gefüllt, wenn gar keine Anfrage zustande kam, etwa bei einer ungültigen Adresse.
In den Feldern URI, Body, Cookie sowie in den Werten von Headern und Query-Parametern können Platzhaltervariablen verwendet werden; sie werden je verarbeitetem CI ersetzt:
$name$steht für ein Attribut des CIs (technischer Name), eine CI-Systemeigenschaft (z. B.$id$,$name$,$citypename$) oder eine Systemvariable ($tnt_…$,$wfr_…$,$sys_…$). Die Liste der nutzbaren Namen wird angezeigt, sobald das$-Zeichen eingegeben wird.§name§steht für ein Attribut des Sub-CIs, das über das Attribut "Zusätzliche Attribute" (additionalAttributes_PR) mit dem CI verbunden ist, etwa die Bestellangaben eines Service Requests. Die Vorschlagsliste nach Eingabe von§vereinigt die Attribute aller Sub-CI-Typen, die ein CI dieses Typs tragen kann: die in der Verwaltung "Zusätzliche CI-Attribute" für den CI-Typ (oder eine seiner Kategorien) konfigurierten Typen und die Sub-CI-Typen der Services. Ist keiner dieser Typen festgelegt, enthält die Liste die Attribute aller CI-Typen, die die Beziehung "Process uses attributes from CI" als Sub-CI zulässt; beim Tippen wird die Liste eingegrenzt.Nur im Body:
$sys_json:name$übergibt den Wert eines einzelnen Attributs als JSON-Zeichenkette – mit Anführungszeichen und maskiert, sodass Werte mit",\oder Zeilenumbrüchen den Body nicht zerstören; ein nicht auflösbares Attribut wird zunull, ein leeres zu"".§sys_json:name§tut dasselbe für ein Attribut des Sub-CIs. Das Token nimmt genau einen Namen auf; alles andere ergibtnull. Der Wert wird immer als Zeichenkette geschrieben – für Zahlen und Wahrheitswerte wird weiterhin der einfache Platzhalter$name$verwendet, der ohne Anführungszeichen und immer mit Punkt als Dezimaltrennzeichen eingesetzt wird.Nur im Body:
$sys_ci_json$übergibt das ganze CI als JSON-Objekt im Format der dot4-Web-API (alle Attribute mit ihren technischen Namen).$sys_ci_json:name,status_REF$übergibt ein JSON-Objekt mit genau den genannten Attributen; jeder Wert wird als JSON-Zeichenkette geschrieben, ein nicht auflösbares Attribut alsnull. Dasselbe gibt es für das Sub-CI:§sys_ci_json§übergibt das ganze Sub-CI,§sys_ci_json:quantity_PR,…§die genannten Attribute des Sub-CI; hat das CI kein Sub-CI, wirdnullübergeben. Attribute beider Quellen lassen sich in einem Objekt mischen, indem der Name in das jeweils andere Zeichen eingeschlossen wird:$sys_ci_json:name,§quantity_PR§$liefertnamedes CI undquantity_PRdes Sub-CI. Kommt derselbe Name aus beiden Quellen, behält der zweite Eintrag seine eingeschlossene Form als Schlüssel ("§name§"). Mit dem Schalter "CI als JSON einfügen" unter dem Body-Feld wird ein Auswahlbaum mit den Gruppen "CI" und "Sub-CI" eingeblendet; das Kästchen einer Gruppe wählt alle ihre Attribute auf einmal. Sind alle Attribute einer Gruppe gewählt, ist das das ganze CI bzw. Sub-CI ($sys_ci_json$bzw.§sys_ci_json§, beides zusammen$sys_ci_json$§sys_ci_json§); sonst entsteht der Platzhalter mit den gewählten Attributen. Der Button "Einfügen" setzt den Platzhalter an der Cursorposition im Body ein (bei unberührtem Body am Ende). Ist für den CI-Typ kein Sub-CI-Typ konfiguriert, steht "Sub-CI" für das ganze Sub-CI, und einzelne Attribute des Sub-CI werden kommagetrennt als technische Namen eingegeben.
Beispiel eines selbst geschriebenen Body mit gemischten Platzhaltern:
{
"ticketId": $id$,
"name_test": $sys_json:name$,
"type_name": §sys_json:name§,
"ticket": $sys_ci_json:name,description,status_REF$,
"order": §sys_ci_json§
}
Hinweis
Einfache Platzhalter wie $name$ werden im Body unverändert eingesetzt und nicht für JSON
maskiert. { "name_test": $name$ } ergibt deshalb { "name_test": Server01 } und damit kein
gültiges JSON; Anführungszeichen um den Platzhalter helfen nur so lange, bis der Wert selbst eines enthält. Für Text
wird $sys_json:name$ verwendet, für mehrere Attribute in einem Objekt $sys_ci_json:…$; beide
schreiben ihre Werte immer als gültige JSON-Zeichenketten. Beginnt der Body mit { oder [ und
ergibt kein gültiges JSON, weist der Dialog darauf hin – gespeichert werden kann er trotzdem, denn der Body darf auch
XML oder Formulardaten enthalten. Platzhalter werden niemals in den Feldern der Authentifizierung ersetzt.
Aktionsbaustein "Dokument parsen"
Dieser Baustein liest ein JSON- oder XML-Dokument und schreibt einzelne Werte daraus in Zielfelder. Er folgt typischerweise auf den Baustein "Http Request": Dessen Antworttext steht in einer Systemvariablen, und "Dokument parsen" holt die benötigten Werte heraus.
Quelle. Jeder Baustein liest genau eine Quelle; das Format (JSON oder XML) wird ausdrücklich gewählt und nie automatisch erkannt:
eine Systemvariable vom Datentyp "Text",
ein CI-Attribut vom Speichertyp Text,
ein SubCI-Attribut, also ein Attribut des über "Zusätzliche Attribute" (
additionalAttributes_PR) verbundenen CIs.
Das Dokument darf höchstens 10 MB groß sein.
Zuordnungen. Jede Zeile enthält einen Pfad in das Dokument und genau ein Ziel: eine Systemvariable, ein CI-Attribut oder
ein SubCI-Attribut. Pfade werden bei JSON als JSONPath ausgewertet ($.kunde.name, $.positionen[*].nummer),
bei XML als XPath 1.0 (/kunde/name, /positionen/position/@nummer). Ausdrücke, die direkt einen Wert
liefern – count(…), string(…), starts-with(…) – sind erlaubt und zählen als genau ein Treffer.
Platzhalter der Form $name$ sind im Pfad nicht erlaubt.
Der Zieltyp entscheidet, wie geschrieben wird. Es gibt keinen Schalter "mit/ohne Umwandlung": Passt der gelesene Wert bereits zum Ziel, wird er direkt übernommen; sonst wird seine neutrale Textform genommen und nach der Regel des Zieltyps umgewandelt.
| Ziel | Was angenommen wird |
|---|---|
| Text | jeder Wert; Zahlen und Ja/Nein in neutraler Schreibweise (3.7, true) |
| Ja/Nein | true, false, 1, 0, yes, no, ja, nein – Groß- und Kleinschreibung egal |
| Ganzzahl | eine ganze Zahl im gewählten Zahlenformat; 3.7 wird abgelehnt, nicht gerundet |
| Dezimal-/Gleitkommazahl | eine Zahl im gewählten Zahlenformat |
| Datum/Uhrzeit | ISO 8601 (2026-01-31T12:00:00Z) oder das je Zeile angegebene Datumsformat |
| Jahr | zusätzlich 2026 |
| Monat und Jahr | zusätzlich 2026-03 oder 03/2026 |
| Datum | zusätzlich 2026-03-15 |
| Uhrzeit | zusätzlich 14:30 oder 14:30:00 |
Je Zeile gibt es zwei optionale Angaben, jeweils nur dort, wo der Zieltyp sie braucht: das Zahlenformat (neutral, also
1234.56, oder Deutsch, also 1.234,56) und ein Datumsformat (zum Beispiel dd.MM.yyyy). Ein
null-Wert im Dokument leert das Ziel. Ein Wert, der sich nicht umwandeln lässt – "abc" in eine Ganzzahl, ein
ganzes Objekt in irgendein Feld –, lässt diese eine Zuordnung scheitern.
Bei einem SubCI-Attribut als Ziel wird der Datentyp über den technischen Namen aufgelöst, sobald er eindeutig ist – das ist der Normalfall, weil ein CI-Typ üblicherweise genau einen SubCI-Typ zulässt. Die Zeile verhält sich dann genau wie bei einem CI-Attribut. Nur wenn mehrere mögliche SubCI-Typen denselben Namen mit unterschiedlichem Datentyp führen, oder wenn der Name nicht aus der Vorschlagsliste stammt, werden Modus, Zahlenformat und Datumsformat alle angeboten; welche davon wirken, entscheidet sich dann je CI zur Laufzeit. Der Dialog weist in diesem Fall darauf hin.
Nicht beschreibbar sind Auswahllisten, Kategorisierungen, CI-Auswahlen und komplexe Attribute: diese Felder speichern die Kennung eines Eintrags, und ein Dokument kann eine gültige Kennung nicht garantieren.
Zahlen mit Einheit werden wie im Baustein "CI-Attribut ändern" behandelt: Der Wert aus dem Dokument gilt als Wert in der Anzeigeeinheit des Attributs und wird in die Basiseinheit umgerechnet. Liefert ein Fremdsystem bereits Werte in der Basiseinheit, muss das im Dokument oder über den Attributtyp angeglichen werden.
Mehrere Treffer. Für eine Systemvariable und für ein einfaches Attribut muss der Pfad genau einen Wert liefern; null oder mehrere Treffer lassen die Zeile scheitern. Ein Mehrfachattribut nimmt alle Treffer auf; ein JSON-Array wird dabei in seine Elemente aufgelöst (eine Ebene). Je Zeile wird gewählt, ob die vorhandenen Werte überschrieben oder die neuen hinzugefügt werden. Lässt sich auch nur ein Element nicht umwandeln, scheitert die ganze Zeile und das Attribut bleibt unverändert – es entsteht nie eine halbe Liste. Mit der Option "Fehlender Wert erlaubt" bleibt das Ziel unangetastet, wenn der Pfad nichts findet.
Zwei Ausgänge. Gelingen alle Zuordnungen eines CIs, wird der Ausgang "Erfolg" genommen. Scheitert mindestens eine – oder lässt sich das Dokument gar nicht lesen –, wird der Ausgang "Fehler" genommen und die Ursache in eine Systemvariable vom Datentyp "Text" geschrieben; diese Variable ist eine Pflichtangabe. Der Text nennt je gescheiterter Zeile deren Nummer, den Pfad, das Ziel und den Grund. Zuordnungen, die gelingen, werden geschrieben, auch wenn andere Zeilen desselben CIs scheitern. Im Erfolgsfall wird die Fehlervariable geleert, damit kein Fehler eines früheren Laufs stehen bleibt.
Testen. Mit dem Button "Testen" führt der Dialog den Baustein einmal für ein ausgewähltes CI aus, ohne etwas zu speichern: Es wird keine Systemvariable geschrieben, kein SubCI geändert und kein Workflow-Log-Eintrag erzeugt. Das Test-Objekt ist Pflicht, weil Attributquellen und -ziele es brauchen. Optional kann ein Testdokument eingefügt werden; es wird dann statt der konfigurierten Quelle verwendet, und die Quelle wird nicht geprüft. Ohne Testdokument wird die Quelle gelesen – bei einer Laufzeitvariablen, die erst ein vorangehender Baustein füllt, ist ihr gespeicherter Wert zur Entwurfszeit meist leer, das eingefügte Dokument ist dafür gedacht. Getestet wird, was in der Tabelle der Zuordnungen steht; eine im Zeileneditor begonnene Zuordnung muss vorher hinzugefügt oder verworfen werden. Das Ergebnis nennt das Urteil (Erfolgs- oder Fehlerausgang), Quelle, Format, Größe und Dauer und je Zuordnung, ob sie geschrieben, übersprungen oder fehlgeschlagen wäre – mit den ermittelten Werten bzw. dem Grund. Die Werte stehen in der Anzeigeeinheit des Ziels, so wie sie im Dokument stehen; die Umrechnung in die Basiseinheit geschieht erst beim Schreiben. Darunter lässt sich das gelesene Dokument aufklappen, auch wenn es sich nicht parsen ließ. Für die Anzeige wird das Dokument auf 8192 Zeichen, jeder Wert auf 1024 Zeichen und jede Zuordnung auf 20 Werte gekürzt; die Kürzung wird ausgewiesen.
Im Workflow-Log. Je verarbeitetem CI schreibt der Baustein in die Workflow-Log: woher das Dokument stammt (Systemvariable, CI-Attribut oder SubCI-Attribut mit Namen) und wie groß es war, je fehlgeschlagener Zuordnung eine Fehlerzeile mit dem Grund – dieselbe Zeile, die auch in der Fehlervariable steht – und zum Abschluss eine Zusammenfassung, die die geschriebenen, übersprungenen und fehlgeschlagenen Ziele beim Namen nennt. Die Werte, die geschrieben wurden, erscheinen nur bei der Protokollstufe "Debug", gekürzt auf 100 Zeichen je Wert und höchstens zehn Werte je Zuordnung. Der Inhalt des Dokuments selbst wird nie protokolliert.
Hinweis
XPath 1.0 kennt keinen Standard-Namensraum. Trägt das XML-Dokument ein
xmlns="…" ohne Präfix, findet /kunde/name nichts; in diesem Fall wird
/*[local-name()='kunde']/*[local-name()='name'] verwendet. Namensräume mit Präfix können dagegen
unverändert im Pfad verwendet werden. Bei JSONPath prüft $.positionen[?(@.aktiv)] nur, ob
das Feld vorhanden ist – auch false passt dann; auf den Wert prüft
$.positionen[?(@.aktiv == true)].
Aktionsbaustein "Aktion - Beziehung"
Der Baustein "Aktion - Beziehung" erstellt eine Beziehung zwischen zwei CIs. Ein CI ist das (initiale) Quell-CI, für das der Workflow ausgelöst wurde. Die Beziehung wird erstellt, wenn die Werte der definierten Quell- und Ziel-CI-Attribute übereinstimmen. Besteht die definierte Beziehung zwischen den beiden betroffenen CIs mit dem benannten Beziehungstyp bereits, wird diese vor dem Anlegen der neuen Beziehung automatisch gelöscht.
Der Baustein "Aktion - Beziehung" benötigt folgende Eingaben:
Beziehungstyp
Auswahl des Typs der anzulegenden Beziehung.
Es können Beziehungstypen ausgewählt werden, die für die/den ausgewählten CI-Kategorie/CI-Typ des Workflows existieren.
Es können Beziehungstypen ausgewählt werden, die der Kardinalität 1:1, 1:N oder N:1 entsprechen.
Quell-CI-Attributstyp
Auswahl eines Attributs des Quell-CI-Typs
Zur Auswahl stehen CI-Attributtypen, die den nachfolgenden Kriterien entsprechen:
eindeutig bei einer Kardinalität von 1:1 oder 1:N
keine Mehrfach-Attributtypen
der Datentyp entspricht einem der folgenden: einzeiliger/mehrzeiliger Text, Boolesch, Zahl, Version, Auto-Nummer, Auto-Name, Tag, E-Mail, IP-Adresse
Ziel-CI-Attributstyp
Auswahl eines Attributs des Ziel-CI-Typs
Zur Auswahl stehen CI-Attributtypen, die den nachfolgenden Kriterien entsprechen:
eindeutig bei einer Kardinalität von 1:1 oder N:1
keine Mehrfach-Attributtypen
der Datentyp entspricht einem der folgenden: einzeiliger/mehrzeiliger Text, Boolesch, Zahl, Version, Auto-Nummer, Auto-Name, Tag, E-Mail, IP-Adresse
Beispiel:
Beziehungstyp: "Person verwendet Hardware"
Quell-CI-Typ "Person"
Ziel-CI-Typ: "Hardware"
Quell-CI-Attribut: "E-Mail (unique)"
Ziel-CI-Attribut: "Erstellt durch"
Aktionsbaustein "CIs ändern"
Der Baustein "CIs ändern" ändert CIs, die mit dem betroffenen CI in Beziehung stehen.
Es werden folgende Eingaben benötigt:
Beziehungstyp
Auswahl des Typs der Beziehung.
Es können Beziehungstypen ausgewählt werden, die für die/den ausgewählten CI-Kategorie/CI-Typ des Workflows existieren.
CI-Typ
Auswahl eines CI-Typs, der sich unter dem Ziel-CI-Typ befindet
Attributfilter, Operator und Filterattribut
Wenn nicht alle CIs der gewählten Beziehung und des CI-Typs durch diesen Workflow-Baustein geändert werden sollen, kann zusätzlich ein Attributfilter gesetzt werden. Es werden dann nur die CIs geändert, die die Filterbedingung erfüllen. Der Wert des Filters kann erst gesetzt werden, wenn das Attribut (bzw. der Attributname) eingestellt ist.
Zu ändernde Attribute
Auswahl von Attributen des ausgewählten CI-Typs. Mehrere Attribute werden nacheinander ausgewählt.
Hinweis
Bei der Eingabe der Attributwerte können auch Platzhaltervariablen ($Variablen$) verwendet werden.
Die von dot4 ausgelieferten Systemvariablen sind beim Aktionsbaustein "Aktion - Änderung" aufgeführt.
Aktionsbaustein "Beziehungen löschen"
Dieser Workflow-Baustein löscht "veraltete" Relationen zwischen CIs automatisiert. Dazu prüft er den Wert eines CI-Beziehungs-Attributs eines bestimmten CI-Beziehungstyps und löscht alle Beziehungen dieses CI-Beziehungstyps, die einer bestimmten Bedingung entsprechen.
Der Baustein verlangt die folgenden Angaben. Alle Felder sind Pflichtfelder:
| Feld | Beschreibung |
|---|---|
| Beziehungstyp | Der Beziehungstyp, dessen Beziehungen geprüft und gelöscht werden |
| Vergleichsattribut | Das Attribut der Beziehung, dessen Wert geprüft wird. Immer verfügbar sind "Startdatum", "Letzter Vergleich am" und "Letzte Aktualisierung am"; zusätzlich stehen die Beziehungsattribute mit Datums- bzw. Zeit-Datentyp zur Auswahl |
| Vergleichstyp | Legt fest, womit der Wert des Vergleichsattributs verglichen wird |
| Operator | Der Vergleichsoperator |
| Zeitversatz | Wert und Einheit des Zeitversatzes |
Ein Import erkennt nicht, dass Quelldaten entfallen sind: Eine einmal importierte Beziehung bleibt bestehen, auch wenn es sie in der Quelle nicht mehr gibt. Über das Alter der letzten Aktualisierung bleibt die Datenqualität dennoch prüfbar — Beziehungen, die über einen festgelegten Zeitraum nicht mehr aktualisiert wurden, entfernt dieser Baustein automatisiert.
Der folgende Workflow löscht beispielsweise alle Beziehungen "Rechner hat installiert Anwendung", deren Startdatum mehr als 2 Jahre zurückliegt.

Hinweis
Da die Löschbedingung in diesem Baustein direkt eingetragen wird, wird kein Bedingungsbaustein vorangestellt.
Aktionsbaustein "Aktion - Erhöhen/Reduzieren"
Dieser Baustein erhöht oder verringert den Wert eines Attributs des betroffenen CIs. Dafür stellt er eine Liste der möglichen Attribute (beschränkt auf Attribute vom Typ Ganzzahl, Dezimalzahl und Datum) zur Verfügung sowie ein Textfeld, in das zum Erhöhen ein positiver und zum Verringern ein negativer Wert eingetragen wird. Bei Datums- und Zeit-Attributen erscheint zusätzlich ein Auswahlfeld, das festlegt, ob Jahre, Monate, Tage usw. addiert werden.
Aktionsbaustein "Aktion - Aufgabenplan Starten"
Dieser Baustein startet vordefinierte Aufgabenpläne, indem er die durch den Aufgabenplan festgelegten Tasks als Configuration Items an das betroffene Configuration Item anhängt.
Der Baustein hat genau eine Einstellung: das Pflichtfeld "Aufgabenplan". Damit ein Aufgabenplan in dieser Aktion zur Auswahl steht, muss der Benutzer, der den Workflow bearbeitet, in den "Benutzer-Rollen" des Aufgabenplans eingetragen sein und über das Recht "Aufgabenpläne" (Anzeigen) oder "Aufgabenplan starten" (Anzeigen) verfügen. Beim Ausführen des Workflows spielen Berechtigungen keine Rolle: Der Aufgabenplan wird unabhängig von den Rechten der Person gestartet, die den Workflow ausgelöst hat. Das Anlegen und Pflegen von Aufgabenplänen ist unter Aufgabenpläne verwalten beschrieben.
Aktionsbaustein "Aktion - Systemvariable ändern"
Dieser Baustein setzt oder verändert Systemvariablen ($tnt_ und $wfr_). Dazu wird zunächst unter "Zu ändernde Variable" eine vorab definierte Variable ausgewählt. Danach werden der Änderungstyp und der Wert festgelegt:
Attributwert: Setzt die Systemvariable auf einen Attributwert des betroffenen CIs. Bei dieser Option erscheint eine weitere Auswahlmöglichkeit, in der ein passendes Attribut gewählt wird.
Systemvariablenwert: Setzt die Systemvariable auf den Wert einer anderen Systemvariable ($sys, $tnt, $wfr). In diesem Fall erscheint eine weitere Eingabemöglichkeit zum Festlegen der zu kopierenden Variable.
Wert: Setzt die Systemvariable auf einen festen Wert. Bei dieser Option erscheint eine weitere Eingabemöglichkeit, in der je nach Datentyp der zu ändernden Variablen der gewünschte Wert konkretisiert wird.
Der Schalter "Als HTML bearbeiten" erscheint nur beim Änderungstyp Wert und nur, wenn die zu ändernde Variable den Datentyp "Text" hat. Er legt fest, mit welchem Editor der Wert erfasst wird. Eingeschaltet — das ist die Vorgabe — steht der HTML-Editor mit Formatierungsleiste zur Verfügung; ausgeschaltet wird der Wert als einfacher mehrzeiliger Text erfasst. Die Liste der Platzhaltervariablen steht in beiden Editoren gleichermaßen zur Verfügung.
Aktionsbaustein "Aktion - KI Änderung"
Mit diesem Baustein werden beliebige Prompts definiert und die resultierenden KI-Antworten automatisch in CI-Attributen gespeichert. Die Konfiguration dieses Bausteins bietet folgende Möglichkeiten:
Prompt: Prompt/Text, der an die KI geschickt wird. $-Variablen passen den Prompt dynamisch an das jeweilige CI an bzw. reichern ihn an, meist mit aktuellen Werten von CI-Attributen.
Zu änderndes Attribut: Zielattribut, in das die Antwort der KI-Anfrage geschrieben wird. Ist es nicht vom Datentyp Text, muss der Prompt eine entsprechende Konversionsanfrage enthalten. Andernfalls antwortet die KI in der Regel mit einem vollständigen Satz, den dot4 nicht im benötigten Datentyp speichern kann; der Baustein endet dann im Ausgang "Fehler". Soll zum Beispiel in ein Attribut vom Typ Zahl geschrieben werden, kann Folgendes an den Prompt angehängt werden: "Das Ergebnis darf nur die Zahl enthalten und keinen weiteren Text!". Beziehungsattribute, Auswahllisten, Lebenszyklus und CI-Auswahllisten stehen bei den Zielattributen nicht zur Verfügung.
Eine Test-KI-Antwort generieren: Schickt den aktuell eingetragenen Prompt zum Testen an die KI. Kommen $-Variablen zum Einsatz, erscheint ein Dialog, in den konkrete Testwerte eingetragen werden.
Zurücksetzen: Setzt die aktuelle Konfiguration zurück.
Eingabe hinzufügen: Fügt ein weiteres Prompt-Zielattribut-Paar hinzu.
Ausgänge des Workflow-Bausteins:
Erfolg: Alle Anfragen wurden beantwortet, die KI hat Ergebnisse geliefert, und diese konnten in den gewünschten Datentyp konvertiert werden.
Fehler: Fehler bei mindestens einer Abfrage oder beim Konvertieren.
Aktionsbaustein "Aktion - Befehlsausführung"
Dieser Baustein führt Befehle auf Betriebssystemebene eines Import-Servers aus. Dafür werden in der Konfiguration dieses Bausteins folgende Werte festgelegt:
Import Server: Zur Auswahl stehen alle zuvor für diesen dot4-Mandanten konfigurierten Import-Server.
Befehl: Ein Moniker (also beliebiger Text, wie z. B. cmd1), der in der Datei "Settings.config" des ImportServers im value eines add-Tags innerhalb des appSettings-Tags mit dem key="CommandsToExecute" in den tatsächlichen Befehl (welches Programm, Batchdatei oder Skript ausgeführt werden soll) übersetzt wird. Diese Maskierung stellt sicher, dass über das dot4-Frontend keine möglicherweise sicherheitskritischen Befehle eingegeben werden können. Nur mit Zugriff auf den ausführenden Server kann der tatsächlich auszuführende Befehl definiert werden. Mehrere Befehle im add-Tag werden durch ein Semikolon getrennt. Beispiel für einen Eintrag in "Settings.config":
Alternativ kann ein Section-Tag namens CommandMonikers in "Settings.config" verwendet werden. Die Section wird außerhalb des appSettings-Tags definiert. In der Section können add-Tags definiert werden, die jeweils einen Befehl maskieren können. Bspw.:
...Befehlsparameter: Optional können Parameter zur Kommandoausführung an den ImportServer übertragen werden, die bei der Ausführung seitens ImportServer anstelle des Sterns (*) im value mit den tatsächlichen Befehlen eingesetzt werden. Die Parametersequenz kann zusammengesetzt werden aus:
festen Werten
Attributwerten des betroffenen CIs mit der $-Schreibweise, bspw. $technicalname$ oder $autoNumber$
Systemvariablen $sys_, $tnt_ und $wfr_
Sonderzeichen in den Parametern: Besteht der hinterlegte Befehl nur aus einem ausführbaren Programm (.exe) und festen Argumenten, startet der ImportServer das Programm direkt, und die Parameter dürfen beliebige Zeichen enthalten, z. B. runde Klammern in einem CI-Namen. In allen anderen Fällen läuft der Befehl über die Eingabeaufforderung, und Parameter mit den Zeichen & | < > ( ) ^ " % oder einem Zeilenumbruch werden aus Sicherheitsgründen nicht ausgeführt; der ImportServer schreibt dazu einen Fehler mit dem Grund in sein Protokoll. Das betrifft Batchdateien und Skripte, Befehle der Eingabeaufforderung (z. B. echo), Programme, die selbst Befehle interpretieren (z. B. cmd.exe oder powershell.exe), hinterlegte Befehle mit Umleitung, Verkettung oder Umgebungsvariablen (> | & %) sowie Programme, die der ImportServer nicht findet.
Die von dot4 ausgelieferten Systemvariablen sind beim Aktionsbaustein "Aktion - Änderung" aufgeführt.
Aktionsbaustein "Rolle zuweisen"
Dieser Baustein weist einem CI vom CI-Typ "Person" Rollen zu oder entfernt sie.
Hinweis
Der Baustein steht nur zur Verfügung, wenn der Workflow sich auf den CI-Typ "Person" bezieht.
Der Baustein bietet drei Aktionen:
| Aktion | Beschreibung |
|---|---|
| Entfernen | Entfernt die unter Rollen ausgewählten Rollen vom Personen-CI. |
| Hinzufügen | Fügt die unter Rollen ausgewählten Rollen dem Personen-CI hinzu. |
| Überschreiben | Ersetzt alle vorhandenen Rollen des Personen-CIs durch die unter Rollen ausgewählten Rollen. |
Aktionsbaustein "Aktion - Authentifizierung"
Dieser Workflow-Baustein legt die Authentifizierungsmethode für Benutzer fest (z. B. beim Import von Personen aus dem Active Directory).
Hinweis
Der Baustein steht nur zur Verfügung, wenn der Workflow sich auf den CI-Typ "Person" bezieht.
Durch entsprechendes Auswählen der Schalter kann eine der folgenden Authentifizierungsmethoden zugewiesen werden:
Externe Authentifizierung deaktiviert: Der Benutzer meldet sich mit Benutzername und Passwort an.
Externe Authentifizierung über Azure Active Directory
Externe Authentifizierung über Active Directory Federation Service
Aktionsbaustein "Aktion - CI löschen"
Der Baustein "Aktion - CI löschen" löscht das betroffene CI. Er kann nicht in Kombination mit anderen Aktionsbausteinen verwendet werden. Der Baustein selbst verfügt über keine Optionen. Auf den Baustein darf nur der Baustein "Ende" folgen; sonst lässt sich der Workflow nicht aktiv speichern.
Achtung
Diesem Baustein ist immer ein Bedingungsbaustein voranzustellen. Fehlt die Bedingung, löscht ein zeitgesteuerter Workflow bei jedem Lauf alle aktiven CIs der referenzierten CI-Kategorie bzw. des referenzierten CI-Typs einschließlich der darunter liegenden Ebenen (siehe Allgemeines). Der Vorgang ist endgültig.
Hinweis
Falls ein CI durch einen Workflow mit diesem Baustein gelöscht wird, ist dies endgültig und kann nicht rückgängig gemacht werden. Beim Hinzufügen des Bausteins in den Konfigurationsbereich erscheint ein entsprechender Warnhinweis.
Hinweis
Der Baustein "Aktion - CI löschen" lässt sich nur mit Bedingungsbausteinen kombinieren. Wird der Baustein "Aktion - CI löschen" in den Konfigurationsbereich gezogen, stehen die anderen Bausteine im Auswahlbereich nicht mehr zur Verfügung. Umgekehrt steht der Baustein "Aktion - CI löschen" nicht mehr zur Verfügung, wenn bereits andere Bausteine in den Konfigurationsbereich gezogen wurden.
Aktionsbaustein "Benachrichtigung"
Der Baustein "Benachrichtigung" versendet eine E-Mail an einen oder mehrere Empfänger.
Der Baustein "Benachrichtigung" bietet folgende Einstellungen:
Empfänger: Pflichtfeld zur Definition des Empfängerkreises für die Benachrichtigung
Mögliche Empfänger:
Anwender: Der Empfänger ist der Benutzer, der die Beziehung "Person ist Anwender von Service Operation Ticket" zum CI hat.
Hinweis: Anwender als Empfänger steht nur zur Verfügung, wenn der Workflow sich auf die CI-Kategorie "Service Operation" oder darunter liegende CI-Kategorie/Typen bezieht.
Benutzer: Auswahl eines Benutzers, der benachrichtigt werden soll.
Benutzergruppen: Auswahl einer Personengruppe, deren Mitglieder benachrichtigt werden (siehe Konfiguration von "Personengruppen").
Zusätzliche Möglichkeiten bei Workflows, die sich auf die CI-Kategorie "Service Operation" beziehen:
Zuständige Benutzergruppe: Benutzergruppe, die die Beziehung "Personengruppe bearbeitet Service Operation Ticket" zum betroffenen CI hat.
Automatische Kategorisierung: Benutzergruppe, die sich anhand der automatischen Kategorisierung ergibt (siehe Konfiguration von "Kategorisierung").
Zuständige 1st/2nd/3rd Level Benutzergruppe: Benutzergruppe, die sich anhand der Zuständigkeiten ergibt (siehe Konfiguration von "Zuständigkeiten").
Beziehung zu Benutzer/Benutzergruppe: Ausgewählt werden Beziehungen des betroffenen CI-Typs zu Personen oder Personengruppen. Benachrichtigt werden die Personen oder Personengruppen, die in dieser Beziehung zum CI stehen. Beispiel: der Nutzer eines Computers.
CI-Ersteller: Benachrichtigt wird der Benutzer, der das CI (z. B. ein Ticket) angelegt hat (siehe bei allen CIs das Attribut "Erstellt durch").
Rolle: Auswahl einer Rolle, deren zugeordnete Benutzer benachrichtigt werden.
Vorgesetzter: Benachrichtigt wird der Benutzer, der die Beziehung "Person ist Vorgesetzter von Person" zu der Person hat, die die Beziehung "Person ist Anwender von Service Operation Ticket" zum CI hat.
Hinweis: Für die Zuständigkeit 'Vorgesetzter' einer Benachrichtigung wird als Empfänger der Vorgesetzte des Anwenders eines CIs ermittelt. Ist kein Anwender angegeben, erhält der Vorgesetzte des CI-Erstellers die Nachricht. Maßgeblich ist dabei die Beziehung "Person ist Vorgesetzter von Person".
Zuständiger Benutzer: Benutzer, der die Beziehung "xyz" zum betroffenen CI hat.
Kundenverantwortlicher: Der Empfänger ist der Benutzer, der die Beziehung "ist Kundenverantwortlicher von" zu dem Unternehmen hat, dem auch der Anwender des CI über die Beziehung "Unternehmen hat Mitarbeiter Person" zugehörig ist.
Hinweis: Kundenverantwortlicher als Empfänger steht nur zur Verfügung, wenn der Workflow sich auf die CI-Kategorie "Service Operations" oder darunter liegende CI-Kategorie/Typen bezieht.
Mitteilung: Pflichtfeld für den Betreff der Benachrichtigung per E-Mail bzw. der Tool-internen Systemnachricht.
Beschreibung: Optionaler Wert für die Beschreibung in der Benachrichtigung.
Hinweis
In den Feldern "Mitteilung" und "Beschreibung" können Platzhaltervariablen ($Variablen$) verwendet werden: Dies können Werte aus den Attributen des CIs sein, das den Workflow initiiert hat, oder in den Systemeinstellungen > Systemvariablen definierte Werte. Beziehen sich die Platzhaltervariablen auf CI-Attribute, stehen nicht die Anzeigenamen der Attribute, sondern die technischen Namen der Attribute zur Verfügung. Die Liste der nutzbaren Platzhaltervariablen wird automatisch angezeigt, wenn das $-Zeichen eingegeben wird.
Die von dot4 ausgelieferten Systemvariablen sind beim Aktionsbaustein "Aktion - Änderung" aufgeführt.
Hinweis
Jeder Benutzer kann unter seinen persönlichen Einstellungen festlegen, ob er die Workflow-Updates per E-Mail und/oder Systemnachricht erhalten möchte. Erreichen Benachrichtigungen einen Benutzer nicht, ist diese Einstellung zu prüfen.
Aktionsbaustein "Aktion - Sicherheitsgruppen"
Dieser Baustein ändert die Zugehörigkeit eines CIs zu den Sicherheitsgruppen.
Der Baustein "Aktion - Sicherheitsgruppen" benötigt folgende Eingaben:
Änderungsart:
Hinzufügen: Das CI wird zu den im folgenden Feld definierten Sicherheitsgruppen hinzugefügt. Bereits vorhandene Sicherheitsgruppenzuordnungen des CIs bleiben erhalten.
Überschreiben: Die Sicherheitsgruppenzuordnungen des CIs werden durch die im folgenden Feld getroffene Auswahl ersetzt. Bereits vorhandene Sicherheitsgruppenzuordnungen des CIs werden entfernt.
Sicherheitsgruppen: Auswahl keiner, einer oder mehrerer Sicherheitsgruppen (Mehrfachauswahl).
Daneben steht das Feld "Baustein-Dokumentation" zur Verfügung.
Der Baustein steht nur zur Verfügung, wenn die Rolle des Benutzers unter "Sicherheitsgruppenadministration" die Berechtigungen "Anzeigen" und "Bearbeiten" besitzt.
Achtung
Die Änderungsart "Überschreiben" ersetzt die Sicherheitsgruppenzuordnungen des CIs vollständig. Bleibt die Auswahl im Feld "Sicherheitsgruppen" leer, verliert das CI alle Sicherheitsgruppen. Die Oberfläche verhindert das nicht: Die leere Auswahl ist ein zulässiger Zustand des Dialogs. Ein CI ohne Sicherheitsgruppenzuordnung ist anschließend für jede Rolle unsichtbar, die einer Sicherheitsgruppe angehört (siehe Wie Sicherheitsgruppen den Zugriff verändern).
Beispiel: Wird ein CI vom Typ Service Request der Kategorie 'HR' zugewiesen, soll automatisch die Sicherheitsgruppe 'HR' gesetzt werden. So können nur Personen mit einer Rolle, die dieser Sicherheitsgruppe zugewiesen ist, die entsprechenden Service Requests bearbeiten. Zusätzlich kann ein weiterer Baustein dieses Typs sicherstellen, dass sämtliche Zuweisungen an andere Sicherheitsgruppen vor der Zuweisung an 'HR' entfernt werden.
Konfiguration der Workflows
Ein Benutzer, dessen Rolle die entsprechende Berechtigung besitzt, konfiguriert Workflows unter Administration > Workflows > Workflow-Übersicht; dort erscheint eine Liste der vorhandenen Workflows.
Bereits aufgelistete Workflows werden über die Schaltflächen in der jeweiligen Zeile bearbeitet:
Schaltfläche "Löschen": Löschen des Workflows
Schaltfläche "Bearbeiten": Bearbeiten des Workflow-Namens und der Beschreibung
Schaltfläche "Details": Wechsel in den Konfigurationsbereich des Workflows
Schaltfläche "Aktivieren" bzw. "Deaktivieren": Schaltet den Workflow für die Workflow-Engine frei bzw. wieder ab. Die Schaltflächen erscheinen nur bei Workflows, die aktivierbar sind.
Schaltfläche "Jetzt starten": Plant einen zeitgesteuerten Workflow zur sofortigen Ausführung ein. dot4 legt dazu einen einmaligen Plan-Eintrag auf den aktuellen Zeitpunkt; ausgeführt wird dieser Eintrag wie jeder andere beim nächsten Prüflauf des Background Job Runners.
Bei Neuanlage eines Workflows über die Schaltfläche "Workflow erstellen" ("+"-Zeichen) öffnet der Workflow Editor den Dialog "Workflow - Allgemeine Daten". Dort stehen folgende Eingabemöglichkeiten zur Verfügung:
Name: Pflichtfeld für den Namen des Workflows
Beschreibung: Optionale Beschreibung des Workflows
CI-Kategorie/-Typ: Pflichtfeld zur Festlegung der CI-Kategorie oder des CI-Typs, auf die bzw. den sich der Workflow bezieht.
Workflow Trigger: Optionale Zuordnung eines oder mehrerer Workflow-Trigger, die den Workflow auslösen.
Ausführungsplan: Tabelle der Zeitpläne, zu denen der Workflow zeitgesteuert läuft, mit den Spalten "Häufigkeit", "Monat", "Tag", "Uhrzeit" und "Letzte Ausführung". Das "+"-Zeichen legt einen neuen Eintrag an.

Über den Baustein "Start" lässt sich dieser Dialog später jederzeit wieder aufrufen, um die Angaben zu ändern.
Die Konfigurationsoberfläche für Workflows besteht aus zwei Hauptbereichen:
Der linke Bereich "Bausteine" zeigt die zur Verfügung stehenden Bausteine (siehe Detailbeschreibungen). Bausteine werden ggf. automatisch ausgeblendet, wenn die bereits erfolgte Konfiguration im Arbeitsbereich ihre Nutzung ausschließt. Über die Suchzeile "Bausteine filtern" oberhalb der Liste lässt sich die Anzeige auf die Bausteine einschränken, deren Beschriftung den eingegebenen Text enthält. Eine leere Suchzeile zeigt wieder alle Bausteine an.
Der rechte Bereich ist der Arbeitsbereich, in dem der Workflow konfiguriert wird. Die Bausteine werden aus dem linken Bereich per Drag-and-Drop in den rechten Bereich gezogen.
Arbeiten im Konfigurationsbereich
Beim Erstellen eines neuen Workflows sind initial die Bausteine "Start" und "Ende" vorhanden und miteinander verbunden. Sie können nicht gelöscht werden und markieren den Start- und Endpunkt des Workflows. Die Verbindungslinie zwischen beiden wird durch Anklicken markiert und mit der "Entf"-Taste gelöscht.

Allgemeine Regeln zu Workflows
Mindestens eine Aktion muss vorhanden sein.
Die (Pflicht-)Felder aller Bausteine müssen korrekt befüllt sein.
Drag-and-Drop-Funktionen
Bausteine hinzufügen: Ein Baustein wird im linken Bereich "Bausteine" ausgewählt und in den rechten Bereich (Arbeitsbereich) gezogen.
Bausteine entfernen: Ein im Arbeitsbereich selektierter Baustein (fetter Rahmen) wird mit der "Entf"-/"Del"-Taste entfernt.
Linien entfernen: Eine im Arbeitsbereich selektierte Linie (Linie wird fett) wird mit der "Entf"-/"Del"-Taste entfernt.
Bausteine bewegen: Ein im Arbeitsbereich selektierter Baustein (fetter Rahmen) wird mit gedrückter linker Maustaste bewegt.
Linie bewegen: Eine im Arbeitsbereich selektierte Linie (Linie wird fett) wird mit gedrückter linker Maustaste bewegt.
Linie ziehen/erstellen: Die Linie wird vom Baustein, von dem sie ausgeht (der Mauszeiger wandelt sich in eine Hand), zu dem Baustein gezogen, zu dem sie führt. Bei Bedingungsbausteinen beginnt die Verbindungslinie am gewünschten Ausgang (WAHR oder FALSCH).
Bausteine kopieren und einfügen
Bausteine lassen sich innerhalb des Arbeitsbereiches kopieren, statt sie erneut aus der Baustein-Liste zu ziehen und neu zu konfigurieren. Kopiert werden die Bausteine mit ihrer Konfiguration und mit den Verbindungslinien, die zwischen den kopierten Bausteinen verlaufen. Kopieren und Einfügen stehen nur im Bearbeitungsmodus zur Verfügung: Im Anzeigemodus werden die Schaltflächen nicht angezeigt, und auch die Tastenkürzel bleiben dort ohne Wirkung.

Alles auswählen: "Strg"+"A" selektiert alle Bausteine im Arbeitsbereich.
Kopieren: "Strg"+"C" oder die Schaltfläche "Kopieren" oberhalb des Arbeitsbereiches.
Ausschneiden: "Strg"+"X".
Einfügen: "Strg"+"V" oder die Schaltfläche "Einfügen". Die Bausteine werden gegenüber dem Original versetzt eingefügt und sind anschließend selektiert, sodass sie sich in einem Zug an ihren Platz ziehen lassen.
Beide Schaltflächen sind nur aktiv, wenn es etwas zu kopieren beziehungsweise etwas einzufügen gibt. Es gelten folgende Einschränkungen:
Die Bausteine "Start" und "Ende" werden nicht kopiert. Sie bleiben je Workflow einmalig; eine Auswahl, die sie enthält, wird ohne sie kopiert.
Eine Verbindungslinie allein lässt sich nicht kopieren. Eine Linie wird nur übernommen, wenn beide Bausteine, die sie verbindet, mit kopiert werden.
Die Gruppen-Bausteine "UND-Bedingung" und "ODER-Bedingung" lassen sich kopieren, aber nicht ausschneiden: Beim Entfernen einer Gruppe fragt dot4 zunächst, was mit ihren Bausteinen geschehen soll, und ein Ausschneiden würde diese Abfrage umgehen.
Ein Baustein "Genehmigung", zu dem noch offene Genehmigungen vorliegen, lässt sich kopieren, aber nicht ausschneiden: Der eingefügte Baustein ist ein neuer Baustein, und die offenen Genehmigungen des ausgeschnittenen gingen beim Speichern verloren.
Die Zwischenablage gehört zum geöffneten Editor. Zwischen zwei Workflows lassen sich keine Bausteine übertragen; soll ein ganzer Workflow als Vorlage dienen, wird stattdessen eine Kopie des Workflows angelegt (siehe Tipps zum Thema Workflows).
Suche im Arbeitsbereich
Über die Schaltfläche "Bausteine durchsuchen" oberhalb des Arbeitsbereiches wird ein Eingabefeld für einen Suchbegriff geöffnet. Alle Bausteine, deren Beschreibungstexte den Suchbegriff enthalten, werden im Arbeitsbereich farbig umrandet. Groß- und Kleinschreibung werden dabei nicht unterschieden.
Wird das Eingabefeld wieder geschlossen, bleiben der Suchbegriff und die Hervorhebung erhalten. Die Schaltfläche bleibt so lange hervorgehoben, wie ein Suchbegriff gesetzt ist. Das Leeren des Eingabefeldes hebt die Markierung auf.
Anordnung im Arbeitsbereich
Über die Schaltfläche "Anordnung" oberhalb des Arbeitsbereiches werden die Bausteine automatisch angeordnet. Zur Auswahl stehen "Von oben nach unten" und "Von links nach rechts". Beide Anordnungen richten den Workflow entlang seiner Flussrichtung aus, setzen den "Start"-Baustein an den Anfang und den "Ende"-Baustein an das Ende und verlegen die Verbindungslinien zwischen den Bausteinen neu.
Tipps zum Thema Workflows:
In der "Administration > Workflows > Workflow-Übersicht" lassen sich Spalten einblenden, die zeigen, wer einen Workflow wann angelegt oder zuletzt verändert hat.
Oberhalb des Arbeitsbereiches zur Konfiguration eines Workflows
finden sich mehrere Icons zur Optimierung der Darstellung wie "Anordnung" mit den Optionen "Von oben nach unten" und "Von links nach rechts", "Größe dem Inhalt anpassen", "Vergrößern" und "Verkleinern". Sie verbessern die Übersichtlichkeit beim Anlegen von Workflows.
gibt es einen Button, mit dem eine Kopie eines Workflows angelegt werden kann. Der Name der Kopie ist der gleiche wie im Original, allerdings ergänzt um einen Zähler am Ende. Die Kopie ist direkt nach der Erzeugung auf inaktiv gesetzt.
Die "esc"-Taste bricht das versehentliche Ziehen einer Verbindungslinie im Arbeitsbereich ab.
Tipp
Damit ein neuer Workflow wirksam wird, ist sein Status im Kopfbereich vor dem Speichern auf Aktiv zu setzen.
Workflow-Trigger
Durch Workflow-Trigger wird die Ausführung eines Workflows auf bestimmte auslösende Ereignisse beschränkt. Die Liste aller Trigger befindet sich unter Administration > Workflows > Workflow-Trigger.

Die Spalte "Workflows" zeigt, welche Workflows der jeweilige Trigger ausführt; die Spalte "System" kennzeichnet die mitgelieferten Trigger, deren Name und Beschreibung nicht geändert werden können.
Folgende System-Trigger sind vorhanden:
| Name | Beschreibung |
|---|---|
| Always | Der Workflow (WF) wird beim Schreiben eines CI ausgelöst. Es wird nicht unterschieden, ob der Schreibprozess durch die UI, einen Import oder einen API-Aufruf ausgelöst wird. Er wird sowohl beim Anlegen als auch beim Ändern eines CI ausgelöst. Dieser Trigger ist aus Kompatibilitätsgründen vorhanden. |
| API CI create | Der WF wird beim Anlegen eines CI über einen API-Aufruf ausgelöst |
| API CI update | Der WF wird beim Aktualisieren eines CI über einen API-Aufruf ausgelöst |
| E-mail to Ticket create | Der WF wird ausgelöst, wenn ein Ticket aus einer E-Mail erstellt wird |
| E-mail to Ticket update | Der WF wird ausgelöst, wenn ein Ticket aus einer E-Mail aktualisiert wird |
| Import CI create | Der WF wird beim Anlegen eines CI über einen Import ausgelöst |
| Import CI update | Der WF wird beim Aktualisieren eines CI über einen Import ausgelöst |
| UI CI create | Der WF wird beim Anlegen eines CI in der Benutzeroberfläche ausgelöst |
| UI CI update | Der WF wird beim Aktualisieren eines CI in der Benutzeroberfläche ausgelöst |
Daneben gibt es selbstdefinierte Trigger. Sie lösen – abseits der oben genannten Ereignisse – Workflows über Schaltflächen in der Detailsicht eines CIs aus.
Ein eigener Trigger wird über das "+"-Zeichen in der Werkzeugleiste der Trigger-Liste angelegt. Der Dialog verlangt folgende Angaben:
| Feld | Beschreibung |
|---|---|
| WF-Trigger Name | Ein aussagekräftiger, frei wählbarer Name |
| Beschreibung | Angaben über Verwendung und Zweck des Triggers |
| Workflows | Ein oder mehrere Workflows, die beim Auslösen des Triggers ausgeführt werden |

Ein selbstdefinierter Trigger wird in folgenden Schritten vollständig eingerichtet:
Der Trigger wird unter Administration > Workflows > Workflow-Trigger angelegt; im Feld "Workflows" werden ihm die Workflows zugeordnet, die er ausführen soll.
An der CI-Kategorie oder am CI-Typ wird ein CI-Attribut mit dem Basis-Datentyp Aktion und dem Datentyp Workflow Trigger erstellt. In diesem Attribut werden der zuvor angelegte "Workflow Trigger" sowie das "Bild" für die Schaltfläche ausgewählt.
In der Detailsicht der betroffenen CIs steht die Schaltfläche anschließend zum manuellen Auslösen bereit.
Über einen Zeit-Trigger wird ein Workflow in einem geplanten Rhythmus ausgeführt.
Folgende Häufigkeiten stehen zur Verfügung:
| Häufigkeit | Beschreibung | Erforderliche Angaben |
|---|---|---|
| Einmalig | Der WF wird einmalig zu einem gewünschten Zeitpunkt geplant. | Datum und Uhrzeit |
| Stündlich | Der WF wird stündlich zu einer gewünschten Minute geplant. | Minute |
| Täglich | Der WF wird täglich zu einer gewünschten Uhrzeit geplant. | Uhrzeit |
| Wöchentlich | Der WF wird wöchentlich zu einem gewünschten Tag und Uhrzeit geplant. | Wochentag und Uhrzeit |
| Monatlich | Der WF wird monatlich zu einem gewünschten Tag im Monat geplant. | Tag im Monat und Uhrzeit |
| Jährlich | Der WF wird jährlich zu einem gewünschten Tag geplant. | Monat, Tag und Uhrzeit |
Wird bei der Häufigkeit "Jährlich" der 29. Februar gewählt, weist dot4 bei der Eingabe darauf hin, dass die Ausführung in Nicht-Schaltjahren am 28. Februar erfolgt.
Ein Ausführungsplan kann mehrere Einträge enthalten. Einen Eintrag, der mit einem bereits vorhandenen Eintrag identisch ist, weist dot4 ab.
Ein Plan-Eintrag mit der Häufigkeit "Einmalig" wird nach dem Lauf automatisch aus dem Ausführungsplan entfernt. Der Workflow selbst bleibt erhalten — für eine erneute zeitgesteuerte Ausführung wird ein neuer Plan-Eintrag angelegt. Bei allen anderen Häufigkeiten berechnet dot4 nach jedem Lauf den nächsten Ausführungszeitpunkt.
Hinweis
Die geplante Zeit ist der früheste Ausführungszeitpunkt, nicht der garantierte. Zeitgesteuerte Workflows führt nicht die Anwendung selbst aus, sondern der Background Job Runner: Er prüft in festen Intervallen, ob die Ausführung eines Workflows aufgrund eines Zeittriggers fällig ist, und führt sie dann aus; zwischen der geplanten Zeit und der tatsächlichen Ausführung liegt daher bis zu ein Prüfintervall. Das gilt für jeden Betriebsweg. Wie oft geprüft wird, legt die Einrichtung der jeweiligen Installation bzw. Betriebsumgebung fest. Bei einer On-premise-Installation legt das Setup für diese Prüfung einen Takt von 30 Minuten an, sofern bei der Installation kein anderer Wert angegeben wird. Sind mehrere Zeittrigger desselben Workflows gleichzeitig fällig, wird der Workflow nur einmal ausgeführt und alle fälligen Trigger werden als behandelt betrachtet.
Tipp
Eine halbstündliche Ausführung ergibt sich aus zwei stündlichen Einträgen, beispielsweise auf Minute 5 und Minute 35.
Welche CIs ein zeitgesteuerter Lauf erfasst, ist unter Allgemeines beschrieben; das Bedingungs-Tracking begrenzt die Wiederholung auf noch nicht behandelte CIs. Ein zeitgesteuerter Workflow lässt sich zusätzlich über die Schaltfläche "Jetzt starten" zur sofortigen Ausführung einplanen: dot4 legt dazu einen einmaligen Plan-Eintrag auf den aktuellen Zeitpunkt, den der Background Job Runner bei seinem nächsten Prüflauf ausführt (siehe Konfiguration der Workflows).
HTTP-Endpunkte
HTTP-Endpunkte sind URLs zu RESTful API Web-Services, die die Übergabe von dot4 CI-Daten per POST zur Weiterverarbeitung ermöglichen.
HTTP-Endpunkte werden in einem Workflow vom Baustein REST verwendet.
Die eingerichteten Endpunkte werden unter Administration > Workflows > HTTP-Endpunkte verwaltet.
Die Übersicht führt je Endpunkt die Spalten "Name", "Beschreibung" und "URL".
Ein neuer Endpunkt wird über das "+"-Zeichen in der Werkzeugleiste angelegt.

Ein HTTP-Endpunkt benötigt folgende Eingaben:
Name: Aussagekräftige Bezeichnung des HTTP-Endpunktes (Pflichtfeld)
Beschreibung: Erläuternder Text zu Zweck und Ziel des Endpunktes
URL: Die URL des Endpunktes (Pflichtfeld)
Timeout (in Sekunden): Die Zeitspanne in Sekunden, bevor der Aufruf des Endpunktes mit Fehler abgebrochen wird (Default: 30 sek)
Authentifizierung: Ist bei der REST-Schnittstelle eine Authentifizierung nötig, wird dieser Schalter aktiviert.
Benutzer: Der Benutzername, mit dem sich der HTTP-Endpunkt authentifiziert
Passwort: Das Kennwort, mit dem sich der HTTP-Endpunkt authentifiziert. Das Passwort kann zur Überprüfung mit dem Auge-Symbol im Klartext angezeigt werden.
Die Schaltfläche Verbindung testen prüft, ob der Aufruf des HTTP-Endpunktes erfolgreich ist.
Hinweis
Beim Aufruf eines Endpunktes durch einen Workflow werden die CI-Attribute des vom Workflow verarbeiteten CIs als JSON-Datenformat gesendet.
Einen Endpunkt, den noch ein Workflow verwendet, lehnt dot4 zum Löschen ab. Erst wenn der betreffende Baustein REST aus allen Workflows entfernt ist, die den Endpunkt nutzen, lässt sich der Endpunkt löschen.
HTTP-Authentifizierungen
Eine HTTP-Authentifizierung bündelt die Zugangsdaten, mit denen sich der Baustein "Http Request" gegenüber einem fremden System ausweist. Sie ist ein eigenständiges Objekt, das einmal gepflegt und in beliebig vielen Workflows verwendet wird. Ändert sich ein Kennwort, wird es nur an dieser einen Stelle angepasst.
Die Authentifizierungen werden unter Administration > Workflows > HTTP-Authentifizierungen verwaltet. Die Übersicht führt je Eintrag die Spalten "Name", "Beschreibung" und "Authentifizierungstyp".
Eine Authentifizierung benötigt folgende Eingaben:
Name: Aussagekräftige Bezeichnung (Pflichtfeld). Der Name ist eindeutig; an ihm ist die Authentifizierung im Baustein erkennbar.
Beschreibung: Erläuternder Text, etwa wofür die Zugangsdaten gelten und wer sie verantwortet.
Authentifizierungstyp: Bestimmt, welche weiteren Felder erscheinen:
Standard (Basic): Benutzer und Kennwort.
Clientzertifikat: Eine PKCS#12-Datei (.pfx oder .p12) und deren Kennwort. dot4 prüft die Datei beim Speichern und zeigt danach Dateiname, Fingerabdruck und Ablaufdatum an.
Active Directory OAuth: Verzeichnis-(Tenant-)ID, Anwendungs-(Client-)ID, Clientschlüssel und Scope beziehungsweise Zielgruppe. Hinweis zu Power Automate und anderen Microsoft-Zielen: Die Ressourcen-URI wird mit abschließendem Schrägstrich und ohne
/.defaultangegeben, etwahttps://service.flow.microsoft.com/.OAuth: Token-Endpunkt, Anwendungs-(Client-)ID, Clientschlüssel und Scope. Der Token-Endpunkt muss eine vollständige http- oder https-Adresse sein; Platzhalter sind hier nicht möglich.
Raw: Der vollständige Wert des
Authorization-Headers, so wie er gesendet werden soll.
Hinweis
Kennwörter, Clientschlüssel, der Raw-Header und die Zertifikatsdatei werden nie an den Browser zurückgegeben. Nach dem Speichern zeigen die betreffenden Felder nur den Hinweis "Hinterlegt": Das Feld bleibt leer, und ein leeres Feld bedeutet beim Speichern "gespeicherten Wert behalten". Ein Geheimnis lässt sich also überschreiben, aber nicht auslesen — auch nicht von dem Benutzer, der es eingegeben hat.
Zum Verwenden einer Authentifizierung im Baustein "Http Request" genügt das Recht, Workflows zu bearbeiten; das Recht auf diese Kachel wird dafür nicht benötigt. So können die Zugangsdaten von jemand anderem gepflegt werden als von den Workflow-Autoren.
Achtung
Wer Workflows bearbeiten darf, kann eine Authentifizierung auch gegen eine selbst gewählte Adresse einsetzen und sich die Zugangsdaten auf diesem Weg zuschicken lassen. Die Trennung schützt davor, dass Zugangsdaten ausgelesen oder verändert werden, nicht davor, dass sie verwendet werden. Das Recht, Workflows zu bearbeiten, ist entsprechend sorgfältig zu vergeben.
Eine Authentifizierung, die noch ein Baustein verwendet, lehnt dot4 zum Löschen ab und nennt die betroffenen Workflows. Erst wenn der Baustein dort geändert ist, lässt sich die Authentifizierung löschen.
Workflow-Log
Die Workflow-Log wird aktiviert, indem unter "Administration > Systemeinstellungen > Allgemeine Einstellungen" für den "Workflow Log-Level" ein anderer Wert als "Aus" festgelegt wird. Die einstellbaren Log-Level sind:
Aus (Workflow-Log ausgeschaltet, es werden keine Logeinträge geschrieben)
Debug (alle Events vom Level Info, Warnung, Fehler werden in die Log geschrieben)
Info (alle Events ab Level Info werden in die Log geschrieben)
Warnung (alle Events ab Level Warnung werden in die Log geschrieben)
Fehler (alle Events ab Level Fehler werden in die Log geschrieben)
Die Workflow-Log ist über Administration > Workflows > Workflow-Log erreichbar.
Die Schaltfläche "Alle löschen" in der Werkzeugleiste leert das Protokoll vollständig. Der Vorgang läuft im Hintergrund und setzt voraus, dass die Rolle des Benutzers die Löschberechtigung für den Workflow-Editor besitzt.
Anmerkungen / Hinweise
Das Setzen des "Workflow Log-Level" auf "Aus" stoppt das Schreiben der Log. Bereits vorhandene Einträge können weiterhin ausgewertet werden.
Ein Hintergrund-Prozess löscht Einträge, die älter als der eingestellte Aufbewahrungszeitraum sind. Der Standardwert beträgt 3 Tage und ist konfigurierbar.
Ein leeres Protokoll bedeutet entweder, dass noch kein Workflow gelaufen ist, oder dass der "Workflow Log-Level" auf "Aus" steht.
Welche Spalten angezeigt werden, legt die Spaltenauswahl in der Werkzeugleiste fest; die Einstellung wird pro Benutzer gespeichert. Die Workflow-Log verfügt über die folgenden Spalten:
Benutzer (Bei Workflows, die über einen Zeittrigger ausgeführt wurden, ist dies immer "System", bei allen anderen Workflows der Benutzer, dessen Änderung den Workflow ausgelöst hat.)
Benutzer ID
Beschreibung (Anmerkung: Der Wert wird aktuell nicht befüllt)
CI ID (Interne ID des betroffenen CIs)
CI Name (Name des CI / Titel des Tickets)
CI Typ (siehe CMDB-Modell)
Dauer (Sek.) (Dauer der Ausführung des Workflows zum betroffenen CI/Ticket)
Endzeit (Ende der Ausführung des Workflows zum betroffenen CI/Ticket)
Mandant (der aktuelle Mandant)
Startzeit (Beginn der Ausführung des Workflows zum betroffenen CI/Ticket)
Version (Version des Workflows; siehe auch in der Workflow-Übersicht)
Workflow ID (Interne ID des Workflows)
Workflow Log ID (Durchlaufende ID der Workflow Log)
Workflow Name (Name des Workflows)
Workflow Status (z. B. "Erfolg", "Warnung", "Fehler")
Workflow Typ ("Timed" = zeitgesteuert, "Default" = ereignisgesteuert)
Workflow-Trigger (Name des Workflow-Triggers, der die Ausführung ausgelöst hat)
Workflow-Log Details
Jeder Eintrag der Workflow-Log öffnet sich per Doppelklick oder über die Zeilenaktion "Anzeigen". Je nach eingestelltem "Workflow Log-Level" sind dort vertiefende Details einsehbar.
Für die Fehlersuche an einem einzelnen Workflow hat sich folgendes Vorgehen bewährt: Der "Workflow Log-Level" wird auf "Debug" gesetzt, der Workflow ausgelöst und der Log-Eintrag ausgewertet; anschließend wird der Log-Level wieder auf "Aus" gesetzt.
Hinweis
Der "Workflow Log-Level" gilt mandantenweit für alle Workflows, nicht nur für den untersuchten Workflow.