Mudanças entre as edições de "Criação de Relatório de Verbas"

Edição atual tal como às 15h46min de 4 de agosto de 2021

Histórico de Alterações

Data	Quem	Comentários
31/05/2021	João Ramon	Criação do documento

Necessidade

O cliente está em processo de migração de seus serviços da plataforma GeoSales 3 para o EVO. Na plataforma antiga, há uma funcionalidade de geração de relatórios de verba, que exporta um relatório de verba conforme determinado período, informado pelo usuário. Faz-se necessário, portanto, a possibilidade de geração deste relatório na plataforma GeoSales EVO, de acordo com o modelo anterior.

Solução

A demanda do cliente estará solucionada quando for possível a geração deste relatório, segundo as condições existentes na plataforma antiga. Tais condições são: permitir a escolha de um período para a criação da lista, e a possibilidade de exportar este relatório gerado naquele período, em formato .pdf ou .xls, nas especificações já implantadas desde o GeoSales 3.

Em resumo, a solução consiste na implementação do relatório que pode ser exportado no GeoSales 3 na plataforma EVO, nas mesmas especificações já existentes no primeiro.

Implementação

Em primeiro lugar, é necessário criar um CRUD para esta funcionalidade. O modelo de protótipo pode ser visualizado na parte de Protótipos. O Acesso a esta tela de relatório será acessada por meio de uma opção criada no módulo de Gestor da plataforma GeoSales EVO, ao criar a aba 'Relatório de Verba'.

Ao selecionar esta funcionalidade, o usuário será direcionado a uma tela chamada Relatório de Verbas. Nesta tela, haverão campos para preenchimento de informações para filtros à semelhança do processo utilizado no GeoSales 3, ao selecionar Relatório de Verba na aba de Relatório.

Os seguintes campos de filtro são:

Período (dois campos informando a data inicio e a data fim do intervalo da consulta);
Supervisor (campo para preenchimento do supervisor);
Vendedor (campo para preenchimento do vendedor);
Situação do Pedido (campo com seleções pré-configuradas, com as opções:

- Não exportado;
- Exportado;
- Totalmente fracionado;
- Parcialmente fracionado;
- Liberado;
- Faturado;
- Excluído;
- Integrado;
- Cancelado.

Ao acionar a flag todos para criação do relatório. O sistema desativa(desconsidera o filtro situação pedido) e considera todas as situações pedido. Comportamento já existente no relatório no geosales3.

Ícone de menu com as opções de exportação de relatório no formato .pdf ou .xls.

Protótipos e Ilustrações

Modelo de relatório exportado do GeoSales 3, em formato .pdf:

Modelo de relatório exportado do GeoSales 3, em formato .xls:

Cenários

Exportação de relatório completo

O usuário acessa a plataforma GeoSales EVO e entra na aba de relatório de Verba dentro do Módulo de Gestores.
Na tela de relatório, o usuário preenche os campos de período a ser filtrado;
O usuário seleciona o flag de lista completa;
Ao selecionar o ícone de menu, o usuário exporta o relatório no formato desejado (.pdf ou .xls).
O relatório exportado trará todas as informações existentes no banco de dados.

Exportação de relatório com filtros

O usuário acessa a plataforma GeoSales EVO e entra na aba de relatório de Verba dentro do Módulo de Gestores.
Na tela de relatório, o usuário preenche os campos de período a ser filtrado;
O usuário preenche os campos de gestor, vendedor e/ou situação do pedido, dependendo da sua necessidade;
Ao selecionar o ícone de menu, o usuário exporta o relatório no formato desejado (.pdf ou .xls).
O relatório exportado trará apenas as informações baseadas nos filtros determinados pelo usuário.

A sequência operacional de fluxo de processos pode ser ilustrada pelo diagrama abaixo:

Regras de Negócio

[RN1] - O relatório exportado terá a mesma estrutura já utilizada atualmente no Geosales 3. O processo visa única e exclusivamente migrar a funcionalidade supracitada para o EVO.

[RN2] - O flag de relatório com todos os itens ficará desativado, como default. A exportação de relatório com todos os itens só será realizada com o flag ativado.

[RN3] - Quando o flag de relatório com todos os itens estiver ativado, os campos de filtro serão desativados. Não serão considerados quaisquer filtros. Caso o usuário insira algum filtro além do período (supervisor, vendedor e situação pedido), o flag de relatório com todos os itens deverá ser desabilitado.

Aprovação

Considero aprovada a documentação da funcionalidade especificada acima, e autorizo a implementação da mesma no Sistema GeoSales, em nome da Organização a qual estou vinculado.

GeoSales

Setor	Aprovado Por	Data
Desenvolvimento - GeoSales	Renato Lima	03/06/2021
Integração - GeoSales	Pessoa que aprovou	00/00/0000
Configurações - GeoSales	Pessoa que aprovou	00/00/0000

Empresa solicitante

Setor	Aprovado Por	Data
Gerente TI - Cliente	Pessoa que aprovou	00/00/0000
Gerente de Projeto - Cliente	Pessoa que aprovou	00/00/0000
Gerente Comercial - Cliente	Pessoa que aprovou	00/00/0000

@@ Linha 9: / Linha 9: @@
 ! Comentários
 |-
-| 13/05/2021 || João Ramon || Criação do documento
+| 31/05/2021 || João Ramon || Criação do documento
 |-
 |}
