Resource type: defaultAttachments
This API call can be used to read the attachments of a mail template from the template management (Edit >> Templates / files) and the default mail attachments of the querying user (Mailcomposer >> Attachments). Attachments of PDF letter templates can also be read.
As resourceid the ID of a mail template or PDF letter template can be specified. Without specifying a resourceid, only the users default attachments are returned. The users default attachments are always in the response.
The response contains subrecords that reflect the users default mail attachments (userDefaultAttachments), the attachments of the mail template (templateDefaultAttachments) and the attachments of the PDF letter template (pdfLetterDefaultAttachments).
The ids of mail templates and PDF letter templates can be retrieved via Templates.
Parameters: None
Example:
{
"actionid": "urn:onoffice-de-ns:smart:2.5:smartml:action:get",
"resourceid": "<TEMPLATE-ID>",
"identifier": "",
"resourcetype": "defaultAttachments",
"parameters": []
}
Response:
id
ID of the template.filename
File name. File name is null if the file does not exist physically yet. E.g. if the file name is generated using parameters (e.g. address, object) as in exposes.filesize
Physical file size in bytes if the file has a fixed size else zero. Exposes, document attributes and PDF letters have no file size. E.g. the size of the file is not yet fixed before the expose is generated.filetitle
File title.filetype
File type. Possible file types:attachmentType-expose,attachmentType-pdfLetter,attachmentType-pdfForm,attachmentType-file,attachmentType-documentAttribute.identifier
Identifier of the attachment. Only the attachment types expose and document attribute have an identifier. The identifier of an expose is required, for example, for the API call Generation of PDF exposés.
{
"status": {
"code": 200,
"errorcode": 0,
"message": "OK"
},
"response": {
"results": [
{
"actionid": "urn:onoffice-de-ns:smart:2.5:smartml:action:get",
"resourceid": "3635",
"resourcetype": "defaultAttachments",
"cacheable": false,
"identifier": "",
"data": {
"meta": {
"cntabsolute": 3
},
"records": [
{
"id": "userDefaultAttachments",
"type": "attachmentCollection",
"elements": [
{
"id": "119",
"filename": null,
"filesize": 0,
"filetitle": "Design01Expose (kurz)",
"filetype": "attachmentType-expose",
"identifier": "urn:onoffice-de-ns:smart:2.5:pdf:expose:kurz:design01Expose"
}
]
},
{
"id": "templateDefaultAttachments",
"type": "attachmentCollection",
"elements": [
{
"id": "122",
"filename": null,
"filesize": 0,
"filetitle": "Design01Aushang",
"filetype": "attachmentType-expose",
"identifier": "urn:onoffice-de-ns:smart:2.5:pdf:expose:kurz:design01Aushang"
},
{
"id": "18697",
"filename": "Rechnungen_06.2020-06.2020.csv",
"filesize": 3443,
"filetitle": "Rechnungen_06.2020-06.2020.csv",
"filetype": "attachmentType-file",
"identifier": null
}
]
}
]
},
"status": {
"errorcode": 0,
"message": "OK"
}
}
]
}
}