MailAttachment
Los objetos Attachment permiten referenciar archivos en un objeto Email. Los objetos Attachment son creados utilizando el comando MAIL New attachment.
Objetos adjuntos
Los objetos Attachment ofrecen las siguientes propiedades y funciones de sólo lectura:
| .cid : Text el ID del archivo adjunto |
| .disposition : Text el valor del encabezado Content-Disposition |
| .getContent() : 4D.Blob devuelve el contenido del objeto adjunto en un objeto 4D.Blob |
| .name : Text el nombre y la extensión del adjunto |
| .path : Text la ruta POSIX del archivo adjunto, si existe |
| .platformPath : Text la ruta del archivo adjunto expresada con la sintaxis de la plataforma actual |
| .size : Integer el valor del encabezado size del archivo adjunto |
| .type : Text el content-type del archivo adjunto |
4D.MailAttachment.new()
Historia
| Lanzamiento | Modificaciones |
|---|---|
| 19 R2 | Acepta 4D.File, 4D.ZipFile, 4D.Blob |
4D.MailAttachment.new( file : 4D.File { ; name : Text {; cid : Text{ ; type : Text { ; disposition :Text } } } } ) : 4D.MailAttachment
4D.MailAttachment.new( zipFile : 4D.ZipFile { ; name : Text {; cid : Text{ ; type : Text { ; disposition :Text } } } } ) : 4D.MailAttachment
4D.MailAttachment.new( blob : 4D.Blob { ; name : Text {; cid : Text{ ; type : Text { ; disposition :Text } } } } ) : 4D.MailAttachment
4D.MailAttachment.new( path : Text { ; name : Text {; cid : Text{ ; type : Text { ; disposition :Text } } } } ) : 4D.MailAttachment
| Parámetros | Tipo | Descripción | |
|---|---|---|---|
| file | 4D.File | -> | Archivo adjunto |
| zIPFile | 4D.ZipFile | -> | Archivo zip adjunto |
| blob | 4D.Blob | -> | BLOB que contiene el adjunto |
| path | Text | -> | Ruta del archivo adjunto |
| name | Text | -> | Nombre + extensión utilizados por el cliente de correo para designar el archivo adjunto |
| cid | Text | -> | ID del archivo adjunto (sólo en mensajes HTML), o " " si no se requiere cid |
| type | Text | -> | Valor del encabezado content-type |
| disposition | Text | -> | Valor del encabezado content-disposition: "inline" o "attachment". |
| Resultado | 4D.MailAttachment | <- | Objeto adjunto |
Descripción
La función 4D.MailAttachment.new() crea y devuelve un nuevo objeto de tipo 4D.MailAttachment. Es idéntico al comando MAIL New attachment (acceso directo).
.cid
.cid : Text
Descripción
La propiedad .cid contiene el ID del archivo adjunto. Esta propiedad se utiliza sólo en los mensajes HTML. Si falta esta propiedad, el archivo se maneja como un simple adjunto (enlace).
.disposition
.disposition : Text
Descripción
La propiedad .disposition contiene el valor del encabezado Content-Disposition. Hay dos valores disponibles:
- "inline": el archivo adjunto se muestra dentro del contenido del mensaje, en la ubicación "cid". La renderización depende del cliente de correo.
- "attachment": el archivo adjunto se presenta como un enlace en el mensaje.
.getContent()
.getContent() : 4D.Blob
| Parámetros | Tipo | Descripción | |
|---|---|---|---|
| Resultado | 4D.Blob | <- | Contenido del anexo |
Descripción
La función .getContent() devuelve el contenido del objeto adjunto en un objeto 4D.Blob. Puede utilizar este método con objetos adjuntos recibidos por el comando MAIL Convert from MIME.
.name
.name : Text
Descripción
La propiedad .name contiene el nombre y la extensión del adjunto. Por defecto, es el nombre del archivo, a menos que se haya indicado otro nombre en el comando MAIL New attachment.
.path
.path : Text
Descripción
La propiedad .path contiene la ruta POSIX del archivo adjunto, si existe.
.platformPath
Historia
| Lanzamiento | Modificaciones |
|---|---|
| 19 | Añadidos |
.platformPath : Text
Descripción
La propiedad .platformPath contiene la ruta del archivo adjunto expresada con la sintaxis de la plataforma actual.
.size
.size : Integer
Descripción
La propiedad .size contiene el valor del encabezado size del archivo adjunto. La propiedad .size se devuelve cuando el mensaje MIME define un encabezado de tamaño en la parte adjunta.
.type
.type : Text
Descripción
La propiedad .type contiene el content-type del archivo adjunto. Si este tipo no se pasa explícitamente al comando MAIL New attachment, el content-type se basa en su extensión de archivo.