Exibir origem

Objetivo

Fazer estudo para encontrar a melhor forma de mostrar a apropriação detalhada (dados do Protheus) para os usuários do TOP (RM)

Forma de visualização

ANEXO:
Integrações > Spike_Apropriação-Discriminada-TOPxProtheus EAI 2.0 > image2017-8-31 10:49:50.png
RELATÓRIO DE PERIÓDICO - CRONOGRAMA:

RELATÓRIO DE PERIÓDICO - HISTOGRAMA:

RELATÓRIO DE PERIÓDICO - HISTOGRAMA - SEM INSUMO
Integrações > Spike_Apropriação-Discriminada-TOPxProtheus EAI 2.0 > image2017-8-31 11:19:0.png
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

Integrações > Spike_Apropriação-Discriminada-TOPxProtheus EAI 2.0 > image2017-8-31 13:32:43.png

Dados da apropriação detalhada

Nivel de detalhamento serão apresentados os dados ( Produto ); Não tera no nivel de Centro de Custo.

Os dados detalhados serão armazenados na base de dados do TOP; Numa nova Tabela.

Necessário estudar quais possibilidades para criar a apropriação detalhada (definir as storys). Não é necessário definir como será feito.

ANALISE:

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

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.

SERVIÇO REST PROTHEUS (APROPTOP):

Integrações > Spike_Apropriação-Discriminada-TOPxProtheus EAI 2.0 > image2017-8-29 18:12:50.png

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

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.

PONTO DE ATENÇÃO:

EXEMPLO 1:

RECNO	NOTA	PRODUTO	QUANTIDADE	TAREFA	CENTRO DE CUSTO
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

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 consoligada, 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.

PROPOSTA DE TAREFAS:

Remoção de script de nova coluna de apropriação consolidada.
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 Periodico de Histograma
RM - Ajuste de Relatório de Periodico de Cronograma

PROTHEUS

Desenvolvimento de Serviço Rest. 01. Web Services REST/Server