Árvore de páginas


CONTEÚDO

  1. Visão Geral
  2. Configurações
  3. Autenticação
  4. Abrir documento
  5. Importar documento (Upload)
  6. Anexar documento
  7. Download de documentos
  8. Excluir
  9. Subpastas
  10. Tabelas utilizadas
  11. 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á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.


  • 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


  • Configurações do iManage web:
    • É necessário configurar usuários que possuam acesso ao iManage Worksite web.
    • Necessário utilizar configuração de autenticação do app Protheus, com o Client type como Public (pública).


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


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


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;


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

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

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ível erro conhecido que pode ocorrer após a implementação desta funcionalidade:

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