new Mail()
Classe responsável pelo envio de e-mails por meio do sistema.
É possível definir uma configuração de padrão de servidor SMTP no Manage. A configuração padrão de servidor SMTP do Manage só vale para o Engine configurado e não para toda base.
A configuração padrão de servidor SMTP do Manage é feita em Configuration/General, preenchendo os campos: Administrator Full Name, Administrator Mail Address, Configuration Port, SMTP Server, SMTP Username, SMTP Secure Connection, SMTP Password e Confirm SMTP Password.
Examples
var mail = new Mail() mail.smtpServer = "smtp.gmail.com:465" mail.fullSsl = true mail.userName = "usuario@company.com.br" mail.password = "senha" mail.addRecipient( "Destino", "destino@company.com" ) mail.subject = "Teste2" mail.content = "Teste" mail.sendLocally()
// Exemplo do uso da classe Mail usando a configuração do Manage: //Note que no exemplo abaixo não há informação de configuração do servidor de SMTP. //Toda configuração é obtida automaticamente dos valores dos campos informados no //Manage var mail = new Mail() mail.addRecipient( "Nome destinatário", "usuario@company.com.br" ) mail.subject = "Teste" mail.content = "Teste" mail.sendLocally()
Members
-
autoTls :boolean
-
Se o valor for true, será realizado automaticamente o upgrade para um canal seguro SSL/TLS desde que o servidor SMTP suporte.
Type:
- boolean
-
content :string
-
Conteúdo do e-mail
Type:
- string
-
fullSsl :boolean
-
Se o valor for true, estabelece um canal seguro SSL/TLS assim que estabele a conexão.
Type:
- boolean
-
htmlContent :string
-
Conteúdo do e-mail no formato HTML
Type:
- string
-
log :string
-
Variável que armazena o log da 'conversa' do objeto Mail com o servidor de SMTP. O armazenamento do log só ocorre quando a propriedade enableLog for true.
Type:
- string
-
logEnabled :boolean
-
Habilita logs adicionais relacionados ao envio do e-mail que são gravados no log do sistema e na propriedade
log
.Importante: os logs são gerados no Engine que envia o e-mail. Quando utilizado o método
Database.prototype.sendMail
, os logs são gravados no Engine servidor associado à conexão e a propriedadelog
não é atualizada.Type:
- boolean
-
password :string
-
Senha do remetente no servidor de SMTP.
Type:
- string
-
senderMailAddress :string
-
Endereço de e-mail do remetente
Type:
- string
-
senderName :string
-
Nome do remetente
Type:
- string
-
smtpServer :string
-
Endereço ou IP do servidor de SMTP e porta no formato "HostName:Port".
Type:
- string
-
subject :string
-
Assunto do e-mail.
Type:
- string
-
userName :string
-
Nome de usuário do remetente no servidor de SMTP.
Type:
- string
Methods
-
<static> hasDefaultSMTPSettings()
-
Verifica se o Engine corrente possui uma conta de SMTP configurada no Manage.
Returns:
True se o Engine tiver uma conta SMTP padrão.
- Type
- boolean
-
addAttachment(name, content)
-
Adiciona um arquivo anexo ao e-mail.
Parameters:
Name Type Description name
string Nome do arquivo anexo(Não precisa ser o nome original).
content
string | ArrayBuffer Conteúdo do arquivo anexo.
-
addRecipient(nameOrEmail [, email])
-
Adiciona um destinatário com apenas o email, ou nome e email.
Parameters:
Name Type Argument Description nameOrEmail
string Nome ou email do destinatário.
email
string <optional>
Endereço de email do destinatário, necessário somente se o mesmo não foi informado como o primeiro parâmetro.
Example
mail.addRecipient('example@example.com.br'); //ou mail.addRecipient('maria','maria@example.com.br');
-
addRecipientBcc(nameOrEmail [, email])
-
Adiciona um destinatário que receberá uma cópia oculta da mensagem (CCO).
Parameters:
Name Type Argument Description nameOrEmail
string Nome ou Email do destinatário.
email
string <optional>
Endereço de email do destinatário, necessário somente se o mesmo não foi informado como o primeiro parâmetro.
Example
mail.addRecipientBcc('example@example.com.br'); //ou mail.addRecipientBcc('maria','maria@example.com.br');
-
addRelatedContent(name, content)
-
Adiciona um arquivo no e-mail. Este recurso deve ser usado para adicionar imagens ao e-mail. Ao adicionar uma imagem o desenvolvedor deve atentar para o uso o prefixo cid:. Vide o exemplo: <img src="cid:dfs9898jskFs">
cid é uma abreviação para content-id. O content id é retornado por este método.Parameters:
Name Type Description name
string Nome do conteúdo. O nome poderá ser referenciado dentro do próprio e-mail.
content
string | ArrayBuffer Conteúdo do arquivo adicionado, codificado em Base64.
Returns:
Identificador do conteúdo(content-id) gerado para o conteúdo adicionado.
- Type
- string
-
clear()
-
Limpa os dados do e-mail.
-
sendLocally()
-
Envia o e-mail.
-
toString()
-
Representação do Objeto mail em formato String
Returns:
Retorna sempre '[object Mail]'
- Type
- string
-
write()
-
Escreve dados no conteúdo do e-mail e adiciona uma quebra de linha no final.