Successor-Task abschliessen

Der @complete-successor-task Endpoint auf Aufgaben erlaubt es, eine mandantenübergreifende Nachfolgeaufgabe abzuschliessen.

Durch das Abschliessen der Nachfolgeaufgabe wird das Backend auch die Vorgänger-Aufgabe auf dem Remote-Mandanten abschliessen, und ggf. die angegebenen Dokumente an die Vorgängeraufgabe zurück übermitteln.

Dokumente, welche zurück übermittelt werden sollen, können über den Parameter documents angegeben werden. Dieser Parameter erlaubt die Referenzierung von Dokumenten (im selben Dossier wie die Nachfolgeaufgabe) über IntId (1423795951), OGUID (rk:1423795951), Pfad (/ordnungssystem/dossier-17/document-23) oder URL (https://example.com/ordnungssystem/dossier-17/document-23).

Optional kann im Parameter text ein Kommentar zum Abschliessen der Aufgabe angegeben werden.

Im untenstehenden Beispiel ist fd der Remote-Mandant, und der Benutzer, hugo.boss, will auf seinem lokalen Mandanten, rk, die Aufgabe task-42 abschliessen.

Beispiel-Request:

POST /rk/task-42/@complete-successor-task HTTP/1.1
Content-Type: application/json
Accept: application/json

{
  "transition": "task-transition-in-progress-resolved",
  "documents": [1423795951],
  "text": "Ich schliesse diese Aufgabe ab."
}

Die Response enthält das serialisierte Objekt (die soeben abgeschlossene Nachfolgeaufgabe), so wie sie für einen regulären GET request aussehen würde:

Beispiel-Response:

HTTP/1.1 200 OK
Content-Type: application/json

{
  "@id": "http://.../dossier-17/task-42",
  "@type": "opengever.task.task",
  "oguid": "plone:2118709190",
  "...": "...",
  "predecessor": "plone:2118709189",
  "responses": [
    {"...": "..."},
    {
      "@id": "http://.../dossier-17/task-42/@responses/1598221249104420",
      "...": "...",
      "added_objects": [
        {
          "@id": "http://.../dossier-17/task-42/document-77",
          "@type": "opengever.document.document",
          "checked_out": "",
          "description": "",
          "file_extension": ".docx",
          "is_leafnode": null,
          "review_state": "document-state-draft",
          "title": "Statement in response to inquiry"
        }
      ],
      "text": "Ich schliesse diese Aufgabe ab.",
      "transition": "task-transition-in-progress-resolved"
    }
  ],
  "responsible": {
    "title": "Ratskanzlei: Boss Hugo (hugo.boss)",
    "token": "rk:hugo.boss"
  },
  "responsible_client": {
    "title": "Ratskanzlei",
    "token": "rk"
  },
  "review_state": "task-state-resolved"
}