Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

NOME DO REQUISITO

Características do Requisito

Linha de Produto:

SARA

Segmento:

Supply Chain Logística

Módulo:

Sistema + EDI Depot

Rotina:

+ Configuração EDI Depot

+ Layouts Genéricos EDI Depot:

  • Gate in (CODECO)
  • Gate out (CODECO)
  • Vistoria de estrutura (AVL e DAM) (DESTIM)
  • Saída de reparo estrutura (DESTIM)
  • Estimativa de reparo de estrutura (DESTIM)
  • Vistoria de maquinário (DESTIM)
  • Reparo de maquinário (DESTIM)

+ Serviço de Geração EDI Depot

Requisito (ISSUE): LOGSARA01-5

País(es):

Brasil

Banco(s) de Dados:

SQL Server

Tabelas Utilizadas:

  • dbo.tab_edi_versao_arquivo - Versões de Arquivo de EDI (Layouts)
  • dbo.rel_edi_cli_arquivo_conf - Configuração de EDI por Armador
  • dbo.tab_edi_depot_cnt_pend - Controle de Pendência de EDI
  • dbo.tab_edi_depot_ctrl_tempo - Controle de Tempo de Geração de EDI
  • dbo.tab_edi_grupo - Layout de EDI - Grupo
  • dbo.tab_edi_linha - Layout de EDI - Linha
  • dbo.tab_edi_campo - Layout de EDI - Campos
  • dbo.tab_historico_edi_depot - Histórico de Geração de EDI
  • dbo.tab_historico_edi_depot_cnt - Histórico de Geração de EDI

Sistema(s) Operacional(is):

Windows

Descrição

Implementado melhorias no serviço de geração de EDI e gerado modelo genérico de EDI DESTIM para estimativa de reparo de estrutura do container do módulo Depot.

O serviço de EDI Depot passou a ser capaz de processar EDIs conforme modelo de configuração de grupo dinâmico (que permite cadastrar código SQL) e grupo pai conforme desenvolvido no PCREQ-3089. Anteriormente, a versão do Serviço de Geração de EDI não era capaz de processar EDIs com esta configuração e causava travamento no programa. Desse modo, o Serviço de EDI passou por um processo de refatoração de código no que foi tratado o processamento de grupos dinâmicos e grupos pais tomando como princípio o não travamento no processamento. Com esta melhoria, o cadastramento do layout de EDI de DESTIM de Estimativa de reparo de estrutura passou a ser possível, pois com a possibilidade de processar grupos dinâmicos e hierarquia de grupos, blocos de seguimentos do layout passaram a poder se repetir dentro da estrutura do arquivo de EDI.

Para um melhor entendimento sobre a repetição de blocos de seguimentos, observe o exemplo abaixo de um layout de EDI de DESTIM de Estimativa de Reparo de Estrutura.

Info
titleExemplo de EDI DESTIM de Estimativa de Reparo

UNB:2+UNOA+BRIOAAD+MSC+20160826:1631+1'
UNH+1+DESTIM:D:96B:UN'
BGM+28+1+9'
DTM+137:201605191721:102'
DTM+501:201608261630:102'
RFF+EST:20'
FTX+AAI+++M.D.-10/13'
EQD+CN+DJON0000011+42G0:102:5+++4'
IMD+CG++CARGA GERAL'
NAD+MS+BRIOAAD:TE:ZZZ'
UNS+D'

Repetição de bloco 1

LIN+1+1'
DIM+10+CMT:1200:100:100'
QTY+1:1'
FTX+AAI+++11201 - STR BOTTON OR TOP RAIL'
DAM+EQD+WA:ZZZ:5+LXXX:ZZZ:5++GS:ZZZ:5'
COD+PAA:ZZZ:5+SU:ZZZ:5'
RTE+2:49.48'
QTY+207:12.20'
MOA+186:39.88:BRL'
MOA+185:603.66:BRL'

Repetição de bloco 2

LIN+2+1'
DIM+10+CMT:0:0:0'
QTY+1:1'
FTX+AAI+++96901 - WASH 20'UNIT'
DAM+EQD+ZZ:ZZZ:5+BXXX:ZZZ:5++WW:ZZZ:5'
COD+ZZZ:ZZZ:5+MU:ZZZ:5'
RTE+2:49.48'
QTY+207:0.00'
MOA+186:120.00:BRL'
MOA+185:0.00:BRL'

Repetição de bloco 3

