Exibir código-fonte para Criação de Visão de Relatório de Log de Pedidos Auto




== Histórico de Alterações ==

{| class = "wikitable"
! Data
! Quem 
! Comentários
|-
| 13/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. 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.

== 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 ==

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.

Portanto, a implementação da demanda deste documento será realizada pelo seguimento das seguintes soluções:

# 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;
# 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.
# 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.
# 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.
# 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.

== Protótipos e Ilustrações ==

[[arquivo: prototipo2.png| 800px]]


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

[[arquivo: relatoriop.png | 1000 px]]

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

[[arquivo: relatoriox.png | 1000 px]]

== Cenários ==

=== Cenário Atual ===

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:

{| class = "wikitable"
! 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.

=== 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]]

== Regras de Negócio ==

'''[RN1] - ''' O relatório exportado será o mesmo já gerado atualmente no Geosales 3. Não inserir outras colunas.

'''[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.

== 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 ===

{| class="wikitable"
! Setor 
! Aprovado Por
! Data

|- 
| Desenvolvimento - GeoSales || Pessoa que aprovou || 00/00/0000
|- 
| Integração - GeoSales || Pessoa que aprovou || 00/00/0000
|-
| Configurações - GeoSales || Pessoa que aprovou || 00/00/0000
|-
|}

=== Empresa solicitante === 

{| class="wikitable"
! Setor 
! Aprovado Por
! Data
! Assinatura
|-
| 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 ||
|- 
|}