Linha Microsiga Protheus

Árvore de páginas

Versões comparadas

Versão antiga 10

changes.mady.by.user Rebeca Facchinato Asuncao

Gravado em

comparado com

Nova versão Atual

changes.mady.by.user Rebeca Facchinato Asuncao

Gravado em

Chave

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


CONTEÚDO

  1. Visão Geral
  2. Configurações
  3. Autenticação
  4. Abrir documento
  5. Anexar 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 é 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:
meuworksite                 Anexar              Anexarmeurepositorio
ParâmetroDescriçãoConteúdo exemploObservações
MV_JGEDSERDefina o Server GED (Worksite); Esse deve ser o DNS ou IP do server                   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


  • 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


  • Configurações do iManage web:
    • É necessário configurar usuários que possuam acesso ao

...

    • iManage Worksite

...

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.

    • web.
    • Para verificar a configuração de autenticação do app Protheus, com o Client type:
Expandir
titleExemplo de client type

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.

Após selecionar a folder anexar
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.

Informações

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


O usuário precisará preencher os dados de login autenticação 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

acessar uma determinada rotina, na tela de anexos. 

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.


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

Image Added

Após selecionar a pasta

Image Removed

Image Removed

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


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

04. TABELAS UTILIZADAS

ao registro posicionado no Protheus.

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

    • Problema: DBSetOrder - Index not found: OAUTH2_CB Order Number: 1 

Image Added

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