Oracle APEX · · 3 Min.

APEX 26.2: Eigene Ergebnisse für Action Tasks

„Freigegeben“ und „Abgelehnt“ passen zu einer Genehmigung. Viele andere Arbeitsschritte brauchen differenziertere Ergebnisse – APEX 26.2 macht sie für Action Tasks konfigurierbar.

Ein Human Task ist nicht immer eine Genehmigung. Eine Fachkraft kann einen Vorgang abschließen, zur Klärung zurückgeben oder bis zu einem Termin zurückstellen. Mit dem Approval Task sind die fachlichen Antworten im Wesentlichen „Approved“ und „Rejected“. Oracle APEX 26.2 erweitert Action Tasks um eigene Outcomes. Diese Ergebnisse können Task-Aktionen auslösen und in Workflows für die weitere Verzweigung verwendet werden.

Ergebnisse in der Task Definition festlegen

Erstellen Sie unter Shared Components eine Task Definition vom Typ Action Task. Im Feld Outcomes tragen Sie die erlaubten Werte kommasepariert ein – ohne Anführungszeichen und ohne Leerzeichen, zum Beispiel:

READY,NEEDS_INFO,DEFERRED

Die Liste steuert die verfügbaren Ergebnisse auf der Task-Detailseite und wird beim Setzen eines Outcomes zur Prüfung herangezogen. Wählen Sie kurze, stabile technische Werte; die Erläuterung für Mitarbeitende gehört in die Beschriftung oder den Task-Kontext. Ein Action Task kann auch ohne Outcomes konfiguriert werden, wenn nur der Abschluss der Arbeit relevant ist.

Outcome und Abschluss auseinanderhalten

Ein Outcome ist das fachliche Ergebnis, nicht automatisch der Status des Tasks. Die APEX-API APEX_HUMAN_TASK.SET_TASK_OUTCOME setzt das Ergebnis einer Action Task. Das Ändern des Outcomes ist ausdrücklich ein separates Ereignis vom Abschließen der Aufgabe. Dadurch können Aktionen an die Outcome-Änderung gebunden werden, während der Task anschließend weiterhin regulär abgeschlossen werden muss.

BEGIN
  apex_human_task.set_task_outcome(
    p_task_id => 1234,
    p_outcome => 'NEEDS_INFO'
  );
END;
/

Die Task-ID ist ein Beispiel; das Outcome muss in der Task Definition zugelassen sein. Beim Abschließen über die Task-Detailseite wählen berechtigte Personen das Ergebnis im vorgesehenen Dialog aus.

Prozessdesign: Verwenden Sie Outcomes für den fachlichen Pfad und den Task-Status für den Lebenszyklus der Aufgabe. „Rückfrage erforderlich“ beschreibt das Ergebnis; „abgeschlossen“ beschreibt, ob die Bearbeitung des Tasks beendet wurde.

Mit Workflow-Zweigen verbinden

In einem Workflow können unterschiedliche Outcomes verschiedene Folgeschritte bedeuten: READY führt etwa zur nächsten Bearbeitung, NEEDS_INFO startet eine Rückfrage und DEFERRED führt in eine Warte- oder Wiedervorlage. APEX 26.2 erlaubt, die Outcomes von Action Tasks als Grundlage für solche Verzweigungen zu verwenden. Zusätzlich lassen sich Task-Definition-Aktionen an eine Outcome-Änderung hängen – beispielsweise eine Benachrichtigung oder eine nachvollziehbare Protokollierung.

  1. Nur fachlich unterschiedliche Ergebnisse definieren; Synonyme erzeugen unnötige Branches.
  2. Für jeden Outcome einen klaren Folgepfad und ein Verhalten bei fehlenden Werten festlegen.
  3. Prüfen, welche Task-Aktionen bei Änderung des Outcomes laufen und ob sie wiederholbar sein müssen.
  4. Den normalen Abschluss, Berechtigungen und Workflow-Zweige getrennt testen.
  5. Technische Werte nach Inbetriebnahme stabil halten oder Änderungen gezielt migrieren.

Eigene Outcomes machen Action Tasks für mehr als klassische Freigaben nutzbar. Der Gewinn entsteht, wenn die Werteliste klein und eindeutig bleibt und Task-Aktionen nicht mit dem Task-Abschluss verwechselt werden. So wird aus einer allgemeinen Aufgabe ein klarer Entscheidungspunkt im APEX-Prozess.

Weiterführend: Oracles Workflow- und Task-Neuerungen in APEX 26.2, die Anleitung zum Erstellen von Task Definitions und die API zu SET_TASK_OUTCOME.