Dokumente ab Vorlage erstellen

In einem Dossier oder einer Aufgabe kann über den Endpoint @document-from-template ein neues Dokument ab Vorlage erstellt werden.

Der Endpoint steht auf Dossiers und Aufgaben zur Verfügung und ist mit der Berechtigung opengever.document: Add document geschützt. Er kann also nur verwendet werden, wenn der Benutzer Dokumente hinzufügen kann.

Der Endpoint erwartet zwei Parameter:

  • template: Das zu verwendende Template aus dem Vokabular opengever.dossier.DocumentTemplatesVocabulary
  • title: Der Titel des zu erstellenden Dokumentes

Beispiel-Request:

POST /ordnungssystem/fuehrung/dossier-23/@document-from-template HTTP/1.1
Accept: application/json

{
 "template": {"token": "1234567890"},
 "title": "Document title"
}

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

Mit Kontakt- und Behördenverzeichnis

Wenn OneGov GEVER mit der Kontakt- und Behördenverzeichnis Applikation verlinkt ist, können zusätzlich noch ein recipient, ein sender und participations mitgegeben werden, dessen Daten als docproperties verwendet werden. Valide recipient und sender können von @globalsources/contacts auf Stufe PloneSiteRoot abgefragt werden.

Beispiel-Request:

POST /ordnungssystem/fuehrung/dossier-23/@document-from-template HTTP/1.1
Accept: application/json

{
  "template": {"token": "1234567890"},
  "title": "Document title"
  "recipient": "hans.peter",
  "sender": "karin.sutter",
  "participations": [
    {"participant_id": "john.doe", "role": "final-drawing" }
  ]
}