MailAttachment
Os objetos Attachment permitem fazer referência a arquivos em um objeto Email. Os objetos Attachment são criados usando o comando MAIL New attachment.
Objeto anexos
Objetos anexos oferecem as propriedades e funções apenas leitura abaixo:
4D. MailAttachment.new()
História
| Release | Mudanças | 
|---|---|
| 19 R2 | Accepts 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âmetro | Tipo | Descrição | |
|---|---|---|---|
| file | 4D. File | -> | Parâmetros | 
| zipFile | 4D. ZipFile | -> | Arquivo zip | 
| blob | 4D. Blob | -> | Blob contendo o anexo | 
| path | Text | -> | Pode passar uma rota ou um Blob para definir o anexo. | 
| name | Text | -> | Nome + extensão usado pelo cliente email para designar o anexo | 
| cid | Text | -> | ID do anexo (apenas mensagens HTML), ou " " se nenhum cid for exigido | 
| type | Text | -> | Valor do cabeçalho content-type | 
| disposition | Text | -> | Valor do cabeçalho content-disposition: "inline" ou "attachment". | 
| Resultados | 4D. MailAttachment | <- | Objeto anexo | 
Descrição
A função 4D.MailAttachment.new()  cria e retorna um novo objeto do tipo 4D.MailAttachment. Ele é idêntico ao comando MAIL New attachment (atalho).
.cid
.cid* : Text
Descrição
A propriedade .cid contém  o ID do anexo. Essa funcionalidade é usada em mensagens HTML apenas. Se essa propriedade faltar, o arquivo é manejado como um anexo simples (link).
.disposition
.disposition* : Text
Descrição
A propriedade .disposition contém o valor do cabeçalho `Content-Disposition. Dois valores esetão disponíveis:
- "inline": o anexo é renderizado dentro dos conteúdos da mensagem, no local "cid". A renderização depende do cliente mail.
- "attachment": o anexo é fornecido como um link na mensagem.
.getContent()
.getContent()* : 4D.Blob
| Parâmetro | Tipo | Descrição | |
|---|---|---|---|
| Resultados | 4D. Blob | <- | Conteúdo do anexo | 
Descrição
A função .getContent() retorna o conteúdo do objeto anexo em um objeto 4D.Blob. Você pode usar esse método com objetos de anexo recebidos pelo comando MAIL Convert from MIME.
.name
.name* : Text
Descrição
A propriedade .name contém  o nome e a extensão do anexo.  Por padrão, é o nome do arquivo, a menos que outro nome tenha sido especificado no comando MAIL New attachment.
.path
.path* : Text
Descrição
A propriedade .path contém  o caminho POSIX do arquivo de anexo, se ele existir.
.platformPath
História
| Release | Mudanças | 
|---|---|
| 19 | Adicionado | 
.platformPath* : Text
Descrição
A propriedade .platformPath retorna  o caminho do arquivo de anexo expresso com a sintaxe atual da plataforma.
.size
.size* : Integer
Descrição
A propriedade .size contém  o valor do cabeçalho size do arquivo anexo. A propriedade .size é retornada quando a mensagem MIME define um cabeçalho de tamanho na parte do anexo.
.type
.type* : Text
Descrição
A propriedade .type contém o content-type do arquivo anexo. Se esse tipo não for explicitamente passado para o comando MAIL New attachment, o content-type será baseado em sua extensão de arquivo.