1126 Envio Email Business Intelligence
Modulo_Business_Intelligence_Delivery
Neste recurso você poderá configurar diversos envios de BI, para diversos endereços de email, automatizando a chegada de informações aos usuários, clientes, fornecedores e quaisquer outras pessoas.
Para um exemplo prático, consulte o case Case_Cobranca_Automatica_Email após ter lido este documento primeiro.
Fluxo Principal
- Marque Ativo para ativar o envio. Caso desmarcado o Envio não será realizado. Use por exemplo para desativar temporariamente.
- Informe a data de início de envio, do primeiro envio. Caso informe uma data no passado, ao salvar, em instantes a mesma já será executada. Tenha em mente que a checagem de novos envios é intermitente, e ocorre de acordo com o tempo configurado na tarefa de Envio Email BI em 1673_Tarefas_Servidor.
- Informe o intervalo em horas, ou seja de quanto em quanto tempo o BI será gerado e enviado. As horas são informadas em número. 01:30 deverá ser informado como 1,50 horas.
- "Enviar sempre na mesma hora" significa que o email somente será enviado conforme a hora informada no campo Data de Inicio, sendo enviado na mesma hora ou instantes depois, mas nunca antes da mesma.
- Informe o servidor de Email, que aparecerá como remetente. (1673_Tarefas_Servidor)
- Informe o modelo de Email, o texto que será exibido no corpo da mensagem.(132_Modelo_Email)
- Informe a descrição do título do Email. Caso não seja informado, será enviado o título do email configurado no Modelo de Email.
- Informe o tipo de geração(ver seção abaixo)
- Nome Coluna Email(ver seção abaixo)
- Informe os BI's que serão gerados e anexados ao email. Não é obrigatório a informação dos mesmos, principalmente caso utilize no campo tipo de geração "Gerar conforme BI de Filtros". Caso informe, também será necessário informar: nome do arquivo/anexo do email(opcional e lembre-se de colocar a extensão conforme o formato escolhido), Formato do arquivo(Excel, PDF, etc) e os parâmetros de geração. Clique em informar para testar os parâmetros, ao clicar em fechar o Touch Comp ERP irá identificar os mesmos.
- Informe na aba emails, quais os emails irão receber este envio. O email deve ser cadastrado antes, para cada pessoa no recurso 47 - Pessoas.
Tipo Geração BI
O envio possibilita duas opções basicamente:
- "Gerar sobre BI de Filtros"
- "Apenas gerar os BI's informados"
Na segunda situação, mas simples, o sistema irá gerar os BI's informados e simplesmente disparar para os emails informados.
Na primeira, se abre um universo de possibilidades onde você poderá dinamizar o envio. Ao mesmo tempo que se cria diversas possibilidades, por outro lado pode dificultar um pouco as parametrizações.
Como exemplo prático:
- Suponha que deseja enviar para os clientes, as compras diárias que fizeram. Assim sendo, será necessário criar um BI que como resultado retorna os emails dos clientes que compraram no dia. Ainda, ao configurar este BI, suponha que tenha chamado esta coluna de "EMAIL_CLIENTES" (Gere o BI no Excel e verifique o nome da coluna), você deverá informar este nome no campo "Coluna Email". Neste BI você também poderá trazer outras informações como Identificador do cliente, Nome do cliente, etc.
Estes dados retornados(ID, Nome por exemplo) são passados dinamicamente para cada BI informado na tabela de BI's que serão anexados. Nestes BI's, em seus parâmetros, você poderá informar no campo "Valor Sugerido (Reflection)" o nome desta coluna, e a mesma, neste formato, será usado como filtro deste segundo relatório, de cada BI informado na tabela de BI's. Ou seja, para cada cliente, gere um relatório de vendas, somente dele.
Neste tipo de geração, o ERP irá enviar um email separadamente com os seus devidos anexos, para cada retorno(Linha) gerada pelo BI de Filtros.
Você ainda poderá utilizar estes campos, retornados pelo BI de filtro, no seu Modelo de Email, dinamizando inclusive o Modelo de Email. Lembre-se que no modelo de email, será necessário utilizar a opção de Observação Dinâmica. O modelo simples não suporta este dinamismo.
Log de Envios
Toda vez que um Envio for realizado, o sistema irá salvar os dados do momento do envio, como data e hora e os destinatários que receberam os mesmos, de forma a possibilitar a depuração ou análise dos envios.
Você pode apagar estes logs, informando uma data inicial baixa, selecionando-os na tabela e depois ao clicar em Remover.
Problemas e Soluções:
E-mail não enviado
Este problema pode ser originado em diversos pontos. Verifique e confira todas as questões a seguir em sequencia, eliminando cada etapa.
API/Wildfly/Docker
Verifique se a API está instalada, em execução. Consulte a Wiki para mais detalhes, Manual_Instalacao_ERP, para instalar/verificar a instalação e em caso de problemas, principalmente a seção Problemas e soluções.
Configuração das Tarefas
O Envio de E-mail funciona baseado na configuração e ativação de tarefas. Consulte a Wiki e confira principalmente se a Task está ativa - Envio Emails - Business Intelligence está ativa: 1673_Tarefas_Servidor.
Dica: diminua o tempo entre envios e confi
Business Intelligence
Verifique o BI configurado se está gerando dados/valores. Teste os parâmetros configurados, gerando o BI e verificando se está trazendo dados. Senão estiver trazendo dados, revise os parâmetros informados e o próprio BI.
Tenha bastante atenção quanto utilizar como fato gerador outro BI, que irá gerar selecionar as pessoas/emails a serem disparados. Teste-o no recurso 747 - Business Intelligence para confirmar se está trazendo dados.
Confira o Log de envios
Confira o log de envios para averiguar os envios, quando ocorreram tentativas de envio. Caso existam logs, significa que o serviço está operando e que os problemas estão relacionados ao BI/configurações.
- Erro 550- Requested action not taken: mailbox unavailable or not local
Normalmente, esse erro indica que uma configuração de segurança na sua organização ou na organização do destinatário está impedindo a mensagem de chegar até ele.
Por exemplo: Você não tem permissão para enviar ao destinatário.