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
Anexar Importar documento (Upload)
Anexar documento
1. Pesquisar documentos ou e-mails
  1. Pesquisa por nome
  2. Pesquisa por número
2. Pesquisar casos/assuntos
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 Anexar Importar e Download.
MV_JIMNGSC	App secret para interacao com IManage.	seuappsecret	Necessário para realizar o Anexar 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
Image Modified	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.

O usuário deverá

...

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

Image Added

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.Image Removed

Ao clicar no botão Anexar Importar, o sistema irá solicitar ao usuário que realize o login.

Informações
Devem ser utilizados os mesmo dados de login para o acesso via browser.

, caso ainda não tenha realizado.

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

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

Image Modified

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

anexar

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

a pasta

os Assuntos e suas respectivas pastas de acordo com cliente + loja e

caso

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).

Image Added

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).

Image AddedImage Removed

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.

Informações

title	Importante!

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

Obs:

O campo de loja será apresentado quando o parametro de loja automática (MV_JLOJAUT) possuir o conteúdo 1.
Os parâmetros MV_JNRCCLI e MV_JNRCCAS precisam estar configurados com os campos custom de busca do iManage. Verifique a sessão de configurações.

Após digitar os valores, o usuário deverá clicar no botão Pesquisar caso/assunto. O sistema irá apresentar os assuntos de acordo com o filtro aplicado.

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

anexar

importar. Após a confirmação o sistema irá apresentar no grid o arquivo

anexado

importado.

Só é possível

anexar

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 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;
  - E-mails 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

Filtros

São disponibilizados os seguintes tipos de filtros:

A - Pesquisar documento: Permite pesquisar por nome ou número (id) de documentos ou e-mails.
B - Pesquisar caso/assunto: Permite pesquisar um assunto que esta cadastrado no iManage, para que o usuário possa acessar seus respectivos documentos e/ou e-mails.

Image Added

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

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.

Tela

Descrição

Image Added

Para pesquisa pelo nome do documento / e-mail, basta digitar o termo que esteja contido no nome do documento / e-mail 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

a). 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.

Tela

Descrição

Image Added

Se o usuário está acessando alguma rotina do Financeiro por exemplo, o sistema apresentará os campos de Cliente, Loja (caso possua) e Caso para que o usuário busque itens.

Informações

title	Importante!

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

O campo de loja será apresentado quando o parâmetro de loja automática (MV_JLOJAUT) possuir o conteúdo 1.
Os parâmetros MV_JNRCCLI e MV_JNRCCAS precisam estar configurados com os campos custom de busca do iManage. Verifique a sessão de configurações.

Após digitar os valores, o usuário deverá clicar no botão Pesquisar caso/assunto. O sistema irá apresentar os assuntos de acordo com o filtro aplicado.

Além disso, serão apresentados os grupos:

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,do usuário logado, apresentados os itens:
Categorias;
Assuntos favoritos;
Pastas favoritas;
Documentos favoritos
E-mails 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).

07

...

. Download de documentos

Tela

Descrição

Image RemovedImage Added

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

Image Added

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.

06. TABELAS UTILIZADAS

.

08. Excluir

Tela

Descrição

Image Added

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.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 17

Nova versão 62

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 ou e-mails

i). Pesquisa por nome

ii).

Pesquisa por número

a). Pesquisar casos/assuntos

07

. Download de documentos

06. TABELAS UTILIZADAS

08. Excluir

09. Subpastas

10. Tabelas utilizadas

11. FAQ