Envio de e-mail

O recurso de envio de e-mails gerais do HIscada Pro consiste, atualmente, em utilizar a função global chamada GeneralSendMail via scripts do Kernel.

A função de envio de e-mails está disponível a partir da versão 1.7.00 do HIscada Pro e deve ser utilizada apenas em scripts do KERNEL.

result, error = GeneralSendMail(send_mail_parameters)

Descrição:

• Executa o envio de e-mail de acordo com a configuração informada nos parâmetros de entrada da função(send_mail_parameters).

Parâmetros de entrada:

• send_mail_parameters: tabela Lua com a configuração do envio de e-mail. As chaves da tabela de configuração devem ser as seguintes:

Parâmetro	Descrição	Exemplo
server	Endereço do servidor SMTP que será responsável pelo envio de e-mails	smtp.provedoremail.com
port	Número da Porta do servidor SMTP	587
crypt_type	Tipo de criptografia a ser utilizada pelo e-mail	tls ou nulo para conexão não segura
user	Usuário de autenticação no servidor SMTP	usuario@provedoremail.com
password	Senha do usuário de autenticação no servidor SMTP	teste12345
from	Endereço de e-mail do remetente do e-mail	usuario@provedoremail.com
to	String com os endereços de e-mail dos destinatários(para) do e-mail	teste1@provedoremail.com, teste2@provedoremail.com
cc	String com os endereços de e-mail dos destinatários(cópia) do e-mail	teste3@provedoremail.com, teste4@provedoremail.com
bcc	String com os endereços de e-mail dos destinatários(cópia oculta) do e-mail	teste5@provedoremail.com
subject	Assunto do e-mail	E-mail de Teste
message	Mensagem do e-mail	Mensagem do envio de e-mail através do HIscada Pro
files	String com o(s) caminhos(paths) do(s) arquivo(s) a ser(em) anexado(s) no e-mail	C:\\relatorio.pdf ou nulo para não anexar arquivos
timeout	Tempo(em segundos) para aguardar o envio do e-mail	30

Parâmetros de saída:

• result: Booleano indicando true se o envio de e-mail realizado com sucesso, ou false no caso de alguma falha.

• error: Nulo(nil) indicando que não houve erro no envio do e-mail ou o texto referente ao eventual erro que ocorreu neste processo.

Exemplo de utilização

--------------------------------------------------------------------------------
-- Define tabela LUA com os parâmetros de configuração do envio de e-mail
--------------------------------------------------------------------------------
local send_mail_parameters = {
  server="smtp.provedoremail.com",
  port=587,
  crypt_type="tls",
  user="usuario@provedoremail.com",
  password="teste12345",
  from="usuario@provedoremail.com",
  to="teste1@provedoremail.com, teste2@provedoremail.com",
  cc="teste3@provedoremail.com, teste4@provedoremail.com",
  bcc="teste5@provedoremail.com",
  subject="Teste E-mail HIscada Pro",
  message="Mensagem de teste de envio de E-mail através do HIscada Pro",
  files="C:\\Users\\usuario\\Downloads\\relatorio.pdf",
  timeout=30
}

--------------------------------------------------------------------------------
-- Executa o envio do e-mail
--------------------------------------------------------------------------------
local result, error = GeneralSendMail(send_mail_parameters)

--------------------------------------------------------------------------------
-- Caso a variável result seja false, indica que houve um erro no enivo do
-- e-mail. Caso não, indica que o envio foi realizado com sucesso
--------------------------------------------------------------------------------
if (result == false) then
  if (error ~= nil) then
    print("Erro na execução do envio do e-mail: " .. error)
  else
    print("Erro na execução do envio do e-mail")
  end
  return
else
  print("Envio do e-mail realizado com sucesso!")
end