LIN+3+1'
DIM+10+CMT:0:0:0'
QTY+1:1'
FTX+AAI+++96902 - WASH 40'UNIT'
DAM+EQD+ZZ:ZZZ:5+XXXX:ZZZ:5++WW:ZZZ:5'
COD+ZZZ:ZZZ:5+MU:ZZZ:5'
RTE+2:49.48'
QTY+207:0.00'
MOA+186:240.00:BRL'
MOA+185:0.00:BRL'

Repetição de bloco 4

LIN+4+1'
DIM+10+CMT:650:600:10'
QTY+1:1'
FTX+AAI+++13431 - INSERT STEEL PANEL 60X60'
DAM+EQD+CU:ZZZ:5+RX1X:ZZZ:5++IT:ZZZ:5'
COD+PAA:ZZZ:5+SU:ZZZ:5'
RTE+2:49.48'
QTY+207:2.50'
MOA+186:137.21:BRL'
MOA+185:123.70:BRL'


MEA+WT+T+KGM:3800'
MEA+WT+G+KGM:32000'
CNT+8:1'
UNT+54+1'
UNZ+1+1'

Conforme exemplo acima, existem quatro repetições de blocos de seguimentos de informação. Cada bloco que se repete vai do seguimento LIN, que efetua a contagem sequencial de item de estimativa, até o seguimento MOA de custos de mão de obra e material de cada item de estimativa. Neste exemplo, a estimativa de reparo gerada possuí quatro itens de estimativa e, por este motivo, o bloco de informação se repetiu quatro vezes. Cada seguimento é representado por uma linha no cadastro de configuração de EDI. Já o bloco de seguimentos é representado pelo Grupo da configuração de EDI. Sem a possibilidade de grupo dinâmico, assim como já existia para a linha a linha dinâmica, a repetição de blocos de informação não seria possível assim como não seria possível atender os critérios dos EDIs do padrão EDIFACT.

Desse modo, nesta estória está sendo entregue, juntamente com as melhorias no processamento de EDI pelo serviço, um script de banco de dados com diversos modelos de EDIs pré-configurados baseados nos padrões CODECO e DESTIM do armador MSC para gate in, gate out, vistoria de estrutura, vistoria de maquinário, estimativa de reparo de estrutura, saída de oficina de estrutura e reparo de maquinário. Todos estes layouts foram validados juntamente com a MSC, exceto o DESTIM de Estimativa de Reparo de Estrutura criado nesta estória somente com o apoio documental da MSC e sem o apoio da TI para a validação do arquivo gerado. Além dos layouts genéricos de EDIs, está sendo liberado os gatilhos para a geração dos EDIs de reparo de maquinário, vistoria de maquinário e o ajuste no tratamento do gatilho de vistoria de estrutura.

Importante¹

Durante o processo de cadastro da configuração genérica do EDI de Estimativa de Reparo, algumas dificuldades foram identificadas nas telas de configuração e foram tratadas nesta mesma estoria, mesmo não fazendo parte do objetivo principal. São elas:

1)      Na tela de cadastro de campo:

  1. Incluído botões para acessar as telas de cadastro de linha e cadastro de grupo. As telas abrirão com a mesma configuração de arquivo/armador selecionada na tela de campo.
  2. A tela em modo de visualização permitirá acesso ao conteúdo dos campos (para permitir copiar os textos), ou seja, ao invés de campos desabilitados os campos ficarão como somente leitura.
  3. Corrigido busca de campos de grupo dinâmico. O campo não levava em consideração que o grupo da linha correspondente ao campo poderia possuir um grupo pai.

2)      Na tela de cadastro de linha:

  1. Incluído botão para acessar a tela de cadastro de grupo. A tela abrirá com a mesma configuração de arquivo/armador selecionada na tela de cadastro de linha.
  2. A tela em modo de visualização permitirá acesso ao conteúdo dos campos igualmente a tela de campos.
  3. Corrigido busca de campos do grupo dinâmico para servir como parâmetro de filtro de SQL de linha dinâmica. O campo não levava em consideração que o grupo da linha poderia possuir um grupo pai.
  4. Ao selecionar um filtro para o SQL dinâmico, seja de parâmetro de grupo dinâmico ou mcnt_id ou armador, adicionará o filtro no local exato onde o cursor de texto estiver posicionado no Memo. Se selecionado um bloco de texto no memo, ao selecionar o filtro substituirá o bloco de texto pelo filtro.

