Histórico da Página
Este documento é material de especificação dos requisitos de inovação, trata-se de conteúdo extremamente técnico. |
---|
(Obrigatório)
Informações Gerais
Especificação | |||
Produto | Datasul | Módulo | Vendas, Compras e Armazenagem de Grãos |
Segmento Executor | Originação de Grãos | ||
Projeto1 | Integração Romaneio Produção com PIMS - Linha Datasul | IRM1 | PCREQ-8569 |
Requisito1 | PCREQ-8712 | Subtarefa1 | PDR_AGR_ORI004-47 |
Chamado2 |
| ||
Release de Entrega Planejada | 12.1.11 | Réplica | Não se aplica. |
País | ( X ) Brasil ( ) Argentina ( ) Mexico ( ) Chile ( ) Paraguai ( ) Equador ( ) USA ( ) Colombia ( ) Outro _____________. | ||
Outros | <Caso necessário informe outras referências que sejam pertinentes a esta especificação. Exemplo: links de outros documentos ou subtarefas relacionadas>. |
Legenda: 1 – Inovação 2 – Manutenção (Os demais campos devem ser preenchidos para ambos os processos).
(Obrigatório)
Objetivo
O presente requisito tem como objetivo viabilizar a integração das pesagens dos romaneios e a ordem de colheita, assim integrando o Módulo de Originação de Grãos e a solução PIMS. Deste modo, a integração será feita através da tecnologia EAI, de modo síncrono, onde será enviado para a solução PIMS os pesos das ordens de colheita.
(Obrigatório)
Definição da Regra de Negócio
Rotina | Tipo de Operação | Opção de Menu | Regras de Negócio |
GG1005 - Parâmetros Grãos | Alteração | Cadastros |
|
GG2077 - Pendência Integração | Criação | Tarefas |
|
GGAPI126 - API Integração Ordem de Produção | Criação | Não se aplica. |
|
GetHarvestOrderAdapter - Adapter para o XSD GetHarvestOrder_1_000 | Criação | Não se aplica. | |
GetHarvestOrderFactory - Geração do XML para o XSD GetHarvestOrder_1_000 | Criação | Não se aplica. | |
WeighingRawMaterialsAdapter - Adapter para o XSD WeighingRawMaterials_1_000 | Criação | Não se aplica. | |
WeighingRawMaterialsFactory - Geração do XML para o XSD WeighingRawMaterials_1_000 | Criação | Não se aplica. | |
ChannelPIMS - Conexão com o Web Service PIMS | Criação | Não se aplica. | |
GG2000-z06 - Zoom das Listagens de Ordem de Colheita | Criação | Não se aplica. | |
GG2000 - Romaneios | Alteração | Tarefas | |
GGAPI126 - Api Entrada Produção | Alteração | Não se aplica. |
GG1005 - Parâmetros Grãos
O referido programa vai ser alterado para a inclusão dos campos "Integração PIMS Romaneio de Produção" e "Url WS PIMS". Tais campos, estarão disponíveis na após clicar no novo botão "Integrações", onde será aberto uma janela para informar os dados correspondentes. Deste modo, os respectivos campos deverão estar informados para que o serviço de integração com o PIMS esteja ativo.
GG2077 - Pendências Integrações
O programa de pendencia de integração tem como objetivo o reenvio de XMLs que apresentaram problemas ao integrar com o Web Service, tendo as seguintes características:
- Permite o reenvio do XML que apresentou erro
- Permite consultar todas integrações realizadas
- Permite testar a conexão com o Web Service
GGAPI126 - API Integração Ordem de Produção
A referida API tem como objetivo reunir as funções que serão usadas para tratar os dados retornados dos adapters que farão a integração, tendo as seguintes funcionalidades:
- Rotina para tratamento dos dados obtidos através do adapter GetHarvestOrder, obtendo a listagem das ordens de colheita.
- Rotina para validar a ordem de colheita, realizando a verificação através do adapter GetHarvestOrder.
- Rotina para enviar para o PIMS a pesagem da ordem de colheita informada, deste modo usando o adapter WeighingRawMaterials.
- Rotina para cancelar o envio efeutado para o PIMS, utilizando o adapter WeighingRawMaterials na opção delete.
- Rotina para cadastrar as integrações realizadas na tabela "gg-penden-integra".
GetHarvestOrderAdapter - Adapter para o XSD GetHarvestOrder_1_000
O adapter é uma classe que realiza a busca dos dados da Ordem de Colheita, tendo como características:
- Ser desenvolvido com base no XSD GetHarvestOrder_1_000.
- Utilização dos programas do EAI para tratamento dos dados.
- Utilização do programa GetHarvestOrderFactory para criação do XML.
GetHarvestOrderFactory - Geração do XML para o XSD GetHarvestOrder_1_000
A classe GetHarvestOrderFactory tem como objetivo criar o XML de requisição da listagem das ordens de colheita, tendo as características:
- Ser desenvolvido com base no XSD GetHarvestOrder_1_000.
- Utilização dos programas do EAI para tratamento dos dados.
Os dados incluídos no XML serão:
Parâmetros para requisição dos dados | |||
Tag | Descrição | Tipo de dado | Obrigatório |
CompanyId | Código da Empresa | CHAR(20) | Sim |
BranchId | Código da Filial | CHAR(20) | Sim |
WeighingDate | Data da Pesagem | DATE | Sim |
HarvestOrderCode | Número da Ordem e Colheita | CHAR(10) | Não |
ItemCode | Código do Produto | CHAR(20) | Não |
Informações Enviadas | |||
Tag | Descrição | Tipo de dado | Obrigatório |
HarvestOrderCode | Número da Ordem de Colheita | CHAR(10) | Não |
HarvestOrderDate | Data da Ordem de Colheita | DATE | Não |
StartHarvestForecast | Previsão de Início de Colheita | DATE | Não |
ClosingHarvestForecast | Previsão de Encerramento da Colheita | DATE | Não |
VarietyCode | Código da Variedade | INT(10) | Não |
VarietyDescription | Descrição da Variedade | CHAR(30) | Não |
ItemCode | Código do Produto Matéria Prima | INT(38) | Não |
HarvestSystemCode | Código do Sistema de Colheita | INT(10) | Não |
HarvestSystemDescription | Descrição do Sistema de Colheita | CHAR(30) | Não |
FarmCode | Código da [Fazenda] | CHAR (6) | Não |
FarmDescription | Descrição da [Fazenda] | CHAR (50) | Não |
SectorCode | Código do [Setor] | CHAR (6) | Não |
SectorDescription | Descrição do [Setor] | CHAR (50) | Não |
PartOfLandCode | Código do [Talhão] | CHAR (6) | Não |
OccupationCode | Código da Ocupação do [Talhão] | INT(10) | Não |
OccupationDescription | Descrição da Ocupação | CHAR (30) | Não |
HarvestedArea | Área do [Talhão] a ser colhida | DECIMAL(7,2) | Não |
HarvestEstimate | Estimativa (kg) de colheita para o [Talhão] | DECIMAL(10,4) | Não |
WeighingRawMaterialsAdapter - Adapter para o XSD WeighingRawMaterials_1_000
O adapter é uma classe que realiza a o envio e cancelamento das pesagens da Ordem de Colheita, tendo como características:
- Ser desenvolvido com base no XSD WeighingRawMaterials_1_000.
- Utilização dos programas do EAI para tratamento dos dados.
- Utilização do programa WeighingRawMaterialsFactory para criação do XML.
- Rotina para Inserir e Deletar pesagem de Ordem de Colheita.
WeighingRawMaterialsFactory - Geração do XML para o XSD WeighingRawMaterials_1_000
A classe WeighingRawMaterialsFactory tem como objetivo criar o XML de envio de pesagens da ordem de colheita, tendo as características:
- Ser desenvolvido com base no XSD WeighingRawMaterials_1_000.
- Utilização dos programas do EAI para tratamento dos dados.
Os dados incluídos no XML serão:
Informações Recebidas | |||
Tag-Campo | Descrição | Tipo de dado | Obrigatório |
InternalId | InternalId de Integração | INT(38) | Não |
CompanyId | Código da Empresa ERP | CHAR(20) | Sim |
BranchId | Código da Filial ERP | CHAR(20) | Sim |
MovementDate | Data do Movimento | DATE | Sim |
EntryDate | Data e Hora da 1.ª Pesagem | DATE | Sim |
ExitDate | Data e Hora da 2.ª Pesagem | DATE | Sim |
WeightNumber | Número do documento utilizado na viagem. | INT(38) | Não |
HarvestOrderCodePIMS | Número da Ordem de Colheita no PIMSMulticultivos | CHAR(10) | Não |
HarvestOrderCode | Número da Ordem de Colheita Externa | CHAR(20) | Não |
OccupationCode | Código da Ocupação no PIMSMulticultivos | INT(38) | Não |
HarvestCode | Código da Safra no PIMSMulticultivos | INT(38) | Não |
ProductionPeriodCode | Código do Período de Produção no PIMSMulticultivos | INT(38) | Não |
FarmCode | Código da [Fazenda] no PIMSMulticultivos | CHAR(6) | Não |
SectorCode | Código do [Setor] no PIMSMulticultivos | CHAR(6) | Não |
PartOfLandCode | Código do [Talhão] no PIMSMulticultivos | CHAR(6) | Não |
WarehouseCode | Código da Unidade Receptora no ERP | CHAR(20) | Não |
TeamCode | Código da Equipe no PIMSMulticultivos | INT(38) | Não |
EquipmentCode | Código do Equipamento no PIMSMulticultivos | CHAR(20) | Não |
DriverCode | Código do Motorista no ERP | CHAR(20) | Não |
HarvesterCode | Código da Colhedora no PIMSMulticultivos | CHAR(20) | Não |
OperatorCode | Código do Operador no ERP | CHAR(20) | Não |
InvoiceNumber | Número da Nota Fiscal | CHAR(10) | Não |
InvoiceSerie | Número da Série | CHAR(5) | Não |
InvoiceType | Tipo da Nota Fiscal (R - Remessa, V - Venda) | CHAR(1) | Não |
GrossWeight | Peso da 1.ª Pesagem | INT(6) | Sim |
TaraWeight | Peso da 2.ª Pesagem | INT(6) | Sim |
ImpurityTotal | Quantidade total de impureza em Kg | DECIMAL(10,2) | Não |
HarvestOrderDate | Data de Ordem de Colheita | DATE | Não |
HarvestSystemCode | Código do Sistema de Colheita no PIMSMulticultivos | INT(38) | Não |
AreaHarvestOrder | Área da Ordem de Colheita | DECIMAL(7,2) | Não |
EstimatedWeight | Kg/Ha Estimados | DECIMAL(10,4) | Não |
PackNumber | Número do Fardão | INT(12) | Não |
WeighingBulletinNumber | Número do boletim da Pesagem Externa (Romaneio) | CHAR(20) | Sim |
ChannelPIMS - Conexão com o Web Service PIMS
A referida classe tem como objetivo obter os dados de conexão que foram cadastrados no GG1005, para utilizarem as mesmas a fim de efetuar a conexão com o Web Service.
- Disponibiliza os dados obtidos para uso nos adapters GetHarvestOrderAdapter e WeighingRawMaterialsAdapter
GG2000-z06 - Zoom das Listagens de Ordem de Colheita
O respectivo programa exerce-rá função de zoom para o campo ordem de colheita no GG2000:
- Lista as Ordens de colheita conforme resultado obtido da integração.
- Criar barra de progresso para avisar que os dados estão sendo buscados via WS.
- Informar se não for possível buscar os dados via WS.
GG2000 - Romaneios
O programa de romaneios deverá ser modificado para que esteja aderente as novas funcionalidades do romaneio por produção:
- O programa gg2000-v01.w deverá ser modificado para habilitar o zoom no campo ordem de colheita.
- A habilitação só deverá acontecer se for romaneio por produção e a parametrização do campo Integração PIMS Romaneio de Produção do gg1005 estiver ativa.
- Antes de confirmar um romaneio de produção, se informado a ordem de colheita e ativa a integração, validar a ordem de colheita. Retornando inválida, parar o processo; Retornando erro na integração, permitir a inclusão, porém apresentar mensagem.
- Ao finalizar a entrada por produção deverá ser acionado o envio de dados para o PIMS
- Ao cancelar um romaneio por produção que tenha sido integrado com o PIMS, deve ser enviado uma solicitação de exclusão para o PIMS
- Dando erro no processo, tanto na inclusão quanto no cancelamento, não deve ser impeditivo para a finalização do processo, porém deverá ser apresentada uma mensagem de erro.
GGAPI064 - API Entrada Produção
O respectivo programa será alterado com a finalidade de permitir, após o processo de movimentação de estoque o envio de dados do romaneio de produção para o PIMS. Deste modo, o programa GGAPI064 deverá executar as funções do programa GGAPI126 para enviar os dados para o PIMS.
(Opcional)
Estrutura de Menu
Procedimentos
Procedimento | GG2077 |
Descrição | Pendência Integração |
Módulo | GGP |
Programa base | GG2027 |
Nome Menu | Pendência Integração |
Interface | GUI |
Registro padrão | Sim |
Visualiza Menu | Sim |
Release de Liberação | 12.1.11 |
Programas
Programa | GG2077 |
Descrição | Pendência Integração |
Nome Externo | ggp/gg2077.r |
Nome Menu/Programa | Pendência Integração |
Nome Verbalizado[1] | Pendência Integração |
Procedimento | GG2077 |
Template | Cadastro Simples |
Tipo[2] | Manutenção |
Interface | GUI |
Categoria[3] | Não se Aplica |
Executa via RPC | Não |
Registro padrão | Sim |
Outro Produto | Não |
Visualiza Menu | Sim |
Query on-line | Sim |
Log Exec. | Não |
Rotina (EMS) | Não se Aplica |
Sub-Rotina (EMS) | Não se Aplica |
Localização dentro da Sub Rotina (EMS) | Não se Aplica |
Compact[4] | Não se Aplica |
Home[5] | Não se Aplica |
Posição do Portlet[6] | Não se Aplica |
Informar os papeis com os quais o programa deve ser vinculado | Não se Aplica |
[1] Nome Verbalizado é obrigatório para desenvolvimentos no Datasul 10 em diante.
[2] Tipo é obrigatório para desenvolvimento no Datasul 10 em diante
[3] Categorias são obrigatórias para os programas FLEX.
[4] Obrigatório quando o projeto for FLEX
[5] Obrigatório quando o projeto for FLEX
[6] Obrigatório quando o projeto for FLEX
Este documento é material de especificação dos requisitos de inovação, trata-se de conteúdo extremamente técnico. |
---|