Melhorias Depot - Processamento de Arquivos EDI + Criação de Layout Genérico de DESTIM de Estimativa de Reparo de Estrutura

Características do Requisito

Descrição

Escreva aqui a descrição da nova implementação ou melhoria.

Importante

(Apenas para Microsiga Protheus, versões anteriores à versão 12)

Antes de executar o compatibilizador informe o nome do compatibilizador é imprescindível:

• Realizar o backup da base de dados do produto que será executado o compatibilizador (diretório PROTHEUS_DATA\DATA, se versão 10, ou \PROTHEUS11_DATA\DATA, se versão 11) e dos dicionários de dados SXs (diretório PROTHEUS_DATA_SYSTEM, se versão 10, ou \PROTHEUS11_DATA\SYSTEM, se versão  11).
• Os diretórios acima mencionados correspondem à instalação padrão do Protheus, portanto, devem ser alterados conforme o produto instalado na empresa.
• Essa rotina deve ser executada em modo exclusivo, ou seja, nenhum usuário deve estar utilizando o sistema.
• Se os dicionários de dados possuírem índices personalizados (criados pelo usuário), antes de executar o compatibilizador, certifique-se de que estão identificados pelo nickname. Caso o compatibilizador necessite criar índices, irá adicioná-los a partir da ordem original instalada pelo Protheus, o que poderá sobrescrever índices personalizados, caso não estejam identificados pelo nickname.
• O compatibilizador deve ser executado com a Integridade Referencial desativada*.

1. Em Microsiga Protheus TOTVS Smart Client (se versão 10), digite o nome do compatibilizador no campo Programa Inicial. Descreva se o compatibilizador deve ter uma data específica ou superior para que a atualização nos dicionários seja efetuada corretamente. Importante: Para a correta atualização do dicionário de dados, certifique-se que a data do compatibilizador seja igual ou superior a ___/___/____.
2. Clique em OK para continuar.
3. Após a confirmação é exibida uma tela para a seleção da empresa em que o dicionário de dados será modificado ou é apresentada a janela para seleção do compatibilizador. Selecione o programa xxxx().
4. Ao confirmar é exibida uma mensagem de advertência sobre o backup e a necessidade de sua execução em modo exclusivo.
   1. Clique em Processar para iniciar o processamento. O primeiro passo da execução é a preparação dos arquivos.
      É apresentada uma mensagem explicativa na tela.
   2. Em seguida, é exibida a janela Atualização concluída com o histórico (log) de todas as atualizações processadas. Nesse log de atualização são apresentados somente os campos atualizados pelo programa. O compatibilizador cria os campos que ainda não existem no dicionário de dados.
   3. Clique em Gravar para salvar o histórico (log) apresentado.
   4. Clique em OK para encerrar o processamento.

Descreva se há algum procedimento necessário após a aplicação do compatibilizador.

Procedimento para Implantação

O sistema é atualizado logo após a aplicação do pacote de atualizações (Patch) deste chamado.

1. Aplique o patch do chamado e execute uma vez a rotina Informe o nome da rotina.
2. No módulo informe o nome do módulo acesse informe o caminho e verifique que o parâmetro informe o nome do parâmetro é criado conforme especificações abaixo:

Atualizações do Compatibilizador

(Apenas para Microsiga Protheus, versões anteriores à versão 12)

1. Criação ou Alteração de Perguntas no arquivo SX1 – Cadastro de Perguntes:

2.    Criação ou Alteração de tabela no arquivo SX2– Tabelas:

3.  Criação ou Alteração de Tabelas Genéricas no arquivo SX5 – Tabelas Genéricas:

4.  Criação ou Alteração (mantenha somente a instrução correspondente) de Campos no arquivo SX3 – Campos:

• Tabela BGD - Prod x Cob x Proc x Co-Part:

Importante:

O tamanho dos campos que possuem grupo pode variar conforme ambiente em uso.

5.  Criação ou Alteração de Consulta Padrão no arquivo SXB – Consulta Padrão:

• Pesquisa B05PLS:

6.  Criação ou Alteração de Índices no arquivo SIX – Índices:

