Objetivo
Este manual orienta a configuração de alertas de e-mail com filtros personalizados no ContractPlus Add-on para SAP Business One Desktop. A funcionalidade permite utilizar scripts SQL (comandos SELECT) para definir dinamicamente a lista de contratos que devem disparar notificações por e-mail.
Pré-requisitos
Acesso ao menu do ContractPlus Add-on no SAP Business One Desktop (ContractPlus -> Configurações -> Gestor de E-mail).
Permissão de acesso e edição na rotina Gestor de E-mail.
Conhecimento técnico em linguagem SQL (comandos SELECT) e na estrutura de tabelas de contratos do ContractPlus (ex.: IV_C1_Contract).
Procedimento
1. Acessar o Gestor de E-mails e Iniciar Novo Modelo
Acesse a interface de configuração de modelos de e-mail do Add-on no SAP Business One.
Ação do Usuário: No menu principal do SAP Business One Desktop, navegue até ContractPlus -> Configurações -> Gestor de E-mail e clique no botão 'Novo' (ou selecione um modelo existente para edição).
Resultado Esperado: A janela 'Gestor de E-mail' será aberta com os campos do formulário liberados para edição.
2. Selecionar a Data Base 'Personalizada'
Defina o tipo de disparo de e-mail configurando a opção Data Base para o modo personalizado.
Ação do Usuário: No campo dropdown 'Data Base', selecione a opção 'Personalizada'.
Resultado Esperado: O campo 'Dias para Alerta' ficará desabilitado (cinza e bloqueado para edição) e a área para cadastro e teste do script SQL será habilitada na interface.
3. Cadastrar a Instrução SQL (Comando SELECT)
Informe o script SQL responsável por retornar a lista de contratos alvos da notificação.
Ação do Usuário: Na caixa de texto do script SQL, digite a instrução SELECT desejada, assegurando que a consulta retorne obrigatoriamente a coluna identificadora do contrato (exemplo: SELECT T0."Id" AS "ContractId" FROM "IV_C1_Contract" T0 WHERE...).
Resultado Esperado: O texto da instrução é preenchido no campo de script. O sistema bloqueará qualquer tentativa de inserir comandos que não sejam SELECT.
4. Executar o Teste Obrigatório do Script SQL
Valide a sintaxe e a execução da consulta no banco de dados antes de efetuar a gravação.
Ação do Usuário: Clique no botão 'Testar Script'.
Resultado Esperado: O Add-on executará a validação da consulta no banco de dados (SQL Server ou SAP HANA). Se o script for válido, a mensagem 'Script executado com sucesso!' será exibida. Caso haja erro sintático ou tabela/coluna inexistente, uma modal informará os detalhes do erro SQL.
5. Salvar a Configuração do Modelo de E-mail
Após preencher os demais campo finalize o cadastro do modelo personalizado para que ele fique disponível para o serviço automático de e-mail.
Ação do Usuário: Após realizar o teste do script com sucesso, preencha os demais campos obrigatórios (como Assunto e Mensagem) e clique no botão 'Adicionar' (ou 'Atualizar').
Resultado Esperado: O Add-on salva a regra no banco de dados. Se o usuário tentar salvar sem ter executado o teste com sucesso ou com script em branco/inválido, a gravação será bloqueada exibindo a mensagem de alerta correspondente.
6. Acompanhar a Execução do Envio em "Administração dos Serviços"
O envio dos e-mails é processado por um serviço em segundo plano, que pode ser acompanhado e controlado pela tela de administração de serviços do ContractPlus.
Ação do Usuário: Inicie o monitor de serviços como administrador e selecione a aba "Envio de e-mails". Caso o serviço não esteja em execução, clique em "Iniciar"; se necessário reprocessar, utilize "Reiniciar" (o botão "Parar" interrompe o serviço).
Resultado Esperado: O status no canto superior direito exibe "(Em Execução)" em verde, junto do consumo de memória do processo. O painel de log, abaixo dos campos "Linhas do Log" e "Tempo para Exec. em Minutos", exibe em tempo real o processamento de cada regra do Gestor de E-mail — incluindo a linha referente ao script personalizado (por exemplo, "Nenhum template de e-mail referente a script personalizado encontrado" quando não há nenhuma regra "Personalizada" ativa para envio naquele ciclo, ou a confirmação de início/fim do processamento quando houver contratos retornados pelo script). O status "Em Execução" também aparece no rodapé da janela.
7. Conferir o E-mail Recebido pelo Destinatário
Após o processamento do script e o envio pelo serviço, o destinatário recebe o alerta automático por e-mail.
Ação do Usuário: Oriente o destinatário a verificar a caixa de entrada do e-mail cadastrado como contato do contrato.
Resultado Esperado: Chega um e-mail identificado com o selo "ALERTA AUTOMÁTICO" e a categoria "Personalizada", contendo um resumo do contrato (número do contrato, parceiro, filial, data e status) e, na seção "Detalhes", o texto configurado no campo "Mensagem" com os dados do contrato retornado pelo script (ex.: filial, número alternativo, parceiro de negócios e período do contrato). O rodapé do e-mail identifica a origem como "E-mail automático do Gestor de E-mail do ContractPlus".
Regras de Negócio & Observações
Restrição de Segurança SQL: Somente comandos SELECT são permitidos no script personalizado. Comandos de alteração ou exclusão de dados (como DELETE, UPDATE, INSERT, DROP ou TRUNCATE) são interceptados e bloqueados imediatamente durante o teste e o salvamento.
Obrigariedade de Teste Prévio: Qualquer alteração no texto do script invalida o teste anterior, tornando obrigatório clicar novamente em 'Testar Script' antes de salvar o formulário.