3)      Na tela de cadastro de grupo:

  1. A tela em modo de visualização permitirá acesso ao conteúdo dos campos assim como as telas de linhas e campos.
  2. Corrigido busca de campos do grupo dinâmico para filtragem de SQL de grupo dinâmico. Agora será possível utilizar um campo de um SQL dinâmico cadastrado para um grupo pai como filtro para o SQL dinâmico de um grupo filho.
  3. Ao selecionar um filtro para o SQL dinâmico, seja de parâmetro de grupo dinâmico ou mcnt_id ou armador, adicionará o filtro no local exato onde o cursor de texto estiver posicionado no Memo. Se selecionado um bloco de texto no memo, ao selecionar o filtro substituirá o bloco de texto pelo filtro.

4)      Cadastro de configuração de arquivo do armador:

  1. A tela em modo de visualização permitirá acesso ao conteúdo dos campos assim como nas telas anteriores.
  2. Tratado o botão excluir da tela: 
    1. Não permitirá excluir layout de beneficiário genérico; 
    2. Irá consistir se a configuração já possui o layout configurado, caso esteja realizará uma pergunta de confirmação a mais para garantir a intenção de remover o layout, pois apagará o layout por completo; 
    3. Não permitirá excluir layout que já tenha geração de EDI relacionado;

5)      Importação de layout:

  1. Corrigido procedimento de importação para tratar o SQL de grupo dinâmico e o grupo pai do cadastro de grupo.

Importante²

Os itens 2, 3, 4.c e 4.d da especificação desta estória, que pode ser acessada clicando aqui, já foram liberadas na estoria LOGSARA01-2.

Procedimento para Implantação

  • Atualização do banco de dados por meio do AtualizaDB.
  • Atualização dos executáveis do pacote.
  • Execução dos scripts do pacote.

Procedimento para Configuração

Instalação do serviço de EDI Depot

  1. Adicionar o executável do serviço de EDI (prjEdiDepot_Servico.exe) na pasta de executáveis do SARA ou em um local de preferência;
  2. Abrir o cmd do windows como administrador;
  3. Pelo cmd, acessar o local onde o executável do serviço foi salvo e executar o comando conforme abaixo para realizar a instalação.
    Se desejar inicialização manual:
            prjEdiDepot_Servico.exe /install 
    Se desejar inicialização automática com o sistema operacional:
            prjEdiDepot_Servico.exe /install /start=auto
    O sistema apresentará uma mensagem de confirmação da instalação.

Configuração de acesso ao banco de dados do para o serviço de EDI Depot

  1. Abra o regedit.exe do windows e acesse o diretório HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\services\EDI_DEPOT;
  2. Configure a chave Ini_Banco com o diretório e nome do arquivo de configuração de acesso a banco de dados do SARA;
    Exemplo: C:\SARA\ini\SARA_SQLSERVER_2012.ini
  3. Configure a chave Intervalo com o tempo desejado em minutos que o serviço de EDI deverá realizar uma leitura de verificação de pendência de geração de EDI;
    Exemplo: 10
  4. Configure a chave Senha com a senha de acesso ao banco de dados conforme banco do arquivo ini da chave Ini_banco;
    Exemplo: 123@mudar
  5. Configure a chave Usuario com o usuário de acesso ao banco de dados conforme arquivo ini.
    Exemplo: sa

Para iniciar o serviço acesse o services.msc do windows procure pelo serviço EDI DEPOT e acione Iniciar.

Procedimento para Utilização

  • Descreva os procedimentos, passo a passo (caso de uso), que serão realizados pelos usuários para que a melhoria seja visualizada identificando as seguintes informações:
  • Localização da rotina no menu;
  • Localização dos novos campos e/ou perguntas e respectivas pastas de cadastro que são visualizadas pelo usuário;
  • Caso seja necessário ter algum cadastro feito previamente, faça uma observação.

 

 

Exemplo:

       1.            No Plano de Saúde (SIGAPLS), acesse Atualizações / Produto Saúde / Produto Saúde (PLSA800).

O sistema apresenta a janela de produtos cadastrados.

       2.            Posicione o cursor em um produto e clique em Alterar.

       3.            Na pasta Cobertura/Carências selecione a subpasta Tipo de Prestador.

       4.            Dê duplo clique no campo TP Prestador (BCW_TIPPRE).

O sistema apresenta a janela Tipo de Prestador – Coparticipação – Alterar.

       5.            Informe os dados conforme orientação do help de campo e observe o preenchimento do novo campo:

                      Som. p/Compra (BCW_SOMCOM): selecione Sim para indicar se a coparticipação cadastrada será válida somente para efeito de compra de procedimentos ou Não, caso contrário.

       6.            Confira os dados e confirme.