Histórico da Página

CONTEÚDO

Visão Geral
Configurações
1. Configurações no servidor Protheus
2. Configuração para Protheus com web App
3. Configurações do iManage web - (Control Center)
Autenticação
Abrir documento
Importar documento (Upload)
Anexar documento
1. Pesquisar documentos
  1. Pesquisa por nome
  2. Pesquisa por número
Download de documentos
Excluir
Subpastas
Tabelas utilizadas
FAQ

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ário necessária a utilização da dll.

02. Configurações

Para utilizar a funcionalidade é necessário realizar a configuração dos seguintes parâmetrosas configurações a seguir:

Parâmetros no Protheus:

Parâmetro	Descrição	Conteúdo exemplo	Observações
MV_JGEDSER	Defina o Server GED (Worksite); Esse deve ser o DNS ou IP do server.	seuworksite.com.br
MV_JIMNGKY	App key para interacao com IManage.	seuappkey	Necessário para realizar o Importar e Download.
MV_JIMNGSC	App secret para interacao com IManage.	seuappsecret	Necessário para realizar o Importar e Download.
MV_JGEDDAN	Defina o nome do Database para documentos em Andamento.	seurepositorio
MV_JNRCCLI	Campo custom para filtrar as pastas por cliente e loja da entidade.	custom1	Caso o ambiente esteja configurado para utilizar loja automática (MV_JLOJAUT=1), o filtro será realizado somente com código do cliente.
MV_JNRCCAS	Campo custom para filtrar as pastas por caso da entidade.	custom2
MV_JDOCUME	Informe qual é o tipo de integração de anexos. 1-Worksite; 2- Base de Conhecimento; 3 - Fluig; 4- IManage;	4
MV_JUSREXT	Login do Imanage - Usuário externo	usuario	Necessário para funcionalidade de Relatório de comprovantes de despesas.
MV_JPWDEXT	Senha do Imanage - Usuário externo	senha	Necessário para funcionalidade de Relatório de comprovantes de despesas.

...

MV_JIMNGTP	Tipo de autenticação no iManage (client Type)	1	1=Pública / 2=Confidencial

a). Configurações no servidor Protheus:

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

...

.

Bloco de código

language	delphi
theme	RDark
firstline	1
title	Exemplo
linenumbers	true
collapse	true

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

b). Configuração para Protheus com web App

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.

c). Configurações do 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

...

Expandir

title	Exemplo de client type

Image Added

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

Expandir

title	Exemplo de configuração de campos custom

Image Added

Configuração (sugestão) 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

Tela

Descrição

A tela de autenticação é solicitada para as operações Importar, Anexar e Download. Os dados de autenticação serão solicitados uma vez, para cada vez que o usuário abrir uma determinada rotina, caso o usuário queira Importar, Anexar ou realizar Download de arquivos.

Após preencher os dados de autenticação e realizar o login com sucesso, o usuário deverá clicar no botão Próximo.

...

04. Abrir documento

Tela	Descrição
	Ao clicar no botão Abrir, o sistema irá abrir o navegador na página do iManage worksite Worksite web, previamente configurado, e irá solicitar o login, caso o usuário não esteja logado.
	Em seguida será aberta a tela de preview do documento. Esta tela possibilita ao usuário, além de visualizar, realizar o download do arquivo também.

...

05. Importar documento (Upload)

Tela

Descrição

A operação do Importar, permite que o usuário inclua um documento no iManage, e além disso, realiza o vinculo do documento com o registro posicionado.

Ao clicar no botão Importar, o sistema irá solicitar ao usuário que realize o login, caso ainda não tenha realizado.

O usuário precisará preencher os dados de autenticação ao acessar uma determinada rotina, na tela de anexos.

Após realizar o login, é necessário clicar no botão Próximo.

Caso o usuário digite os dados de autenticação incorretos, o sistema irá apresentar uma mensagem de validação destas informações

Image RemovedImage Added

O usuário precisará selecionar a pasta, que deseja importar o arquivo.

Caso o usuário esteja acessando alguma rotina do Jurídico Departamentos (SIGAJURI) ou a rotina de Despesas, o sistema irá filtrar automaticamente os

assuntos

Assuntos e suas respectivas pastas de acordo com cliente + loja e caso do registro da entidade posicionada.

Informações

title	Importante!

O sistema considera o parâmetro MV_JLOJAUT para realizar a busca das pastas.

Image Added

Para acessar as pastas do Assunto, basta clicar 2 vezes com o mouse. Será apresentada uma seta ao lado esquerdo, indicando que este item possui itens filhos (subpastas).

Para cada item da tela é possível utilizar o comando duplo clique do mouse, e desta forma o sistema irá apresentar os subitens (subpastas) caso da entidade posicionada.

Além disso, será apresentado o grupo Meus favoritos,do usuário logado, apresentados os itens:

Categorias;
Assuntos favoritos;
Pastas favoritas;

Para cada item da tela é possível utilizar o comando duplo clique do mouse, e desta forma o sistema irá apresentar os subitens (subpastas).

Se o usuário está acessando alguma rotina do

financeiro

Financeiro por exemplo (diferente das rotinas do SIGAJURI ou da rotina de Despesas), o sistema apresentará os campos de Cliente, Loja (caso possua) e Caso para que o usuário busque em qual pasta irá armazenar o arquivo.