7.  Criação ou Alteração de Parâmetros no arquivo SX6 – Parâmetros:

8.  Criação ou Alteração (mantenha somente a instrução correspondente) de Gatilhos no arquivo SX7 – Gatilhos:

• Tabela BD5 – Contas Médicas:

Procedimento para Configuração

(Estes procedimentos devem ser feitos quando for necessário configurar parâmetros e/ou  rotinas no menu).

CONFIGURAÇÃO DE PARÂMETROS

1. No Configurador (SIGACFG), acesse Ambientes/Cadastros/Parâmetros (CFGX017). Crie/configure (mantenha somente a instrução correspondente) o(s) parâmetro(s) a seguir:
   (É necessário criar uma tabela para cada parâmetro descrito no item Parâmetro(s), da tabela Características do Requisito)

CONFIGURAÇÃO DE MENUS

2.  No Configurador (SIGACFG), acesse Ambientes/Cadastro/Menu (CFGX013). Informe a nova opção de menu do informe o nome do módulo, conforme instruções a seguir:

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.

Vídeo

• Vídeo hospedado no youtube e inserido no template por meio da macro Widget Connector.

** Canal do youtube e software de vídeoem definição.

Descrição

Implementadas 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. Deste 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 capacidade 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.

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. Desta forma, 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.

Com isso, 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 reparo 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ão sendo liberados 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 (módulo Sistema / Depot / EDIFACT / Configuração EDI / Campo):

1. Incluídos 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 permanecerão como "somente leitura".
3. Corrigida a 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 (Módulo Sistema / Depot / EDIFACT / Configuração EDI / Linha):

1. Incluído o 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 à tela de campos.
3. Corrigida 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 (Módulo Sistema / Depot / EDIFACT / Configuração EDI / 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. Corrigida a 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 (Módulo Sistema / Depot / EDIFACT / Versão Arquivo x Armador (Configuração)):

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. Consistirá se a configuração possui o layout configurado com seus grupos, linhas e campos. Caso esteja configurado, 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 o layout que tenha geração de EDI relacionado.

5)      Importação de Layout (Módulo Sistema / Depot / EDIFACT / Versão Arquivo x Armador (Configuração) - Botão Importar):

1. Corrigido o procedimento de importação (cópia de layout de EDI) para copiar/herdar 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

1. Realizar a atualização do banco de dados por meio do AtualizaDB.
2. Caso possua o serviço de EDI Depot instalado, favor efetuar a desinstalação do serviço antes da atualização para o novo executável.
   1. Abrir o cmd do Windows como Administrador.
   2. Pelo cmd, acessar o local onde o executável do serviço foi salvo e executar o comando, conforme abaixo, para realizar a desinstalação.
       prjEdiDepot_Servico.exe /uninstall
      O sistema apresentará uma mensagem de confirmação da desinstalação.
3. Realizar a atualização dos executáveis do pacote.
4. Realizar a execução dos scripts do pacote.
5. Realizar a instalação do serviço de EDI Depot (o serviço deve ser instalado no servidor onde os EDIs deverão ser gerados).
   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 no servidor).
   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.

Procedimento para Configuração

Configuração de Acesso ao Banco de Dados 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\SARA_EdiDepot_Servico.
2. Configure a chave Ini_Banco com o diretório e o 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 SARA - EDI DEPOT e clique em Iniciar.

Procedimento para Utilização

Procedimento Para Conferência de Geração de EDI de CODECO de gate in

Pré-condições

1. Layout de EDI de CODECO de gate in configurado para o armador desejado no módulo Sistema.

2. Serviço de EDI Depot em execução.
3. Procedimento de entrada de container vazio no Depot executado, mas sem a saída do veículo de descarga executado.

Procedimento

1. Abra o módulo Portaria na tela de CESV/CESP e selecione um CESV de descarga de container vazio de Depot, que esteja de acordo com a pré-condição deste procedimento.
2. Realize o fechamento do CESV.
   O sistema apresentará a tela de confirmação recebimento do Depot.
