Á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

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

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

  • Exclusão de casos;


02. PREMISSAS E CONFIGURAÇÕES

...

Atualização do ambiente Protheus:

Executar Necessária a execução da atualização de dicionário via UPDDISTR com o pacote de expedição contínua com 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, serão necessárias as seguintes configurações:

...

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


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

    • http://meulegaldesk -Se trata do domínio do LegaldeskDomínio do LegalDesk;
    • /API/v1/OData - Trecho fixo da URL (Não alterar);
    • GERALADV/ - Se trata Nome do perfil do LegalDesk utilizado pelo usuário para realizar as operações. Preencha com o perfil criado no passo anterior. E no final do nome do 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

A partir do momento que Com o ambiente estiver atualizado, configurado e com os parâmetros preenchidos (conforme indicado no passo 2item 02), o serviço será executado na exclusão dos registros no módulo Pré-Faturamento de Serviços (SIGAPFS ) que tenham o campo "Código Legaldesk" (Cód Lanc LD) preenchido*.

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


04. EXEMPLO DE UTILIZAÇÃO

No módulo Pré-Faturamento faturamento de Serviços (SIGAPFS), ao acessar alguma das rotinas indicadas no passo 1 item 01 deste documento, selecionar selecione a opção "Excluir" e confirmar confirme a exclusão do registro, a . A sincronização será acionada imediatamente . Dessa e, desta forma, o registro será excluído no módulo Pré-Faturamento de Serviços (SIGAPFS) e no Legaldesktambém no LegalDesk.

05. EXCEÇÕES E ARQUIVO DE LOG


Informações
iconfalse

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 módulo Pré-Faturamento de Serviços (SIGAPFS) e no Legaldesk SIGAPFS e no LegalDesk:

  • URL informada no parâmetro MV_JLDURL incorreta e não for é 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 LegalDesk não for está sendo atendida;
Informações
iconfalse

Caso ocorra alguma das Quando ocorrerem as situações citadas abaixo durante a operação, o registro não será excluído no LegaldeskLegalDesk, mas será excluído normalmente no módulo Pré-Faturamento de Serviços ( SIGAPFS). Será criado então um registro na fila de sincronização para realizar a exclusão do registro no LegaldeskLegalDesk.

  • Exclusão de registros com o campo "Código LegaldeskLegalDesk" (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. Mas, além disso, 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 LegaldeskLegalDesk.
  • Instabilidade/demora na conexão entre o módulo Pré-Faturamento de Serviços ( SIGAPFSe o LegaldeskLegalDesk.


Expandir
titleConfiguraçã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. Será indicada , 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

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

06. ASSUNTOS RELACIONADOS

...