Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

  • utapi019.p
  • utapi019.i
  • utapi019.i1
  • utapi019.i2

Considerações gerais

...

Área de tabela de conteúdos
typeflat
  • A utilização dessa API não é recomendada em ambientes WEB, pois a mesma pode solicitar informações ao usuário e, no caso de executar o Blat, o usuário do IIS deverá ter permissão para efetuar a tarefa de envio e rodar o aplicativo Blat.



  • A utilização dessa API não é recomendada em ambientes WEB, pois a mesma pode solicitar informações ao usuário e, no caso de executar o Blat, o usuário do IIS deverá ter permissão para efetuar a tarefa de envio e rodar o aplicativo Blat.
  • A include utapi019.i contém as definições das temp-table's tt-envio2, tt-mensagem e tt-erro que devem ser passadas como parâmetros à API.
  • A include utapi019.i1 contém a definição da temp-table tt-paramEmail e chamada para a include utapi019.i, resultando na definição de todas as temp-table's necessárias para chamadas à APIa definição da temp-table tt-paramEmail e chamada para a include utapi019.i, resultando na definição de todas as temp-table's necessárias para chamadas à API.
  • A include utapi019.i2 contém a definição da temp-table tt-paramEmail2 e chamada paras as includes ut-mail-api.i (definição da TempTable de anexo), i_prdvers (Include de versão do produto) e utapi019.i1, supracitada.
  • Por padrão, será utilizado Outlook ou Blat no ambiente Windows ou comando sendmail no ambiente UNIX para envio de e-mail.
  • Quando for utilizado envio de e-mail numa sessão background do Progress(batch-mode) e o ambiente for Windows, a API utilizará sempre o Blat.
  • No envio da mensagem em ambiente UNIX, o sendmail e o uuencode devem estar configurados corretamente. Para testar o funcionamento do comando, digite no prompt, usando o mesmo usuário e na mesma pasta em que a API será executada, os respectivos comandos sendmail e uuencode. A execução destes programas não deve apresentar erros. Caso ocorram erros deve-se entrar em contato com a equipe de suporte do sistema operacional do servidor.
  • A API possui eventos de UPC que permitem ao usuário alterar o comando de execução do envio. Esses pontos foram desenvolvidos para atender às necessidades de usuários que precisam adicionar informações específicas de ser serviço de e-mail que não são contempladas pelos produtos Datasul.
  • A API tem algumas restrições ao ser comparado a um serviço de e-mail: não efetua validações dos tipos de arquivos anexados à mensagem nem outros tipos de tratamento que um serviço de e-mail realiza. Caso ocorra alguma dessas validações que a API não trata, será considerado pela API que todos os e-mails foram enviados corretamente.os e-mails foram enviados corretamente.
  • Protocolo TLS: Verificar se o servidor utiliza este tipo de protocolo, caso prefira uma conexão segura com criptografia. Assim será possível marcar e ativar a opção TLS no produto. Lembrando que está opção de envio é válida somente para DatasulMailService


Âncora
parametros
parametros
Parâmetros de e-mail

...

AtributoTipoValor InicialDescrição
fileNameCharacter
Nome do arquivo
fileTypeCharacter
Tipo de arquivo em formato MIME type. Se não for informado, o valor será definido de acordo com a extensão do arquivo.
fileContentBlob
Conteúdo do arquivo em formato binário

...

em formato binário

tt-paramEmail

Indica somente o tipo de envio de e-mail e sua evolução segue na definição da TempTable tt-paramEmail2, abaixo.

tt-paramEmail2


Informações

A include utapi019.i2 contempla a Definição da TempTable tt-paramEmail2 como forma de evolução da api utapi019, de modo a seguir o Guia TOTVS de Implementação de APIs

Indica tipo de envio de e-mail, usuário e senha para autenticação no servidor de e-mail caso venha a ser necessário, opção de ativar comportamento de resposta do para utilização de remetente padrão.

***
AtributoTipoValor InicialDescrição
caminhoEmailinteger1

Esse campo pode receber os seguintes valores:
0-Unix
1-Blat
2-Exchange
3-Java
4-MailSend (SSL)

5-

DatasulMailServer

DatasulMailService

Informações

Caso for atribuído um valor diferente desses, o valor padrão será BLAT

mailUsercharacter
Código do usuário para autenticação (se necessário)
mailPasscharacter
Senha do usuário para autenticação (se necessário)
TLSlogicalnoProtocolo - Apenas pra DatasulMailService
SSLlogicalnoProtocolo - Apenas para o MailSend
DebuglogicalnoAtiva o debug para o servidor de aplicação
remetentelogicalnoRemetente do envio de e-mail
ativaRemetPadrao (*)logicalnoEstando como "yes" ativa o comportamento de "responder para", onde o remetente será sempre o from alias e o remetente padrão será quem receberá a resposta do e-mail;(*)
codRemetPadrao (*)character
Código (e-mail) do remetente que ira receber a resposta, caso o campo logico ativaRemetPadrao estiver como yes.(*)

(aviso)  Os parâmetros acima (tt-paramEmailparamEmail2) não são obrigatórios, caso não sejam informados, serão utilizadas as informações da tela de parâmetros de e-mail do foundation (btb962zb).

Informações
titleImportante:

* Estes dois campos só funcionam com o tipo de envio de e-mail DatasulMailService, os mesmo foram incluídos na release 12.1.23.

tt-erro

Possui os erros encontrados pela API.

...