Workflows

Inhaltsverzeichnis

Workflows

Unter “Administration” im Bereich "Workflow" kann der Benutzer seine Testify-Umgebung automatisieren. Es können bestimmte Events definiert werden, die Aktionen auslösen. Workflows können aktiviert, deaktiviert, überschrieben, aber nicht gelöscht werden.

Workflows hinzufügen

Beim Hinzufügen eines neuen Workflows muss der Benutzer einen Titel definieren. Der Titel sollte aussagekräftig sein, damit man schon im Menü erkennen kann, welche Aufgabe der Workflow erfüllt. Nach der Definition eines aussagekräftigen Titels muss das auslösende Event und die anschließende Aktion definiert werden. Bei Bedarf können auch mehrere auslösende Events und Aktionen hinzugefügt werden.

Jedes Event, jede Aktion sowie der gesamte Workflow müssen separat gespeichert werden.

Events

Im Abschnitt " Events " müssen Schritte definiert werden, die erfüllt sein müssen, um die Aktion auszulösen. Bei der Erstellung von Events müssen die folgenden Informationen angegeben werden:

  • Bereich: Der Geltungsbereich definiert die Entität, in der das Event stattfindet

  • Typ: Der Typ definiert die Änderung der Entität (abhängig von der Entität)

  • Filter/Trigger: Mithilfe von Filtern können die gewünschten Bedingungen spezifiziert werden. Hier kann definiert werden, dass das Event nur für bestimmte Filter (wie Prüfobjekte, Checklistenvorlagen usw.) gültig ist.

    • Filter: Filtert nach Eigenschaften des Objekts

    • Trigger: Definiert das Feld, welches auf einen bestimmten Wert geändert werden muss, um den Workflow auszulösen. Diese Bedingung muss erfüllt sein, damit der Workflow ausgelöst wird.

    • Filter vor Änderung: Filtert nach Eigenschaften des Objekts vor der Änderung (Sollte sich eine Eigenschaft des betroffenen Objekts geändert haben, kann man auf den Wert vor der Änderung, also vor Auslösung des Events filtern).

    • Filter nach Änderung: Filtert nach Eigenschaften des Objekts nach der Änderung (Diese Bedingung muss zum Zeitpunkt des Ausführens des Workflows zutreffen).

→ Unterschied Trigger und Filter vor/nach Änderung

  • Beispiel: Status Verifiziert → Das Event wird dann getriggert, wenn sich der Checklistenstatus auf verifiziert ändert. Ein Filter vor Änderung kann, aber muss nicht definiert werden (Beispielsweise Status Abgeschlossen).

  • Der Filter vor Änderung findet nur dann Anwendung, wenn sich die Eigenschaft auch wirklich geändert hat. Ist die Eigenschaft vor und nach dem Event gleich oder fehlerhaft, wird der Workflow nicht ausgeführt, da der Filter nicht zutrifft

Bereich: Checkliste

  • Typ: erstellt

    • Mögliche Filter: Prüfobjekt(typen), Status, Zugewiesen an, Erstellt von, Geändert von, Checklistenvorlagen

  • Typ: geändert

    • Mögliche Trigger: Status, Zugewiesen an, Geändert von

    • Mögliche Filter vor Änderung: Prüfobjekt(typen), Status, Zugewiesen an, Geändert von, Checklistenvorlagen

    • Mögliche Filter nach Änderung: Prüfobjekt(typen), Status, Zugewiesen an, Erstellt von, Geändert von, Checklistenvorlagen, Scoring

Bereich: Mangel

  • Typ: erstellt

    • Mögliche Filter: Prüfobjekt(typen), Status, Zugewiesen an, Erstellt von, Geändert von, Kategorie, Schweregrad

  • Typ: geändert

    • Mögliche Trigger: Prüfobjekt, Status, Zugewiesen an, Geändert von, Kategorie, Schweregrad

    • Mögliche Filter vor Änderung: Prüfobjekt(typen), Status, Zugewiesen an, Geändert von, Kategorie, Schweregrad

    • Mögliche Filter nach Änderung: Prüfobjekt(typen), Status, Zugewiesen an, Erstellt von, Geändert von, Kategorie, Schweregrad

Bereich: Prüfobjekt

  • Typ: erstellt

    • Mögliche Filter: Prüfobjekttypen, Erstellt von

Bereich: PDF

  • Typ: Mangel PDF erstellt

    • Mögliche Filter: Prüfobjekt(typen), Status, Zugewiesen an, Erstellt von, Geändert von, Kategorie, Schweregrad, PDF Protokoll-Profile

  • Typ: Checklisten PDF erstellt

    • Mögliche Filter: Prüfobjekt(typen), Status, Zugewiesen an, Erstellt von, Geändert von, Kategorie, Checklistenvorlagen, PDF Protokoll-Profile

Bereich: Benutzer

  • Typ: erstellt

    • Mögliche Filter: Rollen, Gruppen

Bereich: Timer

  • Typ: auslösen

  • Parameter: Cron timer

Mit der Timer-Funktion können Aufgaben periodisch geplant werden. Dies ist über einen Cron Timer möglich. Die Timer-Funktion kann auf Basis von Minuten, Stunden, Tagen, Wochen oder Monaten eingestellt werden. Der Cron-Trigger bezieht sich immer auf die UTC-Zeitzone, Zeiten sind daher gegebenenfalls umzurechnen (z. B. 12:00 Uhr UTC ist 14:00 Uhr MESZ in Österreich).

