Árvore de páginas

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:
ParâmetroDescriçãoConteúdo exemploObservações
MV_JGEDSERDefina o Server GED (Worksite); Esse deve ser o DNS ou IP do server.seuworksite.com.br
MV_JIMNGKYApp key para interacao com IManage.seuappkeyNecessário para realizar o Importar e Download.
MV_JIMNGSCApp secret para interacao com IManage.seuappsecretNecessário para realizar o Importar  e Download.
MV_JGEDDANDefina o nome do Database para documentos em Andamento. seurepositorio
MV_JNRCCLICampo custom para filtrar as pastas por cliente e loja da entidade.custom1Caso o ambiente esteja configurado para utilizar loja automática (MV_JLOJAUT=1), o filtro será realizado somente com código do cliente.
MV_JNRCCASCampo custom para filtrar as pastas por caso da entidade.custom2
MV_JDOCUMEInforme qual é o tipo de integração de anexos. 1-Worksite; 2- Base de Conhecimento; 3 - Fluig; 4- IManage;4
MV_JUSREXTLogin do Imanage - Usuário externousuarioNecessário para funcionalidade de Relatório de comprovantes de despesas.
MV_JPWDEXTSenha do Imanage - Usuário externosenhaNecessário para funcionalidade de Relatório de comprovantes de despesas.
MV_JIMNGTPTipo de autenticação no iManage (client Type)11=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.

Exemplo
[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 .


  • 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

a). Pesquisar casos/assuntos


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



  • 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

TelaDescriçã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

TelaDescrição

Ao clicar no botão Abrir, o sistema irá abrir o navegador na página do iManage 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)

TelaDescriçã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


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 e suas respectivas pastas de acordo com cliente + loja e caso  do registro da entidade posicionada.


Importante!

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



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



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


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.
  • 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 importar. Após a confirmação o sistema irá apresentar no grid o arquivo importado.


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


Importante!

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


06. Anexar documento

TelaDescrição

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

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.



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

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


TelaDescrição

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. 

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

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


TelaDescrição

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. 


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


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.

(aviso) 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.
TelaDescrição

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.

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

TelaDescriçã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

TelaDescriçã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

TelaDescrição

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.

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.

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