MAIL New attachment

4D v19.8

Mail

MAIL New attachment


MAIL New attachment ( valor {; nome {; cid {; tipo {; disposição}}}} ) -> Resultado

Parâmetro	Tipo	Descrição
valor	Texto, BLOB	Rota no arquivo anexado (texto), ou Blob contendo o anexo (BLOB)
nome	Texto	Nome + extensão usado pelo cliente de email para designar o anexo
cid	Texto	ID do anexo (apenas mensagens HTML) ou "" se não precisar de cid
tipo	Texto	Valor do cabeçalho tipo conteúdo
disposição	Texto	Valor do cabeçalho disposição-conteúdo: "inline" ou "attachment"
Resultado	Objeto	Objeto anexado

Descrição

O comando MAIL New attachment permite que crie um objeto anexado que pode adicioanr a um objeto mail (ver transporter.send( )).

Em valor, passe os conteúdos do anexo. Pode passar:

um texto valor contendo a rota do arquivo anexo, expresso com a sintaxe de sistema. Pode pasar um nome de rota completo ou um nome simples de arquivo (neste caso 4D vai procurar pelo arquivo no mesmo diretório como um arquivo de estrutura de banco de dados).
ou um BLOB valor contendo o próprio anexo.

O parâmetro opcional nome permite passar o nome e extensão a ser usado pelo cliente mail para atribuir o anexo. Se nome for omitido e:

valor for uma rota arquivo, o nome e extensão do arquivo for usado,
valor é um BLOB, um nome aleatório sem extensão é gerado automaticamente.

O parâmetro opcional cid permite passar uma ID interna para o anexo. Este ID é o valor do cabeçalho Content-Id header, será usado apenas nas mensagens HTML. O cid associa o anexo com uma referência definida no corpo da mensagem usando uma tag HTML como <img src="cid:ID">. Isso significa que os conteúdos do anexo (por exemplo uma imagem) pode ser exibida dentro da mensagem no cliente mail. O resultado final pode variar dependendo do cliente mail. Pode passar uma string vazia em cid se não quiser usar este parâmetro.

Pode usar o parâmetro opcional tipo para explicitamente estabelecer o tipo-conteúdo do arquivo anexo. Por exemplo, pode pasar uma string definindo um tipo MIME ("video/mpeg"). Este valor conteúdo-tipo é estabelecido para o anexo, independente da extensão. Para saber mais sobre tipos MIME, veja a página da wikipedia sobre tipos MIME.
Como padrão, se este parâmetro for omitido ou contendo uma string vazia, o conteúdo-tipo do arquivo anexo é baseado em sua extensão. As regras abaixo são aplicadas para os tipos principais MIME:

Extensão	Tipo conteúdo
jpg, jpeg	image/jpeg
png	image/png
gif	image/gif
pdf	application/pdf
doc	application/msword
xls	application/vnd.ms-excel
ppt	application/vnd.ms-powerpoint
zip	application/zip
gz	application/gzip
json	application/json
js	application/javascript
ps	application/postscript
xml	application/xml
htm, html	text/html
mp3	audio/mpeg
other	application/octet-stream

O parâmetro opcional disposição permite que passe o cabeçalho conteúdo-disposição do anexo. Pode passar uma das constantes abaixo do tema constantes "Mail":

Constante	Valor	Comentário
mail disposition attachment	attachment	Define o valor do cabeçalho Content-disposition para "attachment", o que significa que o arquivo adjunto deve ser proporcionado como um link na mensagem.
mail disposition inline	inline	Define o valor do cabeçalho Content-disposition para "inline", o que significa que o arquivo adjunto deve ser representado dentro do conteúdo da mensagem, na localização "cid". A renderização depende do cliente de correio.

Como padrão, se o parâmetro disposição for omitido:

Se o parâmetro cid for usado, o cabeçalho conteúdo-disposição é estabelecido para "inline",
Se o parâmetro cid não for passado ou estiver vazio, o cabeçalho Conteúdo-dispoição é estabelecido para "attachment".