@@ Linha 16: / Linha 16: @@
 == Necessidade ==
-O cliente está em processo de migração de seus serviços da plataforma GeoSales 3 para o EVO. Naquela, havia duas funções essenciais para a gestão de pedidos deste cliente, que são: Lista de Pedidos Auto (relação de pedidos realizados via NeoGrid) e Relatório de Log de Dados Neogrid, que exporta um relatório conforme determinado período, informado pelo usuário. A primeira funcionalidade já existe no EVO, mas a segunda ainda não foi implementada. Faz-se necessário, portanto, a criação de um mecanismo de pesquisa que permita que o usuário possa verificar quais pedidos foram realizados por este meio (Neogrid) e exportar informações de log destes pedidos através de um relatório.
+O cliente está em processo de migração de seus serviços da plataforma GeoSales 3 para o EVO. Na plataforma antiga, há uma funcionalidade de geração de relatórios de verba, que exporta um relatório de verba conforme determinado período, informado pelo usuário. Faz-se necessário, portanto, a possibilidade de geração deste relatório na plataforma GeoSales EVO, de acordo com o modelo anterior.
 == Solução ==
@@ Linha 26: / Linha 26: @@
 == Implementação ==
-Visto que a Listagem de Pedidos Auto já pode ser consultada na GeoSales EVO, no módulo Vendas, por meio da Aba 'Pedidos Auto', é necessário criar neste ambiente dois filtros para a inclusão das datas de início e fim do intervalo que o cliente deseja apresentar no relatório. Ao preencher os dados de filtro e apertar o botão 'pesquisar', serão apresentados em lista todos os pedidos daquele período. No entanto, a lista apresentada atualmente na tela não possui os mesmos dados do relatório de log que é usualmente exportado. Para isso, é necessário que sejam adicionadas à esta pesquisa mais 3 (três) colunas, referentes ao nome do arquivo, data do log e a descrição do log (conforme ilustrado em seguida). Quando o usuário escolher fazer a exportação do relatório, ele terá opções de fazê-lo em formato .pdf ou .xls. No entanto, o arquivo exportado será o mesmo já parametrizado no sistema, seguindo o mesmo padrão já utilizado no GeoSales 3.
+Em primeiro lugar, é necessário criar um CRUD para esta funcionalidade. O modelo de protótipo pode ser visualizado na parte de Protótipos. O Acesso a esta tela de relatório será acessada por meio de uma opção criada no módulo de Gestor da plataforma GeoSales EVO, ao criar a aba 'Relatório de Verba'.
-Portanto, a implementação da demanda deste documento será realizada pelo seguimento das seguintes soluções:
+Ao selecionar esta funcionalidade, o usuário será direcionado a uma tela chamada Relatório de Verbas. Nesta tela, haverão campos para preenchimento de informações para filtros à semelhança do processo utilizado no GeoSales 3, ao selecionar Relatório de Verba na aba de Relatório.
-# Criação de dois filtros de busca no formato de data, referentes a data início e data fim, originados na tabela PEDIDO_AUTO, na coluna DATA_EMISSAO para parametrizar o período a ser populado pela lista de pedidos;
+Os seguintes campos de filtro são:
-# Adição das colunas 'Nome do Arquivo', 'Data Log' e 'Log' e  na lista de pedidos auto.
-# Neste ponto, a coluna 'Log' não deverá ser visualizada. Caso o usuário deseje saber a descrição do log apontado, ele irá selecionar um ícone que será gerado na coluna de descrição log que, ao ser selecionado, abrirá uma janela pop-up com a descrição referente.
+* Período (dois campos informando a data inicio e a data fim do intervalo da consulta);
-# Atualmente, ao selecionar o pedido na lista, clicando nas áreas existentes, ele faz a abertura deste pedido, para que sejam visualizadas as informações e explicações deste pedido. Esta funcionalidade não precisa existir nestas novas colunas que serão criadas.
+* Supervisor (campo para preenchimento do supervisor);
-# Quando a lista estiver visualmente disponível na tela de Listagem de Pedidos Auto, o usuário poderá fazer a exportação de um relatório (.pdf ou .xls) por meio de um ícone na parte inferior direita da tela.
+* Vendedor (campo para preenchimento do vendedor);
-# Este relatório preservará os mesmos parâmetros já utilizados para a sua exportação, cujos exemplos foram adicionados neste documento na parte de protótipos e ilustrações.
+* Situação do Pedido (campo com seleções pré-configuradas, com as opções:
+- Não exportado;<br>
+- Exportado;<br>
+- Totalmente fracionado;<br>
+- Parcialmente fracionado;<br>
+- Liberado;<br>
+- Faturado;<br>
+- Excluído;<br>
+- Integrado;<br>
+- Cancelado.<br>
+* Ao acionar a flag todos para criação do relatório. O sistema desativa(desconsidera o filtro situação pedido) e considera todas as situações pedido. Comportamento já existente no relatório no geosales3.
+* Ícone de menu com as opções de exportação de relatório no formato .pdf ou .xls.
 == Protótipos e Ilustrações ==
-[[arquivo: prototipo2.png| 800px]]
+[[arquivo: relatorioverbas.png| 800px]]
 * '''Modelo de relatório exportado do GeoSales 3, em formato .pdf:'''
-[[arquivo: relatoriop.png | 1000 px]]
+[[arquivo: relatorioverbaspdf.png | 1000 px]]
 * '''Modelo de relatório exportado do GeoSales 3, em formato .xls:'''
-[[arquivo: relatoriox.png | 1000 px]]
+[[arquivo: relatorioverbasxls.png | 1000 px]]
 == Cenários ==
-=== Cenário Atual ===
+=== Exportação de relatório completo ===
-O usuário, ao entrar na seção de Pedidos Auto, no módulo de Vendas, monta uma lista de pedidos por meio do botão pesquisar. No entanto, a lista apresentada mostra os pedidos na seguinte formatação:
+# O usuário acessa a plataforma GeoSales EVO e entra na aba de relatório de Verba dentro do Módulo de Gestores.
+# Na tela de relatório, o usuário preenche os campos de período a ser filtrado;
+# O usuário seleciona o flag de lista completa;
+# Ao selecionar o ícone de menu, o usuário exporta o relatório no formato desejado (.pdf ou .xls).
+# O relatório exportado trará todas as informações existentes no banco de dados.
-{| class = "wikitable"
+=== Exportação de relatório com filtros ===
-! Código Pedido Cliente
-! Cliente
-! Emissão
-! Tipo Pedido
-! Válido
-|}
-A estrutura atual está disponível apenas para visualização na plataforma, e não há ferramenta disponível para a exportação de relatório.
+# O usuário acessa a plataforma GeoSales EVO e entra na aba de relatório de Verba dentro do Módulo de Gestores.
+# Na tela de relatório, o usuário preenche os campos de período a ser filtrado;
+# O usuário preenche os campos de gestor, vendedor e/ou situação do pedido, dependendo da sua necessidade;
+# Ao selecionar o ícone de menu, o usuário exporta o relatório no formato desejado (.pdf ou .xls).
+# O relatório exportado trará apenas as informações baseadas nos filtros determinados pelo usuário.
-=== Cenário Desejado ===
-Como o procedimento trata de uma exportação de relatórios, o usuário, ao entrar na seção de Pedidos Auto, no módulo de Vendas, monta uma lista de pedidos por meio do botão pesquisar. A lista pode ser apresentada de acordo com determinado período, por meio dos filtros de data início e data fim. Ao selecionar o icone de pesquisa, a lista apresentada mostrará a seguinte formatação:
-{| class = "wikitable"
-! Código Pedido Cliente
-! Cliente
-! Emissão
-! Tipo Pedido
-! Válido
-! Data Log
-! Nome do Arquivo
-! Log
-|}
-Por meio do icone de exportar arquivo, será possível que o usuário consiga criar um arquivo .pdf ou .xls. Contudo, as informações que conterão o arquivo exportado serão os seguintes:
-{| class = "wikitable"
-! Código Pedido
-! Data Log
-! Nome do Arquivo
-! Log
-|}
 A sequência operacional de fluxo de processos pode ser ilustrada pelo diagrama abaixo:
-[[arquivo: neogrid2.png]]
+[[arquivo: bpmncrudverba.png]]
 == Regras de Negócio ==
-'''[RN1] - ''' O relatório exportado será o mesmo já gerado atualmente no Geosales 3. Não inserir outras colunas.
+'''[RN1] - ''' O relatório exportado terá a mesma estrutura já utilizada atualmente no Geosales 3. O processo visa única e exclusivamente migrar a funcionalidade supracitada para o EVO.
+'''[RN2] - ''' O flag de relatório com todos os itens ficará desativado, como default. A exportação de relatório com todos os itens só será realizada com o flag ativado.
-'''[RN2] - ''' Ao abrir a tela de Listagem de pedidos Auto, o campo na seleção de válido deverá trazer "Sim" como opção default.
+'''[RN3] - ''' Quando o flag de relatório com todos os itens estiver ativado, os campos de filtro serão desativados. Não serão considerados quaisquer filtros. Caso o usuário insira algum filtro além do período (supervisor, vendedor e situação pedido), o flag de relatório com todos os itens deverá ser desabilitado.
 == Aprovação ==
@@ Linha 112: / Linha 110: @@
 |-
-| Desenvolvimento - GeoSales || Pessoa que aprovou || 00/00/0000
+| Desenvolvimento - GeoSales || Renato Lima || 03/06/2021
 |-
 | Integração - GeoSales || Pessoa que aprovou || 00/00/0000