Histórico da Página
CONTEÚDO
- Visão geral
- Configurações e premissas
- Atualização do ambiente Protheus
- Definição de usuário e perfil no LegalDesk
- Configuração dos parâmetros
- Ativação do serviços de sincronização online
- Exemplo de utilização
- Exceções e arquivos de Log
- 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 | ||
---|---|---|
| ||
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 | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||
|
06. ASSUNTOS RELACIONADOS
- Principais Parâmetros - Pré-faturamento de Serviços
- Cadastro de Casos - JURA070
- Clientes - JURA148 - Gestão Jurídica - P12