Die gewünschte Wiederholung kann entweder direkt im Cron-Format angegeben oder vorab manuell ausgewählt und umgerechnet werden. Bei der Umrechnung der gewünschten Wiederholung gibt es zwei Möglichkeiten:

  • Externer Umrechner: Gewünschte Wiederholung online auswählen und umrechnen

  • Selektierung der gewünschten Wiederholung inklusive automatischer Umrechnung direkt in Testify:

    • Minuten

      • z. B. alle 30 Minuten

    • Stunden

      • z. B. alle 2 Stunden oder immer um 10:00 Uhr AM UTC

    • Täglich

      • z. B. alle 2 Tage oder wochentags inkl. Wunschuhrzeit (z. B. 10:00 Uhr AM UTC)

    • Wöchentlich

      • Angabe der gewünschten Wochentage z. B. nur Montags, Montag & Freitag oder Montag-Samstag inkl. Wunschuhrzeit (z. B. 10:00 Uhr AM UTC)

    • Monatlich

      • Angabe des genauen Tages (z. B. 4. Tag pro Monat) oder

      • Letzter Tag des Monats oder

      • Letzter Wochentag des Monats oder

      • Angabe der Tage for Monatsende (z. B. 2 Tage vor Monatsende)

      • inkl. Wunschuhrzeit (z. B. 10:00 Uhr AM UTC)

Beispiel:

Aktionen

Beim Erstellen von Aktionen müssen folgende Informationen angegeben werden:

  • Bereich: Der Bereich definiert, welche Aktion ausgelöst werden soll.

  • Typ: Der Typ definiert die Änderung der Entität.

  • Parameter: Hier müssen Parameter für die ausgelöste Aktion definiert werden (wie Prüfobjekte, Checklistenvorlagen usw.). In diesem Abschnitt können die Werte, die bereits oben in "Filter" definiert wurden, einfach wiederverwendet werden, indem der Schalter "Feldwert wenn vorhanden aus Event wiederverwenden" ausgewählt wird.

    • Die Definition aller Parameter ist in diesem Abschnitt obligatorisch.

Bereich: Checkliste

  • Typ: erstellen

  • Parameter: Prüfobjekt, Zugewiesen an, Erstellt von, Checklistenvorlagen, Fälligkeitsdatum

Bereich: Mangel

  • Typ: erstellen

  • Parameter: Zugewiesen an, Erstellt von, Kategorie, Schweregrad, Fälligkeitsdatum

    • Optionale Parameter: Prüfobjekt, Titel, Beschreibung

Bereich: Webhook

  • Typ: auslösen

  • Parameter: URL

    • Optionale Parameter: Kennung, Timeout für HTTP-Requests in Sekunden (Standard ist 20), HTTP Status Codes bei erfolgreichem Request. Andere Codes führen zu mehreren Sendeversuchen.

Beispiel: https://testify.atlassian.net/wiki/spaces/TB/pages/2376630380/Workflow+Beispiele#Beispiel:-Aktion-Webhook

Bereich: PDF

Nur bei Events mit Bereich Checkliste oder Mangel möglich.

  • Typ: generieren

  • Parameter: PDF Protokoll-Profile, Sprache

Beispiel: https://testify.atlassian.net/wiki/spaces/TB/pages/2376630380/Workflow+Beispiele#Beispiel:-Aktion-PDF-generieren

Bereich: Benachrichtigung

  • Typ: senden

  • Parameter:

    • Standardsprache und Eingabefeld für die benutzerdefinierte Nachricht

      • Danach kann die Sprache geändert und eine benutzerdefinierte Nachricht auch übersetzt werden

    • Senden an: Wer die Benachrichtigung erhält (Personen oder Gruppen)

    • Benachrichtigungstyp (Mail oder In-App)

Beispiel:

Workflow bearbeiten / deaktivieren

Nach der Erstellung des Workflows kann dieser durch Klicken auf das Kontextmenü (die drei Punkte) in der oberen rechten Ecke des Workflows bearbeitet oder deaktiviert/aktiviert werden.

Workflow-Historie

Workflows haben eine Historie, bei der alle bisherigen Schritte angezeigt werden. Diese Funktion ermöglicht es, die erfolgreichen und fehlgeschlagenen Ausführungen aller Workflows zu überprüfen. Für jeden Ausführungsversuch wird ein eigener Eintrag mit allen relevanten Informationen erstellt. Um eine transparente Fehlersuche zu gewährleisten, können Filter gesetzt werden.

Ebenso wird angezeigt wann ein Workflow aktiviert/deaktiviert wurde und ob dies automatisch oder manuell durch eine Person geschehen ist.

Die Workflow-Historie kann durch Klicken auf das Kontextmenü (die drei Punkte in der rechten Ecke) angezeigt werden.

Durch Auswahl des gewünschten Eintrags wird die Historie angezeigt:

Alle wichtigen Informationen sind auf einen Blick ersichtlich. Durch das Link-Icon auf der rechten Seite können die einzelnen Punkte erweitert und weitere Details angezeigt werden.