CONTEÚDO

01. Visão geral

Esta integração possui como objetivo principal permitir que os usuários realizem as operações de Anexos no IManage Worksite Web, a partir das rotinas do Pré-faturamento de serviços (SIGAPFS) e do Jurídico Departamentos (SIGAJURI) . Desta forma, não é mais necessária a utilização da dll.

02. Configurações

Para utilizar a funcionalidade é necessário realizar as configurações a seguir:

• Parâmetros no Protheus:

Usuário para Comprovante de Despesas

É sugerido que seja criado um usuário de Serviço para a geração de Relatório de Comprovante de Despesas. O usuário de serviço é ideal pois independe do tipo de autenticação usada pelo cliente.

Servidor Protheus ( Appserver )

Configurar o callback no servidor Protheus para realizar a integração com o iManage web. Necessário configurar com a porta do REST.

[OAUTH_CLIENT]
CALLBACK_SERVER=http://localhost:12173/rest/oauthcallback
EXTERNALBROWSER=1

Protheus com WEBAPP

Para realizar a integração utilizando web App é necessário:

• • Configurar no Appserver.ini a chave EXTERNALBROWSER=1. Verifique o exemplo no passo anterior.
  • Possuir a última lib publicada oficialmente após 23/08/2024.

IManage Web ( Control Center )

• • É necessário configurar usuários que possuam acesso ao iManage Worksite web.
     
  • Para acessar as configurações do iManage acesse Control Center > Aplications > Protheus 
    • Client type: Define como será feita a configuração de autenticação do app Protheus com o iManage. Pode ser configurado como Public ou Confidencial.
    • Redirect URL: Deve conter a url do rest do Protheus, para que o iManage possa realizar a comunicação com o Protheus. Importante ser a mesma url configurada na chave OAUTH_CLIENT, no appserver.ini.  Exemplo: http://server:port/oauthcallback

• • • Campos custom (utilizados para filtrar pastas por cliente e caso):

Configuração sugerida de valor do parâmetro de timeout do iManage para ambientes On Premisses:

Registry Key Location: HKLM\SOFTWARE\Interwoven\WorkSite\imDMsSvc
DWORD Name: Work Grant Token Expiry
DWORD Value: 30 (segundos)

Obs.: Para ambientes Cloud o valor default é 60 (segundos)

03. Autenticação

04. Abrir documento

05. Importar documento (Upload)

06. Anexar documento

a) Pesquisar documentos ou e-mails

A funcionalidade de Anexar permite que o usuário faça a pesquisa de documentos ou e-mails, conforme os tipos a seguir:

i) Pesquisa por nome

Importante: Para realizar as pesquisas por nome, digite ao menos 3 caracteres. 

ii) Pesquisa por número

Importante: Para realizar as pesquisas pelo id, é necessário digitar somente números. Não são permitidas letras e/ou caracteres especiais.

Caso a pesquisa não retorne itens, será apresentada a mensagem "A pesquisa não retornou dados".

b) Pesquisar casos/assuntos

A funcionalidade de Anexar permite que o usuário faça a pesquisa de caso/assunto, para que possa navegar por níveis de pastas, com o objetivo de selecionar um documento de determinada pasta.

Este tipo de pesquisa está disponível somente em entidade que não possuem cliente e caso. Exemplo: Rotinas do financeiro.

Para as rotinas que possuem cliente e caso definidos, o sistema irá realizar o filtro automaticamente, e para isso é necessário configurar os parâmetros MV_JNRCCLI e MV_JNRCCAS. Quando o cliente\caso não existir no iManage, será apresentada a mensagem "Não foram encontrados itens para o cliente/caso". Rotinas que realizam o filtro automaticamente:

• • Despesas
  • Casos
  • Contratos - Filtra somente cliente e apresenta todos os assuntos de todos os casos do cliente filtrado.

07. Download de documentos

08. Excluir

09. Subpastas

10. Tabelas utilizadas

• NUM - Anexos

11. FAQ

Possíveis erros conhecidos que podem ocorrer após a configuração desta funcionalidade:

1 - Problema: Erro de inconsistência apresentado "DBSetOrder - Index not found: OAUTH2_CB Order Number: 1 ...".

• • Motivo: No momento em que a tabela foi criada o appserver estava sendo executado com restrições de permissão.
  • Solução: Na pasta protheus_data > semáforo, apague o arquivo da tabela atual oauth2_cb e em seguida reinicie o appserver.exe, iniciando este em modo administrador.
  • 

2 - Problema: Erro de inconsistência apresentado "Ctree Error - Open - Internal index name coul".

• • Motivo: Conflito no compartilhamento de arquivos CTREE.
  • Solução: Olhar o doc (TDN) que indica como resolver. Em ambientes T-CLOUD, foi habilitado o ctree local.

3 - Problema: Os comprovantes de despesas não estão sendo unificados no relatório da fatura.

• • Motivo: O usuário pode estar bloqueado no iManage.
  • Solução: Tentar realizar o login utilizando o iManage web. Se não for possível autenticar, verifique a partir do Control Center do iManage se o usuário está bloqueado.

4 - Problema: Tela de autenticação do iManage não é apresentada corretamente, quando a rotina de anexos é acessada via WebApp.

• • Motivo: Ambiente não possui lib atualizada e/ou não possui a chave EXTERNALBROWSER=1 configurada no Appserver.ini.
  • Solução: Verifique mais detalhes das configurações da integração nesta documentação.
  • 

5 - Problema: Mensagem de erro JIMNGERROR - Não foi possível realizar a operação.

• • Motivo: Mais de 1 ID de database / library cadastrado no MV_JGEDDAN.

  • Solução: Ajuste apontando apenas 1 biblioteca, normalmente DOCS.

6 - Problema: O usuário do Comprovante de Despesa não está autenticando

• • O problema pode estar atrelado a vários fatores de autenticação, desde bloqueio do usuário até a configuração da integração. 
    • Pensando nisso, o ideal é testar as API's da integração para validar as permissões. Abaixo seguem exemplos de URL's usadas pela integração. 

Autenticação de usuário externo ( /auth/oauth2/token ):

Método: POST
Endpoint: /auth/oauth2/token
Body ( x-www-form-urlencoded ): 

username:{{MV_JUSREXT}}
password:{{MV_JPWDEXT}}
grant_type:password
client_id:{{MV_JIMNGKY}}
client_secret:{{MV_JIMNGSC}}

Para validar as credenciais é necessário que a requisição retorne o "access_token". Ele será usado para autenticar o usuário nas próximas requisições.

7 - Problema: A workspace não está sendo apresentada ao selecionar Importar/Anexar

As funcionalidades de Importar e Anexar utilizam o Cliente/Loja ( configurado no MV_JNRCCLI ) e Caso ( configurado no MV_JNRCCAS ) do registro posicionado para realizar a pesquisa das Workspaces.

A única exceção é a tela de Contratos, que irá filtrar somente o MV_JNRCCLI, pois no contrato é possível ter mais de um caso vinculado.

• • Busca de Workspace ( /api/v2/customers/{{Customer_Id}}/libraries/{{MV_JGEDDAN}}/folders ):

Método: GET
Endpoint: /api/v2/customers/{{Customer_Id}}/libraries/{{MV_JGEDDAN}}/folders?{{MV_JNRCCLI}}={{ClienteLoja_Id}}&limit=9999

Com a api acima é possivel retornar todas workspaces que estão vinculadas ao MV_JNRCCLI selecionado. O limit de 9999 é para exceder o padrão de 25 itens por paginação no endpoint do IManage