Para utilização do serviço, algumas configurações são necessárias:
Inserir o trecho de código abaixo no arquivo "josso-agent-config.xml".
<partner-app> <context>/dts/datasul-mail</context> </partner-app> |
O Datasul Mail Service é um serviço que permite tanto aplicações Progress quanto HTML possam realizar envio de e-mails de forma simples.
Por se tratar de um serviço, a chamada para o envio do e-mail usando esta funcionalidade é realizada através de chamadas REST.
Exemplo da arquitetura do serviço:
Através do contexto datasul-mail/resources existem 3 serviços disponíveis para envio de e-mails com as seguintes assinaturas:
Response: Retorna as propriedades do Mail Service (mail.smtp.sender, mail.smtp.auth, mail.smtp.user, mail.smtp.pass, mail.smtp.host, mail.smtp.port, mail.smtp.ssl.enable, mail.smtp.starttls.enable, mail.smtp.debug.enable).
http://cordas:8480/dts/datasul-mail/resources/help/ |
http://cordas:8480/dts/datasul-mail/resources/send/ |
O objeto Mail, encaminhado no corpo das requisições, possui a seguinte estrutura:
As mensagens de confirmação de entrega e falhas serão retornadas a caixa de e-mail do usuário que estiver sendo utilizado como sender pelo serviço de e-mail. Entretanto, quando informado um endereço de e-mail válido no atributo readNotificationTo, este receberá o e-mail de confirmação de leitura. |
O envio de e-mail ocorre de forma assíncrona, desta forma os erros ou retornos de falhas do envio propriamente dito não são resgatados no momento da execução. Isso se deve ao fato de que o Datasul Mail Service delega ao servidor SMTP o envio da mensagem, sendo que este pode não efetuar o envio no momento em que for solicitado, variando de acordo com a sua fila de despachos e parametrizações. |
Para mais informações de quais são os recursos disponíveis quanto a esta opção de envio, consultar o link: Envio de e-mail.
A API a ser utilizada no progress é a utapi019.p que está preparada para enviar e-mails de acordo com a configuração indicada no programa 'Parâmetros Email Foundation' (btb962zb).
Para mais informações sobre como utilizar a API utapi019 acesse Utilização de API de envio de e-mail.
{utp\utapi019.i2}
RUN utp/utapi019.p PERSISTENT SET h-utapi019.
create tt-envio2.
assign tt-envio2.versao-integracao = 1
tt-envio2.exchange = NO
tt-envio2.servidor = 'smtp.totvs.com.br'
tt-envio2.porta = 587
tt-envio2.destino = "[email protected]"
tt-envio2.remetente = "[email protected]"
tt-envio2.assunto = "Datasul Mail Service"
tt-envio2.mensagem = "Hello from the other side !"
tt-envio2.importancia = 2
tt-envio2.log-enviada = NO
tt-envio2.log-lida = NO
tt-envio2.acomp = NO
tt-envio2.formato = 'html'.
CREATE tt-mensagem.
ASSIGN tt-mensagem.mensagem = tt-envio2.mensagem.
caso não sejam informados os campos da tabela tt-paramEmail2, serão utilizados as configurações dos parâmetros de email foundation */
CREATE tt-paramEmail2.
ASSIGN tt-paramEmail2.caminhoEmail = 5
tt-paramEmail2.mailUser = '<user_email>'
tt-paramEmail2.mailPass = '<senha_email>'
tt-paramEmail2.TLS = NO
tt-paramEmail2.SSL = NO
tt-paramEmail2.DEBUG = YES.
CREATE ttAttachment.
ASSIGN ttAttachment.fileName = '<nome_arquivo>'.
COPY-LOB FROM FILE ttAttachment.FILENAME TO ttAttachment.fileContent NO-CONVERT NO-ERROR. /* caso esteja disponível apenas o binário do arquivo, basta atribui-lo ao campo ttAttachment.fileContent */
RUN pi-execute4 IN h-utapi019 (INPUT Table tt-envio2,
INPUT Table tt-mensagem,
INPUT Table tt-paramEmail2,
INPUT TABLE ttAttachment,
OUTPUT Table tt-erros).
if return-value = "NOK" then do:
for each tt-erros:
disp tt-erros with 1 column width 300.
end.
end. |
Está é a API para utilização nos projetos utilizando THF e está disponível em forma de um serviço nomeado como 'MailService'. Para utilizá-lo, basta injetar o MailService no construtor do seu controller.
Sua principal função é realizar os envios de e-mail a partir de programas HTML, abstraindo a chamada REST (utilizando o Datasul Rest) para a API utapi019, que centraliza qualquer envio de e-mail, tornando a configuração de envio de e-mails única.
O MailService disponibiliza 2 métodos para realizar o envio de e-mail, contendo as seguintes assinaturas:
var controller;
controller = function ($rootScope, $scope, MailService) {
this.sendEmail = funcion() {
MailService.send({
reply: "[email protected]",
mailTo: "[email protected]",
cc: "[email protected]",
subject: "Datasul Mail Service",
content: "Hello from the other side !"
}, function(result) {
console.info(result);
});
};
};
controller.$inject = ['$rootScope', '$scope', 'MailService']; |
var controller;
controller = function ($rootScope, $scope, MailService) {
this.onSelectFiles = function(selectedFiles) {
if (angular.isDefined(selectedFiles)) {
this.sendEmail(selectedFiles);
}
};
this.sendEmail = funcion(files) {
MailService.sendWithAttachment({
reply: "[email protected]",
mailTo: "[email protected]",
cc: "[email protected]",
subject: "Datasul Mail Service",
content: "Hello from the other side !"
}, files,
function(result, mail) {
console.info(result, mail);
}, function(progress, evt, mail) {
console.warn(progress, evt, mail);
}, function(result, status, headers, config, email) {
console.error(result, status, headers, config, email);
});
};
};
controller.$inject = ['$rootScope', '$scope', 'MailService']; |
<html>
<head></head>
<body>
<label class="btn btn-default pull-right"
role="button"
for="file-input">
Selecione os arquivos...
</label>
<span class="file-text"></span>
<input id="file-input"
type="file"
style="position:fixed;top:-999px;"
ngf-select
ngf-change="controller.onSelectFiles($files);"
ngf-multiple="true"
ngf-allow-dir="false"/>
</body>
</html> |