3. Clique na opção Imprimir EIR.
   O sistema imprimirá o EIR e gerará a pendência de EDI para gate in.
4. Aguarde o tempo necessário conforme parametrizado na chave Intervalo no registro do Windows, de acordo com os procedimentos de configuração deste documento, e pelo intervalo de tempo configurado no layout do arquivo de EDI, realizado pelo módulo Sistema.
5. Valide no diretório configurado para o EDI no módulo Sistema, se o arquivo de EDI foi gerado corretamente.

Procedimento Para Conferência de Geração de EDI de CODECO de gate out

Pré-condições

1. Layout de EDI de CODECO de gate out configurado para o armador desejado no módulo Sistema.
2. Serviço de EDI Depot em execução.
3. Procedimento de saída de container vazio no Depot executado, mas sem a saída do veículo de carga executado.

Procedimento

1. Abra o módulo Portaria na tela de CESV/CESP e selecione um CESV  de carga de container vazio de Depot, que esteja de acordo com a pré-condição deste procedimento.
2. Realize o fechamento do CESV.
   O sistema apresentará a tela de confirmação de saída do Depot.
3. Clique na opção Imprimir EIR;
   O sistema imprimirá o EIR e gerará a pendência de EDI para gate out.
4. Aguarde o tempo necessário conforme parametrizado na chave Intervalo no registro do Windows, de acordo com os procedimentos de configuração deste documento, e pelo intervalo de tempo configurado no layout do arquivo de EDI, realizado pelo módulo Sistema.
5. Valide no diretório configurado para o EDI, no módulo Sistema, se o arquivo de EDI foi gerado corretamente.

Procedimento Para Conferência de Geração de EDI de DESTIM de Vistoria de Estrutura

Pré-condições

1. Layout de EDI de DESTIM de vistoria configurado para o armador desejado no módulo Sistema.
2. Serviço de EDI Depot em execução.
3. Procedimento de entrada de container vazio no Depot executado.
4. EDI de gate in gerado.

Procedimento 1: Pela Tela de Confirmação de Recebimento do Depot no Módulo Portaria

1. Abra o módulo Portaria na tela de CESV/CESP e selecione um CESV de carga de container vazio de Depot, que esteja pendente de saída do veículo de descarga.
2. Realize o fechamento do CESV.
   O sistema apresentará a tela de confirmação de saída do Depot.
3. Clique na opção Vistoria, registre uma vistoria de container e feche a tela.
   Neste momento o sistema gerará uma pendência de geração de EDI de vistoria de estrutura.
4. Clique na opção Imprimir EIR.
   O sistema imprimirá o EIR e gerará a pendência de EDI para gate out.
5. Aguarde o tempo necessário conforme parametrizado na chave Intervalo no registro do Windows, de acordo com os procedimentos de configuração deste documento, e pelo intervalo de tempo configurado no layout do arquivo de EDI, realizado pelo módulo Sistema.
6. Valide no diretório configurado para o EDI, no módulo Sistema, se o arquivo de EDI foi gerado corretamente.

Procedimento 2: Pela Tela de Containers Aguardando Vistoria no Módulo Operacional

1. Abra o módulo Operacional na tela de Containers Aguardando Vistoria, no menu Depot, selecione um container pendente de vistoria que tenha gate in gerado e realize a vistoria.
   O sistema gerará uma pendência de EDI de vistoria de estrutura.
2. Aguarde o tempo necessário conforme parametrizado na chave Intervalo no registro do Windows, de acordo com os procedimentos de configuração deste documento, e pelo intervalo de tempo configurado no layout do arquivo de EDI, realizado pelo módulo Sistema.
3. Valide no diretório configurado para o EDI, no módulo Sistema, se o arquivo de EDI foi gerado corretamente.

Procedimento Para Conferência de Geração de EDI de DESTIM de Estimativa de Reparo de Estrutura

Pré-condições

1. Layout de EDI de DESTIM de estimativa de reparo configurado para o armador desejado no módulo Sistema.
2. Serviço de EDI Depot em execução.
3. Estimativa de reparo cadastrada no módulo Faturamento / Depot / Estimativa de Reparo, mas não finalizada para um container do armador do layout.
4. EDI de gate in gerado.
5. EDI de vistoria de estrutura gerado.

