Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

CONTEÚDO

  1. Visão geral
  2. Configurações e premissas
    1. Atualização do ambiente Protheus
    2. Definição de usuário e perfil no LegalDesk
    3. Configuração dos parâmetros
  3. Ativação do serviços de sincronização online
  4. Exemplo de utilização
  5. Exceções e arquivos de Log
  6. Assuntos relacionados


01. VISÃO GERAL

Esta integração tem por objetivo realizar a sincronização imediata (online) com o LegalDesk nas exclusões de registros realizadas no módulo Pré-faturamento de Serviços (SIGAPFS).

As rotinas atendidas por essa integração são:

  • Exclusão de casos;
  • Exclusão de clientes;


02. PREMISSAS E CONFIGURAÇÕES

Atualização do ambiente Protheus:

Necessária a execução da atualização de dicionário via UPDDISTR com o pacote de expedição contínua cuja data seja igual ou superior a 22/06/2023.


Definição de usuário e perfil no LegalDesk:

Para possibilitar a exclusão automática dos casos e clientes, são necessárias as seguintes configurações:

•    Criar um usuário no LegalDesk para esse serviço;
•    Definir um perfil de acesso para ele;


Configuração dos parâmetros:

 Também será necessário preencher os seguintes parâmetros:

PARÂMETRO

DESCRIÇÃO

EXEMPLO

MV_JLDURL

Url do LegalDesk

http://meulegaldesk/API/v1/ODataGERALADV/

MV_JLDUSR

Usuário do LegalDesk para execução do serviço

LDESK

MV_JLDPWD

Senha do usuário do LegalDesk para execução do serviço

LDESK@123


Para melhor entendimento da URL no parâmetro MV_JLDURL, usando o exemplo dado acima,temos:

    • http://meulegaldesk -Domínio do LegalDesk;
    • /API/v1/OData - Trecho fixo da URL (Não alterar);
    • GERALADV/ - Nome do perfil do LegalDesk utilizado pelo usuário para realizar as operações. Preencha com o perfil de acesso criado para o usuário e, no final, complete com uma / (barra).


03. ATIVAÇÃO DO SERVIÇO DE SINCRONIZAÇÃO ONLINE

Com o ambiente atualizado, configurado e com os parâmetros preenchidos (conforme indicado no item 02), o serviço será executado na exclusão dos registros no SIGAPFS que tenham o campo "Código Legaldesk" (Cód Lanc LD) preenchido*.

*Campo de código do LegalDesk no cadastro de casos: NVE_CODLD.

*Campo de código do LegalDesk no cadastro de cliente: NUH_CODLD.


Informações
titleCarga inicial - Registros antigos

Para os registros antigos, será necessário realizar a carga inicial para preenchimento do CODLD manualmente através de script. Essa carga não será incluída na fila de sincronização.

04. EXEMPLO DE UTILIZAÇÃO

No módulo SIGAPFS, ao acessar alguma das rotinas indicadas no item 01 deste documento, selecione a opção "Excluir" e confirme a exclusão do registro. A sincronização será acionada imediatamente e, desta forma, o registro será excluído também no LegalDesk.

05. EXCEÇÕES E ARQUIVO DE LOG

Caso ocorra alguma das situações citadas abaixo durante a operação, será apresentada mensagem de aviso e o processo será interrompido, não efetivando a exclusão do registro no SIGAPFS e no LegalDesk:

  • URL informada no parâmetro MV_JLDURL incorreta e não é possível realizar a conexão;
  • Usuário e/ou senha indicados nos parâmetros MV_JLDUSR e MV_JLDPWD (respectivamente) incorretos;
  • Alguma regra de integridade/validação durante a exclusão do registro no LegalDesk não está sendo atendida;


Quando ocorrerem as situações citadas abaixo, o registro não será excluído no LegalDesk, mas será excluído normalmente no SIGAPFS. Será criado então um registro na fila de sincronização para realizar a exclusão do registro no LegalDesk.

  • Exclusão de registros com o campo "Código LegalDesk" (Cód Lanc LD) vazio;
  • Parâmetros MV_JLDURL, MV_JLDUSR, MV_JLDPWD inexistentes ou com conteúdo vazio.

O mesmo comportamento será aplicado para as situações abaixo e também será gerado um arquivo de log no formato texto (extensão .txt) para possível análise**:

  • A rotina de sincronização não encontrou o registro no LegalDesk.
  • Instabilidade/demora na conexão entre o SIGAPFSe o LegalDesk.


Expandir
title**Configuração do arquivo de log
Informações
iconfalse

Nome do arquivo:

  • Rotina_Data_Hora_CódigoLegalDesk

Informações do arquivo:

  • Operação realizada. Será indicado DELETE para exclusões.
  • Participante que realizou a operação, com o código, a sigla e o nome do participante.
  • Data e hora de envio.
  • Erro.


Exemplo:

Nome do arquivoConteúdo do arquivo
JURA070_20230517_180212_64511786-7662-0016-ec6c-104ff6151ad2.txtOperação: DELETE
Participante: 000002 - ADM - PART ADMIN
Data e hora de envio: 17/05/2023 - 18:02:12
Erro: 404 NotFound
JURA148_20230517_180212_64511786-7662-0016-ec6c-104ff6151ad2.txtOperação: DELETE
Participante: 000002 - ADM - PART ADMIN
Data e hora de envio: 17/05/2023 - 18:02:12
Erro: 404 NotFound

IMPORTANTE: Esses arquivos ficarão no diretório JURLOGSYNCONLINE na pasta ProtheusData. Essa pasta será criada automaticamente na primeira ocorrência.


06. ASSUNTOS RELACIONADOS