cBlat (obsoleta)
Veja também:
Classe obsoleta: a classe cBlat é considerada uma classe obsoleta e é mantida no produto apenas para atender os usuários que a utilizam. Não serão feitas atualizações e melhorias nesta classe, em virtude da própria DLL do componente Blat não ter sido atualizada há anos e apresentar limitações para uso com servidores de e-mail comuns como Hotmail e Gmail. Recomendamos que os desenvovedores utilizem a função NFeEnviaEmail da NFeLibrary.
Pacote
A classe cBlat está definida no pacote cBlat.pkg.
Hierarquia
A classe cBlat é uma subclasse da classe cObject do DataFlex e herda todas as propriedades, eventos e métodos existentes nesta classe.
Para que serve
A classe cBlat cria uma interface para acesso aos recursos da biblioteca Blat.dll (www.blat.net), que permite o envio de mensagens de e-mail com diversas opções.
Esta classe possui propriedade/métodos correspondentes para os principais recursos do Blat.
Observações
- A tela ExemploEnviaEmail.vw é um exemplo que mostra a utilização desta classe.
- A biblioteca Blat.dll deve estar no diretório Programs da Workspace para o funcionamento desta classe.
Métodos
EnviaEmail
Tipo
Function
Tipo de Retorno
Integer
Para que serve
Método que faz o envio do e-mail de acordo com as propriedades configuradas. O retorno será Zero se o envio for bem sucedido e um código de erro, caso contrário. Verifique a documentação do Blat para mais detalhes sobre os códigos de erro.
Propriedades
pbHtml
Tipo
Boolean
Valor padrão
False
Para que serve
Indica se a mensagem que será enviada está em formato texto (False) ou HTML (True).
pbOcultaAssuntoEmBranco
Tipo
Boolean
Valor padrão
True
Para que serve
Se esta propriedade for False e não for especificado um assunto para a mensagem, o blat gera um assunto com ’Contents of file: <arquivo>’. Se a propriedade for True (padrão), o assunto ficará em branco se não for especificado.
pbRequestReturnReceipt
Tipo
Boolean
Valor padrão
False
Para que serve
Indica se deve ser solicitada confirmação de leitura para o e-mail.
pbTrataErro
Tipo
Boolean
Valor padrão
True
Para que serve
Ao utilizar um objeto da classe cBlat para enviar um e-mail, será devolvido um código que indica o sucesso do envio ou a falha. Se esta propriedade for True, além de devolver o código para que o desenvolvedor possa fazer o seu próprio tratamento de erro, o objeto cBlat irá exibir uma mensagem de erro.
piPorta
Tipo
Integer
Valor padrão
25
Para que serve
Permite especificar a porta do servidor SMTP que será usada para envio da mensagem. A grande maioria dos servidores utiliza a porta 25 (padrão). Esta propriedade deve ser alterada caso o servidor SMTP a ser utilizado use uma porta diferente.
psAnexos
Tipo
String
Valor padrão
String nula
Para que serve
Caminho do(s) arquivo(s) que devem ser anexados na mensagem. Para especificar mais de um arquivo utilize uma vírgula para separar os arquivos.
psArquivo
Tipo
String
Valor padrão
String nula
Para que serve
Caminho do arquivo que contém o corpo da mensagem. Também pode-se configurar o corpo da mensagem diretamente com a propriedade psCorpo.
psArquivosEmbutidos
Tipo
String
Valor padrão
String nula
Para que serve
Caminho do(s) arquivo(s) de imagem que estão sendo usadas na mensagem HTML e devem ser embutidas no e-mail. A tag de imagem deve usar o prefixo ’cid:’. Exemplo: <img src=”cid:imagem.jpg”>. Para especificar mais de um arquivo deve ser utilizado uma vírgula para separar os arquivos.
psAssunto
Tipo
String
Valor padrão
String nula
Para que serve
Assunto do e-mail que será enviado.
psCorpo
Tipo
String
Valor padrão
String nula
Para que serve
Corpo da mensagem. Também se pode especificar o caminho de um arquivo contendo o texto da mensagem através da propriedade psArquivo.
psEmailBCC
Tipo
String
Valor padrão
String nula
Para que serve
Endereços de e-mail da lista blind carbon copy. Para especificar mais de um e-mail deve ser utilizado a vírgula como separador.
psEmailCC
Tipo
String
Valor padrão
String nula
Para que serve
Endereços de e-mail da lista blind carbon copy. Para especificar mais de um e-mail deve ser utilizado a vírgula como separador.
psEmailDe
Tipo
String
Valor padrão
String nula
Para que serve
Endereço de e-mail que irá aparecer para quem recebeu o e-mail.
psEmailPara
Tipo
String
Valor padrão
String nula
Para que serve
Endereços de e-mail dos destinatários. Para especificar mais de um e-mail basta utilizar a vírgula como separador.
psEmailRemetente
Tipo
String
Valor padrão
String nula
Para que serve
Endereço de e-mail de quem está enviando a mensafem. Este parâmetro costuma ser obrigatório para servidores que exigem autenticação.
psSMTPServer
Tipo
String
Valor padrão
String nula
Para que serve
Servidor SMTP que será usado (opcionamente ’endereco:porta’).
Exemplo:
Set psSMTPServer to “smtp.terra.com.br”
psSenha
Tipo
String
Valor padrão
String nula
Para que serve
Senha de autenticaçãoo (necessário se o servidor requer autenticação).
psUsuario
Tipo
String
Valor padrão
String nula
Para que serve
Nome de usuário para autenticação (necessário se o servidor requer autenticação).