Obs:

Informações

title	Importante!

O sistema considera o parâmetro MV_JLOJAUT para realizar a busca das pastas.

O campo de loja será apresentado quando o parametro de loja automática (MV_JLOJAUT) possuir o conteúdo 1.

Após digitar os valores, o usuário deverá clicar no botão Pesquisar.

O sistema irá apresentar os assuntos de acordo com o filtro aplicado

. Além

, para buscar assuntos cadastrados previamente no iManage.

Além disso, será apresentado o grupo Meus favoritos,do usuário logado, apresentados os itens:

Categorias;
Assuntos favoritos;
Pastas favoritas;

Para cada item da tela é possível utilizar o comando duplo clique do mouse, e desta forma o sistema irá apresentar os subitens (subpastas).

Após selecionar a pasta, o usuário poderá selecionar o arquivo que deseja importar. Após a confirmação o sistema irá apresentar no grid o arquivo importado.

Só é possível importar um arquivo por vez.

...

Informações

title	Importante!

Neste operação só é possível selecionar item do tipo pasta.

06. Anexar documento

Tela

Descrição

Image RemovedImage Added

A operação Anexar permite que o usuário selecione um documento que já existe iManage, para realizar o vínculo deste com o registro posicionado. O usuário deverá selecionar o botão Anexar, em seguida deverá selecionar um documento e confirmar a operação.

O sistema apresenta as seguintes opções:

Casos/Assuntos recentes (30 dias) - Assuntos em que houve alguma atividade recente (considerando os últimos 30 dias).
Documentos recentes (30 dias) - Documentos em que houve alguma atividade recente , (considerando os últimos 30 dias).
Meus favoritos - (De acordo com o usuário logado no iManage), sendo os itens apresentados:
- - Categorias de favoritos;
  - Assuntos favoritos;
  - Pastas favoritas;
  - Documentos favoritos;

...

Para cada item da tela é possível utilizar o comando duplo clique do mouse, e desta forma o sistema irá apresentar os subitens (subpastas).

Image Added

Ao utilizar duplo clique em um item do tipo documento, este será anexado ao registro posicionado no Protheus.

a). Pesquisar documentos

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

i). Pesquisa por nome

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

Tela

Descrição

Image Added

Para pesquisa pelo nome do documento, basta digitar o termo que esteja contido no nome do documento e em seguida selecionar o tipo NOME.

Ao clicar no botão Pesquisar documento o sistema irá realizar a busca no iManage.

Image Added

Se forem encontrados itens que correspondam a pesquisa realizada, o sistema irá apresentar o resultado no agrupador Resultado da pesquisa. No agrupador também será apresentada a quantidade de itens encontrados na pesquisa.

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.

Tela

Descrição

Image Added

Para pesquisa pelo número do documento, basta digitar o id do documento e em seguida selecionar o tipo NÚMERO.

Ao clicar no botão Pesquisar documento o sistema irá realizar a busca no iManage.

Image Added

Se forem encontrados itens que correspondam a pesquisa realizada, o sistema irá apresentar o resultado no agrupador Resultado da pesquisa. No agrupador também será apresentada a quantidade de itens encontrados na pesquisa.

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

Image Added

07. Download de documentos

Tela

Descrição

O usuário poderá realizar a baixa de um ou mais documentos. Para isto, basta selecionar o(s) documento(s) e em seguida clicar no botão Download.

Ao clicar no botão Download, o sistema irá solicitar ao usuário que realize o login, caso ainda não tenha realizado.

O usuário precisará preencher os dados de autenticação ao acessar uma determinada rotina, na tela de anexos.

Após realizar o login, é necessário clicar no botão Próximo.

Caso tenham sido selecionados mais um de documentos, estes serão abertos após o download e em sequencia.

...

08. Excluir

Tela

Descrição

A funcionalidade Excluir, permite que o usuário remova o vínculo do documento do iManage com o registro posicionado, porém o documento não será removido do repositório do iManage.

Para isto, selecione o(s) documento(s) e clique no botão Excluir. Em seguida confirme a exclusão.

Obs.: Caso queira remover o arquivo do iManage, esta ação deverá ser realizada após remover o vínculo do documento com o registro, e via iManage web.

...

.

09. Subpastas

Tela	Descrição
Image Added	Para as operações Importar e Anexar, é possível visualizar subpastas e além disso os itens que estão contidos nelas. Para isso, basta que o usuário utilize o duplo clique com o mouse.
Image Added	Quando uma pasta não possuir subpastas, o ícone desta ficará na cor vermelha, ao realizar o duplo clique, indicando que este é o último nível.

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

subindo-o em modo administrador.
.exe, iniciando este em modo administrador.

Expandir

title	Mensagem de erro

Image Added

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.

Expandir

title	Mensagem de erro

Image Added

Árvore de páginas

Versões comparadas

Versão antiga 26

Nova versão 58

Chave

CONTEÚDO

01. Visão geral

02. Configurações

03

. Autenticação

04. Abrir documento

05. Importar documento (Upload)

06. Anexar documento

a). Pesquisar documentos

i). Pesquisa por nome

ii). Pesquisa por número

07. Download de documentos

08. Excluir

09. Subpastas

10. Tabelas utilizadas

11.

FAQ