Entrées dans l’historique¶
L’Endpoint @journal
traite les entrés dans l’historique.
Attention: Il n’est pas possible de modifier les entrées dans l’historique après leur enregistrement.
Ajouter une entrée dans l’historique:¶
Une nouvelle entrée est générée à l’aide d’une requête POST. Body doit contenir l’attribut comment
.
Paramètres:
Obligatoire:
comment
:String
- Titre de l’entrée.
Optionnels:
category
:String
- Catégorie d’historique. La liste de valeurs supportées peut être récupérée via l’Endpoint @vocabularies/opengever.journal.manual_entry_categories.
related_documents
:String[]
- URLs pointant sur des documents GEVER.
Exemple de Request:
POST /dossier-1/@journal HTTP/1.1 Accept: application/json { "comment": "Dossier archivé avec un outil externe", "category": "phone-call", "related_documents": [ "http://localhost:8080/fd/ordnungssystem/fuehrung/kommunikation/allgemeines/dossier-1/document-1", "http://localhost:8080/fd/ordnungssystem/fuehrung/gemeinderecht/dossier-14/document-33" ] }
Exemple de Response:
HTTP/1.1 204 No content
Consulter des entrées dans l’historique:¶
Une Request GET retourne l’historique d’un contenu.
Exemple de Request:
GET /dossier-1/@journal HTTP/1.1 Accept: application/json
Exemple de Response:
HTTP/1.1 200 OK Content-Type: application/json { "items": [ { "actor_fullname": "zopemaster", "actor_id": "zopemaster", "comments": "Je suis une nouvelle entrée dans l'historique", "time": "2019-04-15T14:00:48+00:00", "title": "Entrée manuelle: Entretien téléphonique" }, { "actor_fullname": "zopemaster", "actor_id": "zopemaster", "comments": "Je suis une nouvelle entrée dans l'historique", "time": "2019-04-15T13:59:21+00:00", "title": "Entrée manuelle: Entretien téléphonique" } ], "items_total": 2 }
Note
Les résultats de recherche sont paginés lorsque le nombre de résultats retournés dépasse la taille de page définie (25 par défaut). Voir Pagination pour plus de détails concernant l’utilisation de résultats paginés.