Procedimento

1. Abra o módulo Faturamento na tela de Estimativa de Reparo, do menu Depot, e selecione uma estimativa de reparo que esteja de acordo com a pré-condição deste procedimento.
2. Finalize a estimativa clicando em Outras Ações / Finalizar Estimativa.
   O sistema finalizará a estimativa e gerará a pendência de EDI de estimativa de reparo.
3. Aguarde o tempo necessário conforme parametrizado na chave Intervalo no registro do Windows, de acordo com os procedimentos de configuração deste documento, e pelo intervalo de tempo configurado no layout do arquivo de EDI, realizado pelo módulo Sistema.
4. Valide no diretório configurado para o EDI, no módulo Sistema, se o arquivo de EDI foi gerado corretamente.

Procedimento Para Conferência de Geração de EDI de DESTIM de Vistoria de Maquinário

Pré-condições

1. Layout de EDI de DESTIM de vistoria de maquinário configurado para o armador desejado no módulo Sistema.
2. Serviço de EDI Depot em execução.
3. EDI de gate in gerado.

Procedimento

1. Abra o módulo Operacional na tela de Containers Pendentes de Vistoria de Maquinário (PTI), do menu Depot, e selecione um container do tipo reefer pendente de vistoria de maquinário.
2. Realize a vistoria.
   O sistema gerará a pendência de EDI de vistoria de maquinário.
3. Aguarde o tempo necessário conforme parametrizado na chave Intervalo no registro do Windows, de acordo com os procedimentos de configuração deste documento e pelo intervalo de tempo configurado no layout do arquivo de EDI, realizado pelo módulo Sistema.
4. Valide no diretório configurado para o EDI, no módulo Sistema, se o arquivo de EDI foi gerado corretamente.

Procedimento Para Conferência de Geração de EDI de DESTIM de Reparo de Maquinário

Pré-condições

1. Layout de EDI de DESTIM de vistoria de maquinário configurado para o armador desejado no módulo Sistema.
2. Serviço de EDI Depot em execução.
3. EDI de vistoria de maquinário gerado.

Procedimento

1. Abra o módulo Operacional na tela de Status de Reparo de Maquinário, do menu Depot, e selecione um container do tipo reefer pendente de reparo de maquinário.
2. Realize a troca de status do container até informar a data do reparo.
   O sistema gerará a pendência de EDI de reparo de maquinário.
3. Aguarde o tempo necessário conforme parametrizado na chave Intervalo no registro do Windows, de acordo com os procedimentos de configuração deste documento, e pelo intervalo de tempo configurado no layout do arquivo de EDI, realizado pelo módulo Sistema.
4. Valide no diretório configurado para o EDI, no módulo Sistema, se o arquivo de EDI foi gerado corretamente.

Procedimento Para Conferência de Geração de EDI de DESTIM de Saída de Reparo de Estrutura

Pré-condições

1. Layout de EDI de DESTIM de saída de reparo configurado para o armador desejado no módulo Sistema.
2. Serviço de EDI Depot em execução.

Procedimento

1. Abra o módulo Operacional na tela de Oficina, do menu Depot, e selecione um container pendente de reparo.
2. Realize o processo de registro de reparo até a conclusão do reparo.
   O sistema gerará a pendência de EDI de saída de reparo de estrutura.
3. Aguarde o tempo necessário conforme parametrizado na chave Intervalo no registro do Windows, de acordo com os procedimentos de configuração deste documento, e pelo intervalo de tempo configurado no layout do arquivo de EDI, realizado pelo módulo Sistema.
4. Valide no diretório configurado para o EDI, no módulo Sistema, se o arquivo de EDI foi gerado corretamente.

Ponto de Entrada

Exemplo:

#Include 'Protheus.ch'

User Function CN120ALT()

Local aCab:= PARAMIXB[1]

Local cTipo:= PARAMIXB[2]

If cTipo == '1'

    aCab[4][2]:= 'NF' //Validações do usuário

EndIf