Standardabläufe auslösen

In einem Dossier kann mit dem Endpoint @trigger-task-template ein bestehender Standardablauf ausgelöst werden.

Der Endpoint erwartet folgende Parameter:

  • tasktemplatefolder: Das zu verwendende Template aus dem Vokabular opengever.dossier.DocumentTemplatesVocabulary
  • tasktemplates: zu verwendende Aufgabenvorlagen und optional Auftragnehmer der zu erstellenden Aufgabe
  • related_documents: Optionale Verweise auf Dokumente/Mails
  • start_immediately: Erste Aufgabe nach Erstellung sofort starten

Beispiel-Request:

POST /ordnungssystem/fuehrung/dossier-23/@trigger-task-template HTTP/1.1
Accept: application/json

{
    "tasktemplatefolder": "67a25fc941354568950439f08f7af3ed",
    "tasktemplates": [
        {
            "@id": "http://localhost:8080/fd/vorlagen/tasktemplatefolder-1/tasktemplate-1",
            "responsible": "stv:david.erni"
        }
    ],
    "related_documents": [
        {
            "@id": "http://localhost:8080/fd/ordnungssystem/fuehrung/dossier-23/document-23515"
        }
    ],
    "start_immediately": true
}

Als Response wird die JSON-Repräsentation der neu erstellten Aufgabe geliefert, siehe Inhaltstypen.

Interaktive Auftragnehmer

Bei jeder ausgewählten Aufgabenvorlage kann der Auftragnehmer überschrieben werden. Der Auftragnehmer kann durch einen interaktiven Benutzer ersetzt werden. Es gibt dabei folgende Möglichkeiten:

  • interactive_actor:current_user: Der aktuelle Benutzer
  • interactive_actor:responsible: Die Federführende Person des Dossiers, in dem die Aufgabe erstellt wird

Beispiel-Request:

POST /ordnungssystem/fuehrung/dossier-23/@trigger-task-template HTTP/1.1
Accept: application/json

{
    "tasktemplatefolder": "67a25fc941354568950439f08f7af3ed",
    "tasktemplates": [
        {
            "@id": "http://localhost:8080/fd/vorlagen/tasktemplatefolder-1/tasktemplate-1",
            "responsible": "interactive_actor:current_user"
        }
    ],
    "start_immediately": false
}

Titel und Beschreibung setzen

Sowohl für die Hauptaufgabe wie auch für jede der ausgewählten Aufgabenvorlage kann Titel und Beschreibung der Aufgabe überschrieben werden. Dafür stehen folgende Felder zur Verfügung:

  • title: Setzt den Titel der Aufgabe (Default: Titel der Vorlage)
  • text: Setzt die Beschreibung der Aufgabe (Default: Beschreibung der Vorlage, oder Leer für die Hauptaufgabe)

Beispiel-Request:

POST /ordnungssystem/fuehrung/dossier-23/@trigger-task-template HTTP/1.1
Accept: application/json

{
    "tasktemplatefolder": "67a25fc941354568950439f08f7af3ed",
    "title": "Meine Aufgabe",
    "text": "Bitte sofort erledigen!",
    "tasktemplates": [
        {
            "@id": "http://localhost:8080/fd/vorlagen/tasktemplatefolder-1/tasktemplate-1",
            "responsible": "stv:david.erni",
            "title": "Unteraufgabe",
            "text": "Noch schneller erledigen!"
        }
    ],
    "related_documents": [
        {
            "@id": "http://localhost:8080/fd/ordnungssystem/fuehrung/dossier-23/document-23515"
        }
    ],

    "start_immediately": true
}