Modal Para Envio de Relatórios Por E-mail

Introdução

Habilita um modal que permite o envio de relatórios por email na tela de CRUD. Quando configurado, um botão é exibido tanto na listagem dos registros quanto na tela de edição. Ao interagir com o botão o modal é aberto, onde é possível selecionar e-mails destinatários em uma lista, adicionar novos e-mails como destinatários, e, o relatório a ser enviado.

Configuração

Um novo parâmetro deve ser adicionado ao banco de dados na tabela nfs_core_par_parametros. O parâmetro deve ser um JSON de nome ‘SEND_REPORT_EMAIL’ com as seguintes chaves de configuração:

{
   "crud_table": "OS",
   "filter": {
       "column": "PROC_ST",
       "value": 1
   },
   "email_list": {
      "table": "CLIENTE",
      "columns": [
         "E_MAIL",
         "E_MAIL2",
         "E_MAIL3",
         "E_MAIL4",
         "E_MAIL5"
      ],
      "hasFilterByCrud": true
   },
   "reports": [
      {
         "display_name": "Assistência Técnica",
         "action":"assistencia_tecnica"
      }
   ],
   "export_format": "txt"
}

Onde:

• crud_table: Define em qual tela de CRUD deve ser exibido os botões de envio por e-mail, tanto na lista de registros quanto na tela edição. No exemplo acima, o botão será exibido na tela de cadastro de OS, assim como, na tela de edição de uma OS.

• filter: Este é um PARÂMETRO OPCIONAL, e como o nome sugere, filtra para quais registros o botão de envio de relatório poderá ser exibido. Duas chaves devem ser informadas, a "column" e a "value", cujos valores são respectivamente a COLUNA da tabela crud informada e o VALOR usado como condição para filtragem. No exemplo acima, os botões somente serão exibidos para os registros do cadastro de OS cujo valor de PROC_ST = 1.

• email_list: Define a origem dos e-mails para receberem o relatório, devendo informar o nome da tabela (table) e quais colunas (columns) contem os e-mails. A flag hasFilterByCrud indica se os dados da tabela de emails deve ser filtrada pelo registro da tabela crud, por exemplo, no JSON acima os emails obtidos da tabela CLIENTE devem ser filtrados com base no valor de CLIENTE_SEQ_DB presente em OS, que é a crud table informada.

• reports: Lista de relatórios associados a OS e que deseja enviar para os emails configurados/adicinados. As chaves "display_name" e "action" identificam, respectivamente, o nome que será exibido no modal e o 'name' deste relatório na tabela nfs_reports. Essa opção do parâmetro aceita mais de um objeto, podendo configurar assim mais um relatório.

• export_format: Define o formato do arquivo ao enviar o E-mail. Este parâmetro é opcional e, deve ser usado com cautela, pois, o formato original do relatório deve ser respeitado e pode gerar erros ao tentar ser convertido. Os valores aceitos são os mesmos definidos para a propriedade "export_options" da tabela "nfs_reports" onde o relatório é configurado, tais valores são: 'txt', 'pdf', 'pdfNative' e 'excel'. Caso o valor de "export_format" não seja definido neste JSON de configuração, será utilizado justamente o valor configurado na primeira chave do JSON em "export_options".

Restrição

Esta opção de envio de relatório por e-mail só é visível para usuários com permissão de edição em telas de CRUD.