Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.


CONTEÚDO

  1. Visão Geral
  2. Configurações
    1. Configurações no servidor Protheus
    2. Configuração para Protheus com web App
    3. Configurações do iManage web - (Control Center)
  3. Autenticação
  4. Abrir documento
  5. Anexar Importar documento (Upload)
  6. Anexar documento
    1. Pesquisar documentos ou e-mails
      1. Pesquisa por nome
      2. Pesquisa por número
    2. Pesquisar casos/assuntos
  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 é necessário mais 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âmetroDescriçãoConteúdo exemploObservações
MV_JGEDSERDefina o Server GED (Worksite); Esse deve ser o DNS ou IP do server.meuworksiteseuworksite.com.br
MV_JIMNGKYApp key para interacao com IManage.seuappkeyNecessário para realizar o Anexar Importar e Download.
MV_JIMNGSCApp secret para interacao com IManage.seuappsecretNecessário para realizar o Anexar 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.

Bloco de código
languagedelphi
themeRDark
firstline1
titleExemplo
linenumberstrue
collapsetrue
[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.
Aviso
titleAtenção

A funcionalidade Anexar esta disponível, por enquanto, para todas as rotinas do módulo Jurídico Departamentos (SIGAJURI) e somente para a rotina de Despesas do módulo de Pré-faturamento de serviços.  Em breve esta operação estará disponível para as demais rotinas do módulo.

    •  
    • 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
titleExemplo de client type

Image Added


      • Campos custom (utilizados para filtrar pastas por cliente e caso):
Expandir
titleExemplo de configuração de campos custom

Image Added


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

TelaDescrição

Image Added

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

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, e o folder que deseja anexar o arquivo.

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

Informações

Devem ser utilizados os mesmo dados de login para o acesso via browser.

O usuário precisará preencher os dados de login ao menos uma vez por dia. Após o primeiro login do dia o sistema irá realizar o refresh dos dados de autenticação, até o final do dia.

Aviso
titleAtenção

A funcionalidade Anexar esta disponível, por enquanto, para todas as rotinas do módulo Jurídico Departamentos (SIGAJURI) e somente para a rotina de Despesas do módulo de Pré-faturamento de serviços.  Em breve esta operação estará disponível para as demais rotinas do módulo.

Image Removed

Image Removed

Image Removed

Após selecionar a folder, o usuário poderá selecionar o arquivo que deseja anexar. Após a confirmação o sistema irá apresentar no grid o arquivo anexado.

04. TABELAS UTILIZADAS

 

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





Image Added

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


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


Informações
titleImportante!

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 Added

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.


Informações
titleImportante!

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

Image Added

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
titleImportante!

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


06. Anexar documento

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

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


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

(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

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.

(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

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
titleImportante!

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

Image Added

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.



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.

Image Added

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


08. Excluir

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

TelaDescriçã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
titleMensagem 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
titleMensagem de erro

Image Added

...