Syntax: HEAD /rest/v1/record/<recordKey>/attachment/<attachmentKey>
Dieser Aufruf dient dem Abruf der Metadaten eines konkreten Dateianhangs.
Parameter
| Name | Pflicht | Beschreibung |
|---|---|---|
| recordKey | Ja | Oid oder MigrationId eines existierenden Datensatzes (Vererbung: OrmBABase). |
| attachmentKey | Ja | Oid oder Content-ID eines zum Datensatz gehörenden Dateianhangs. |
Mögliche Rückgabestatus
| Status | Beschreibung |
|---|---|
| 204 No content | Die gewünschten Daten wurden in den Antwort-Headern zurückgegeben. |
| 304 Not modified | Die angegebene Anfragebedingung wird nicht erfüllt. |
| 400 Bad request | Der Parameter attachmentKey wurde nicht angegeben. |
| 403 Forbidden | Der aktuelle Benutzer hat nicht die Berechtigung den angegebenen Datensatz zu lesen. |
| 404 Not found |
|
| 500 Internal server error | Bei der Verarbeitung kam es zu einem unvorhergesehenen Fehler. |
Rückgabe
Da der Inhalt der Antwort auf HEAD-Anfragen per Konvention immer leer ist, werden die gewünschten Informationen in den Antwort-Headern übertragen.
Die Informationen über den Dateinamen und den Inline-Status des Dateianhangs werden im Header Content-Disposition zurückgegeben.
Beispiele:
Content-Disposition: inline;filename="bild.jpg"
Content-Disposition: attachment;filename="Konzept.docx"
Die Größe des Dateianhangs (in Bytes) findet sich im Header Content-Length.
Die ContentId des Dateianhangs liegt im Header Content-ID, sofern sie bei dem Anhang vergeben ist.
Das Datum der letzen Änderung des Dateianhangs findet sich im Header Last-Modified.
Es existieren zusätzliche nicht-standard-Header, die weitere Informationen aus Business App beinhalten:
| Header | Beschreibung |
|---|---|
| X-Field-Name | Der Name des Feldes, in welchem der Dateianhang liegt. |
| X-Subject | Die Beschreibung des Dateianhangs. |
| X-Created | Das Erstelldatum des Dateianhangs. |
| X-Created-By | Die Person, welche den Dateianhang erstellt hat und die Oid des zugehörigen Profils. Beispiel: Andreas Huber;oid=6a1ab622-2c16-4d80-a868-bfae0ccfaee7 |
| X-Modified-By | Die Person, welche den Dateianhang zuletzt verändert hat und die Oid des zugehörigen Profils (s. o.). |