Histórico da Página
Objetivo:
Tem por objetivo estudar as formas de visualização dos dados, forma de implementação, e possíveis impactos em tais implementações relacionadas a exibição da Fazer estudo para encontrar a melhor forma de mostrar a apropriação detalhada (dados do Protheus) para os usuários do TOP (RM).
Duvidas que devem ser respondidas:
- Forma de visualização
Relatório (utilizando provider):
- Relatório fixo (exportação para excel);
- Cubo (utilizando provider);
- Anexo do sistema;
- Dados da apropriação detalhada
- Definir em qual nivel de detalhamento serão apresentados os dados ( Produto, Nota , Agrupa por dia );
- Se os dados detalhados serão armazenados na base de dados do TOP; *
- Como vamos disponibilizar o detalhamento para o relatórios que a Queiroz ja tem em sua base de dados
- Como vamos disponibilizar customização. JOIN com outras tabelas.
- Como será a performance dessa extração de dados, pois podemos tem muitas notas fiscais e produtos para um projeto
- Insumo
Necessário estudar quais possibilidades para criar a apropriação detalhada (definir as storys). Não é necessário definir como será feito.
1 - ANÁLISE DE FORMAS DE VISUALIZAÇÃO
2 - ANÁLISE DE CAMPOS
3 - FORMA DE IMPLEMENTAÇÃO
4 - CONCLUSÕES
5 - PROPOSTA DE TAREFAS
1 - ANÁLISE DE FORMAS DE VISUALIZAÇÃO:
Foram analisados os anexos, relatórios e cubos que serão utilizados para visualização da apropriação detalhada.
ANEXO - PLANILHA DE ATIVIDADES
RELATÓRIO DE PERIÓDICO - CRONOGRAMA:
RELATÓRIO DE PERIÓDICO - HISTOGRAMA:
RELATÓRIO DE PERIÓDICO - HISTOGRAMA - SEM INSUMO
HISTOGRAMA DE INSUMOS POR TAREFA - SEM INSUMO - NÃO RETORNA NENHUM VALOR DE APROPRIAÇÃO
PERIODICO DE HISTOGRAMA - NÃO RETORNA APROPRIAÇÕES FINANCEIRAS
PERIODICO DE CRONOGRAMA - RETORNA LANÇAMENTOS FINANCEIROS
CUBO - QUANTITATIVO / VISÃO ECONOMICA / VISÃO FINANCEIRA
2 - ANÁLISE DE CAMPOSANALISE:
Foram analisadas a consulta SQL Anexa, os Cubos e os relatórios e foram identificados os campos abaixo como importantes para retorno da apropriação discriminada.
CAMPOS NECESSÁRIOS:
NECESSIDADE | ORIGEM | TIPO | |
FILIAL | ANEXO | PROTHEUS | DEFAULT |
TIPOMOVIMENTACAO | ANEXO | PROTHEUS | DEFAULT |
NUMERONF | ANEXO | PROTHEUS | DEFAULT |
FORNECEDOR | ANEXO | PROTHEUS | |
CODIGO CENTRO DE CUSTO | ANEXO / CUBO QUANTITATIVOS | PROTHEUS | Expandivel? |
CODIGO DO PRODUTO | ANEXO / CUBO QUANTITATIVOS / RELATÓRIOS | PROTHEUS | |
CODIGO INSUMO | RECUPERADO PELO PRODUTO ASSOCIADO AO INSUMO | RM | |
DESCRIÇÃO INSUMO | SE NÃO EXISTE 'INSUMO NÃO PREVISTO' | RM | |
DESCRICAO DO PRODUTO | ANEXO / CUBO QUANTITATIVOS / RELATÓRIOS | RM | |
DATA EMISSAO | ANEXO / RELATÓRIOS | PROTHEUS | |
CÓDIGO UNIDADE | ANEXO / CUBO QUANTITATIVOS / RELATÓRIOS | PROTHEUS | |
QUANTIDADE | ANEXO / CUBO QUANTITATIVOS / RELATÓRIOS | PROTHEUS | |
PREÇO UNITÁRIO | ANEXO / CUBO QUANTITATIVOS / RELATÓRIOS | PROTHEUS | |
VALOR TOTAL | ANEXO | PROTHEUS | |
CÓDIGO DO PROJETO | ANEXO / CUBO QUANTITATIVOS / RELATÓRIOS | PROTHEUS | |
CÓDIGO DA TAREFA | ANEXO / CUBO QUANTITATIVOS / RELATÓRIOS | PROTHEUS | |
ID PERIODO | RELATÓRIOS | RM | |
MOEDA | RELATÓRIOS | PROTHEUS | |
DATA INICIO PERÍODO | RELATÓRIOS | RM | |
DATA FIM PERÍODO | RELATÓRIOS | RM |
Visão Financeira e Economica não foi considerado nesta primeira analise.
CUSTOMIZADOS QUEIROZ:
CATEGORIA - DE PRODUTOS | fixo para movimentações baixa protheus - materiais | |
CODUA | join com a tabela de tarefas |
3 - FORMA DE IMPLEMENTAÇÃO:
Foi identificado as seguintes questões sobre a implementação dos serviços.
PROTHEUS:
- Protheus permite a utilização de funções de Mensagem Única dentro de serviços REST.
- Protheus não possui serviços de framework para a facilitação de paginação e ordenação a consultas REST.
- Risco na utilização de CUBO com serviço paginado no qual os dados podem ser alterados durante a execução da importação, ou seja é importante manter uma ordenação que evite problemas relacionado a consulta de dados incluidos após a primeira consulta e que evite a não recuperação de dados já iniciados a recuperação. (EXEMPLO 1)
- Foi verificado que existem documentações suficientes para a elaboração do serviço REST, sendo necessario somente a definição de utilização de serviços GET ou POST, caso seja necessario o envio de formulario de dados.
- Alterar funções da apropriação consolidada PROTHEUS para ter parâmetros para retorno das informações discriminadas. Com opção para ratear por Centro de Custo ou não.
- Alterar funções da apropriação consolidada PROTHEUS para ter parâmetros para retorno das informações paginadas.
- Implementação de Função de Retorno de Dados, pois temos um método para ler os dados e depois para montar o JSon.
- Precisamos enviar como POST para enviar as datas dos respectivos documentos.
RM
- Não temos uma forma padrão de customizar um cubo que utilize provider.
- Teriamos que ter uma logica de consulta sql por parâmetro.
- Não temos uma forma padrão de customizar um relatório que utilize provider.
- Não temos recursos de framework para chamada REST com JSON.
- Não temos recurso de DataServer e Visão para paginação de dados retornados por provider.
- Não temos uma forma padrão de customizar um cubo que utilize provider.
SERVIÇO REST PROTHEUS (APROPTOP):
PARÂMETROS:
page | Integer | |
pageSize | Integer | |
order | String | |
sourceApplication | String | BUSCAR O SOURCE APPLICATION PELO APLICATIVO INTERNO
|
companyInternalId | String | |
projectInternalId | String | |
FreightValueExcluded | Boolean | |
InsuranceValueExcluded | Boolean | |
ExpenseValueExcluded | Boolean | |
UsePaidValue | Boolean | |
GetApportionCostCenter | Boolean | Define se deve retornar rateio de centro de custo, pois isto gera o retorno de mais itens, sendo desnecessario em algumas situações. |
initialTaskInternalId | String | |
finishTaskInternalId | String | |
initialDate | String | EXEMPLO: FILTRO DE PERIODOS DE CRONOGRAMA CONSULTADOS NO RELATÓRIO PERIODICO. |
finishDate | String | |
DocumentApportionFilter | Vetor |
RETORNO:
COLIGADA / FILIAL | COMPANYINTERNALID | ||
CÓDIGO DA TAREFA | TASKINTERNALID | ||
TIPOMOVIMENTACAO | APPORTIONMENTTYPE | ||
NUMERO | NUMBER | IDENTIFICADOR DO CABEÇALHO (NUMERONF, NUMERO TITULO) | |
PK DO REGISTRO PROTHEUS | |||
IDENTIFICADOR DO ITEM | ITEMNUMBER | ||
DATA DA APROPRIAÇÃO | APPORTIONMENTDATE | ||
CODIGO DO PRODUTO | ITEMINTERNALID | NÃO EXISTE PARA TITULO FINANCEIRO | |
CÓDIGO UNIDADE | UNITOFMEASUREINTERNALID | ||
QUANTIDADE | QUANTITY | ||
PREÇO UNITÁRIO | UNITPRICE | ||
VALOR TOTAL | TOTALPRICE | ||
CODIGO CENTRO DE CUSTO* | COSTCENTERINTERNALID | Verificar a real necessidade deste campo | |
CLIENTE/FORNECEDOR | CUSTOMERVENDORINTERNALID | NÃO EXISTE PARA BAIXA DE ESTOQUE | |
MOEDA | CURRENCYINTERNALID |
FORMA DE VISUALIZAÇÃO RM:
...
Relatório Histograma / Cronograma
Cubos Ponto Forte
Quantitativos:
- Relatório fixo (exportação para excel);
Relatório Fixo já utiliza o provider PrjTrfProvider, inclusive esta incorreto pois o mesmo possui uma consulta sql de cronograma apropriado própria, o que não considera as novas implementações e a apropriação de medição.
Cronograma
2. Relatório de Histograma
Relatório utiliza o mesmo server do cronograma apropriado, de forma que seria necessário ajustar a busca de dados discriminados para o novo recurso.
3.Anexo do Sistema
Temos um anexo
4. Cubo
5. Como vamos disponibilizar o detalhamento para o relatórios que a Queiroz ja tem em sua base de dados
6. Performance
7. Insumo em relatórios
Como são exibidos atualmente as notas sem insumo?
8. Tarefas
EXEMPLO 1:
RECNO | NOTA | PRODUTO | QUANTIDADE | TAREFA | CENTRO DE CUSTO | D_E_L_E_T |
---|---|---|---|---|---|---|
1 | 0001 | AREIA | 10 | 001.001 | 001 | |
2 | 0001 | AREIA | 10 | 001.001 | 002 | |
3 | 0001 | AREIA | 5 | 001.001 | 001 | |
4 | 0002 | AREIA | 20 | 001.001 | 001 |
REQUISITA PAGINA 1 - COM UM PAGESIZE DE 2
RECNO | NOTA | PRODUTO | QUANTIDADE | TAREFA | CENTRO DE CUSTO | D_E_L_E_T |
---|---|---|---|---|---|---|
1 | 0001 | AREIA | 10 | 001.001 | 001 | |
2 | 0001 | AREIA | 10 | 001.001 | 002 |
REQUISITA PAGINA 2 - COM UM PAGESIZE DE 2 (NESTE MOMENTO FOI INCLUIDO MAIS UM REGISTRO NO PROTHEUS, NESTE CASO RETORNA QUE TEM MAIS PAGINAS, E EXCLUIDA A NOTA 0001)
RECNO | NOTA | PRODUTO | QUANTIDADE | TAREFA | CENTRO DE CUSTO | D_E_L_E_T |
---|---|---|---|---|---|---|
3 | 0001 | AREIA | 5 | 001.001 | 001 | * |
4 | 0002 | AREIA | 20 | 001.001 | 002 | |
5 | 0003 | AREIA | 10 | 001.001 | 002 |
CONCLUSÕES
...
Como será a performance dessa extração de dados, pois podemos tem muitas notas fiscais e produtos para um projeto.
Foi verificado que no ambiente do cliente Queiroz galvão temos somente cerca de 12.000 registros de movimentações de apropriação.
4 - CONCLUSÕES
1 - Será reaproveitado os métodos do EAI para recuperação de De-Para no serviço rest PROTHEUS.
2 - Observar formula do TOP que pode ser utilizada em consulta SQL, tera que ser alterada.
3 - Será necessario retornar script da apropriação consolidada, pois vamos desativar tal recurso.
4 - Os parâmetros e processos não serão modificados.
5 - Uma nova tabela para apropriação sera criada.
6 - Cubos não foram disponibilizados a mais clientes alem da Ponto Forte, mas a equipe de evangelização relatou que estava pendente nos enviar uma solicitação para inclusão no Produto. Cubos foram feitos em implantação Ponto Forte.
7 - Não sera considerado rateio de centro de custo na exibição de dados da apropriação discriminada.
8 - Sera criada nova tabela para armazenamento da apropriação.
5 - PROPOSTA DE TAREFAS:
- Remoção de script de nova coluna de apropriação consolidada. E remoções necessárias para termos somente a apropriação Discriminada.
- Implementação de Data Server - Nova Tabela de Apropriação Discriminada. Com Anexo da Planilha de Atividades.
- Protheus - Desenvolvimento de Serviço REST- Com elaboração de Automação para teste do Serviço Rest. - SEM PAGINAÇÃO.
- Protheus - Desenvolvimento do Recurso de Paginação no Serviço REST / Protheus - Ajuste da Automação para adequar a paginação.
- RM - Implementação de Data Server de exibição da Apropriação com inclusão como anexo.
- RM - Ajuste de Relatório de Periódico de Histograma
- RM - Ajuste de Relatório de Periódico de Cronograma
- Ajuste do Provider de Formula existente.
- Apresentar ao lider de materiais Protheus e a equipe do Petrus?
PROTHEUS
Desenvolvimento de Serviço Rest. 01. Web Services REST/Server