BI Funções de Integração com CIGAM: mudanças entre as edições

De CIGAM WIKI
Sem resumo de edição
Sem resumo de edição
 
(18 revisões intermediárias por 3 usuários não estão sendo mostradas)
Linha 1: Linha 1:
<P align="justify">O BI possui funcionalidades de integração entre telas CIGAM, facilitando a demonstração de Dashboards e acesso a documentos presentes nos dshboards criados.
[[BI]] > [[BI Dashboards|BI Dashboards]] > [[BI Funções de Integração com CIGAM | BI Funções de Integração com CIGAM]]
 
[[Arquivo:Config.png|center|semmoldura|750px|Config]]
 
<P align="justify">O BI possui funcionalidades de integração entre telas CIGAM, facilitando a demonstração de Dashboards e acesso a documentos presentes nos dashboards criados.
<br>
'''''<P align="justify">Para entender como cadastrar os programas, acesse: [[BI_Menu #Programas_CIGAM|Programas CIGAM]]'''''
<P align="justify">De forma rápida, pode se ter um detalhamento mais completo de alguns cadastros através de um simples atalho para abertura de um painel ou até mesmo abrir um programa CIGAM, de um documento específico (Nota Fiscal, Ordem de Produção, Ordem de Compra, etc), posicionado em um objeto do tipo “Grid” que estiver devidamente configurado dentro desta visão de dados BI.
<P align="justify">De forma rápida, pode se ter um detalhamento mais completo de alguns cadastros através de um simples atalho para abertura de um painel ou até mesmo abrir um programa CIGAM, de um documento específico (Nota Fiscal, Ordem de Produção, Ordem de Compra, etc), posicionado em um objeto do tipo “Grid” que estiver devidamente configurado dentro desta visão de dados BI.
<P align="justify">Abaixo destacamos alguns formatos de integração:
<P align="justify">Abaixo destacamos alguns formatos de integração:
<br>
<br>
<br>'''1- Acesso de dashboard via menu CIGAM'''
==Acesso de dashboard via menu CIGAM==
<P align="justify">É possível, através de nova opção de menu, adicionar atalho para abertura de dashboard BI. Sendo necessário que a versão de acesso Web do BI esteja devidamente configurado e parametrizado no CIGAM.
<P align="justify">É possível acessar os dashboards disponíveis no ambiente através dos menus do CIGAM, sendo necessário que a versão de acesso Web do BI esteja devidamente configurado e parametrizado no CIGAM.(configurações '''100267 e 100325''' - com url do BI). de duas maneiras:
<br>Abaixo destaca-se os campos para preenchimento:  
#Através do cadastro de uma nova opção de menu; ou
#Dashboards cadastrados no arquivo de apoio geral do CIGAM (para CIGAM com versão 241007 Beta ou superior).
===Cadastro de uma nova opção de menu CIGAM===
<P align="justify">Abaixo destaca-se os campos para preenchimento:  
* Abrir "Nova opção de Menu"
* Abrir "Nova opção de Menu"
[[Arquivo:Int3.png|center|semmoldura|750px|Int3]]
[[Arquivo:Int3.png|center|semmoldura|750px|Int3]]
*Parametrização da Opção de Menu:  
*Parametrização da Opção de Menu:  
<br>Deverá ser informado principalmente a “Descrição” e “URL”.  
<br>Deverá ser informado principalmente a “Descrição” e “URL” ou "ID".  
[[Arquivo:Int4.png|center|semmoldura|750px|Int4]]
[[Arquivo:URL_ID.png|center|semmoldura|750px|URL_ID]]
<br>Para extrair a URL para acesso, será necessário o acesso web ao BI, ao painel desejado, e ir até opção em destaque abaixo para copiar o conteúdo a ser inserido neste campo:  
<br>'''Para extrair a URL para acesso, será necessário o acesso web ao BI''', ao painel desejado, e ir até opção em destaque abaixo para copiar o conteúdo a ser inserido neste campo:  
[[Arquivo:Int5.png|center|semmoldura|750px|Int5]]
[[Arquivo:Int5.png|center|semmoldura|750px|Int5]]
<br>
<br>
Linha 17: Linha 26:
<br> Ao "Confirmar" será copiado para área de transferência:
<br> Ao "Confirmar" será copiado para área de transferência:
[[Arquivo:Int7.png|center|semmoldura|750px|Int7]]
[[Arquivo:Int7.png|center|semmoldura|750px|Int7]]
<br>'''2- Filtros de tela CIGAM para painel BI'''
<P align="justify">Para captura do ID do dashboard, é necessário abrir o painel em modo "edição" pelo desktop. Na aba "dashboard" do rodapé, está disponível o campo com o código único do dashboard.
<P align="justify">É possível configurar uma passagem de filtro de telas CIGAM para o dashboard BI.
[[Arquivo:ID_URL.png|center|semmoldura|750px|ID_URL]]
<P align="justify">'''IMPORTANTE:''' Quando cadastrado por ID, é necessário que o cliente possua o token e a API parametrizados, de outro modo o dashboard não abrirá.
<P align="justify">O dashboard ficará disponível para acesso no caminho onde o novo menu foi cadastrado, no exemplo abaixo em Finanças > Gestão Financeira > Relatórios Operacionais:
[[Arquivo:BI_integ2.png|center|semmoldura|750px|BI_integ2]]
<P align="justify">E também, nos favoritos, na pasta selecionada, neste exemplo: Relatório BI
[[Arquivo:BI_integ.png|center|semmoldura|750px|BI_integ]]
===Dashboards cadastrados via arquivo de apoio===
<P align="justify"> Os principais dashboards de cada módulo que fazem parte da base padrão do BI, passaram a fazer parte também do menu CIGAM através do cadastro no arquivo de apoio.
<P align="justify"> Cada módulo agora possui um novo menu abaixo do menu "Parâmetros", chamado: ''' BI - Dashboards'''. Nele estão os principais dashboards utilizados.
[[Arquivo:BI_menu.png|center|semmoldura|750px|BI_menu]]
<br>
<P align="justify"> Para a abertura destes dashboards é necessário que o cliente possua os modelos instalados, de outro modo será apresentado a seguinte mensagem:
[[Arquivo:BI_menu1.png.jpg|center|semmoldura|750px|BI_menu1]]
<P align="justify"> Ainda, é necessário solicitar junto à equipe de Infraestrutura a parametrização do TOKEN CIGAM, pois sem ele os dashboards não serão abertos e acusará a mensagem abaixo:
[[Arquivo:BI_menu2.png.jpg.png|center|semmoldura|750px|BI_menu2]].
<P align="justify">'''IMPORTANTE''': Os dashboards ficarão disponíveis no menu CIGAM, mas o seu acesso está condicionado aos direitos adicionados no BI.
==Modelos Vinculados==
<P align="justify">Através do cadastro de modelos vinculados é possível configurar a abertura de um dashboard a partir de um programa CIGAM, passando parâmetros específicos da tela CIGAM para o dashboard BI.
<P align="justify">Exemplo: Através da tela de cadastro de materiais, abrir o painel da Disponibilidade de Estoque trazendo as informações do material que está aberto na tela do CIGAM.
<br>Veja abaixo como configurar:
<br>Veja abaixo como configurar:
*Acesse o dashboard e vá na Guia "Dashboard", opção "Filtro"
*Acesse o dashboard e vá na Guia "Dashboard", opção "Filtro"
Linha 33: Linha 60:
[[Arquivo:Int12.png|center|semmoldura|750px|Int12]]
[[Arquivo:Int12.png|center|semmoldura|750px|Int12]]
<br>
<br>
Pronto, agora é só acessar o item criado, onde irá passar o filtro da tela que estará atras do "Menu Extratores de Dados"
Pronto, agora sempre que estiver na tela de um material especifico, indo em modelos vinculados e selecionando o modelo salvo, ele irá trazer as informações do material cadastrado no dashboard.
[[Arquivo:Int13.png|center|semmoldura|750px|Int13]]
[[Arquivo:Int13.png|center|semmoldura|750px|Int13]]
<br>
<br>
<br>'''3- Chamada de programas CIGAM dentro de dashboard BI'''
==Modelos Vinculados (Menu Extrator)==
<br>Dentro do dashboard, através da guia “Item”, a ferramenta possibilita adicionar um atalho por botão para programas CIGAM.
<P align="justify">No BI é possível vincularmos um painel a tela do CIGAM por meio do extrator, abrindo o mesmo sendo filtrado pelos dados em tela.
<br>Este atalho configurado, somente funcionará, quando utilizado o dashboard chamando em alguns dos formatos apresentados, dentro do CIGAM.
<P align="justify">Abra a tela desejada e, em seguida, clique no botão “BI” no canto superior direito.
[[Arquivo:Int2.png|center|semmoldura|750px|Int2]]
[[Arquivo:extsimpBI.png|center|semmoldura|750px|extsimpBI]]
<br>Para que seja aberto um documento específico, posicionado em um “Grid”, precisamos passar alguns parâmetros para o programa CIGAM entender e fazer a localização deste item na base de dados.
<P align="justify">Abrira a tela “extratores e BI”, clique no botão “exibir todos” ao fim da tela que nos redirecionara para o menu do extrator porem na pasta Modelos Vinculados.
<br>Observe que existe uma opção “Parâmetros” onde podemos configurar este envio de informações de forma “fixa” ou “dinâmica”, conforme dados inseridos no “Grid”.
[[Arquivo:extsimpBI2.png|center|semmoldura|750px|extsimpBI2]]
[[Arquivo:Int1.png|center|semmoldura|750px|Int1]]
<P align="justify">A seguir clique em “criar dashboard” no canto superior esquerdo.
[[Arquivo:extsimpBI3.png|center|semmoldura|750px|extsimpBI3]]
<P align="justify">Em seguida clique na lupa para pesquisar o dashboard que deseja vincular.
[[Arquivo:extsimpBI4.png|center|semmoldura|750px|extsimpBI4]]
<P align="justify">Após selecionar o dashboard aparecerá os parâmetros daquele dashboard logo abaixo, é necessário preencher o iniciar e, se necessário, o final para que o dashboard filtre, caso não sejam preenchidos o painel ira abrir sem nenhum filtro. Clicando nos três pontos do campo inicial é possível abrir a tela de parâmetros vendo o nome, origem, coluna da tabela e o conteúdo.
[[Arquivo:extsimpBI5.png|center|semmoldura|750px|extsimpBI5]]
[[Arquivo:extsimpBI6.png|center|semmoldura|750px|extsimpBI6]]
<P align="justify">Após preencher os parâmetros desejados o dashboard está vinculado a tela do CIGAM e, para abri-lo basta voltar para a tela selecionada e, novamente clicar no botão BI para abrir o extrator porém abrindo o dashboard que foi criado dando um clique no mesmo.
[[Arquivo:extsimpBI7.png|center|semmoldura|750px|extsimpBI7]]
<P align="justify">Abrindo, o dashboard é filtrado pelos parâmetros passados anteriormente.
[[Arquivo:extsimpBI8.png|center|semmoldura|750px|extsimpBI8]]
<br>
==Integração com Portais==
<P align="justify">Alguns dashboards já possuem integração com os Portais CIGAM (Portal Financeiro e Portal Compras).
<P align="justify">Para habilitar o acesso a estes dashboards pelos portais alguns parâmetros são necessários:
<P align="justify">1. As configurações '''100267 e 100325''' no CIGAM devem estar preenchidas com a url do BI Web.
<P align="justify">2. Nas configurações do BI é necessário informar o endereço da API
[[Arquivo:Portalbi2.png|center|semmoldura|750px|Portalbi2]]
<P align="justify">3. O dashboard precisa estar marcado "Permite visualizar em modo público" e a opção "Tipo de integração web como 'liberado'".
[[Arquivo:Portalbi.png|center|semmoldura|750px|Portalbi]]
<P align="justify">4. As licenças dos usuários devem ser do tipo "visualizador" ou 'desenvolvedor".
<br>
<br>
Abaixo listamos alguns padrões de chamada, que podem ser utilizados na configuração deste atalho:
==Abrir dashboard na inicialização do CIGAM==
{| class="wikitable"
<P align="justify">É possível adicionar um dashboard específico por usuário para que ao acessar o CIGAM, no momento da inicialização ele seja aberto. Para isso é necessário preencher a configuração 3194 com a URL do dashboard específico.
|-
[[Arquivo:Inic_BI.png|center|semmoldura|750px|Inic_BI]]
! '''Programa''' !! '''Componente''' !! '''Nome Público''' !! '''Ordem''' !! '''Tipo de Parâmetro''' !! '''Tipo Dado''' !! '''Valor ou Filtro''' !! '''Obrigatório'''
[[Arquivo:Inic_BI2.png|center|semmoldura|750px|Inic_BI2]]
|-
[[Arquivo:Inic_BI3.png|center|semmoldura|750px|Inic_BI3]]
| Ordem de Compra || %CIGAM_INSTAL%Cab\Geral\CGGeral.ecf  || CG00844  || 1 || Filtro || Texto || Enviar o Número da OC  || Sim
[[Arquivo:Inic_BI4.png|center|semmoldura|750px|Inic_BI4]]
|-
==LINK ADICIONAL==
| Pedido || %CIGAM_INSTAL%Cab\Geral\CGGeral.ecf  || CG00449  || 1 || Filtro || Texto || Enviar o Número do Pedido || Sim
*[[Integração com CIA – BI CIGAM]]
|-
| Consulta de Estoque  || %CIGAM_INSTAL%Cab\Geral\CGGeral.ecf  || CG00374  || 1 || Filtro || Texto || Enviar o Código do Material || Sim
|-
| Ordem Produção || %CIGAM_INSTAL%Cab\Geral\CGGeral.ecf  || CG06353 || 1  || Filtro || Numérico || Enviar o número da OP || Sim
|-
| NF de Entrada || %CIGAM_INSTAL%Cab\Geral\CGGeral.ecf || CG00843 || 1  || Valor || Lógico || Enviar FALSE || Sim
|-
|  ||  ||  || 2  || Valor || Lógico || Enviar FALSE || Sim
|-
|  ||  ||  || 3  || Filtro || Texto || Enviar Código do Fornecedor || Sim
|-
|  ||  ||  || 4  || Filtro || Numérico || Enviar NF || Sim
|-
|  ||  ||  || 5  || Filtro || Texto || Enviar Série NF || Sim
|-
|  ||  ||  || 6  || Filtro || Texto || Enviar Unidade de Negócio || Sim
|-
|  ||  ||  || 14  || Valor || Texto || Enviar TRUE || Sim
|-
| Contábil - Manutenção de Lançamento || %CIGAM_INSTAL%Cab\Contabil\Contabil.ecf || CC00199 || 1  || Filtro || Numérico || Enviar Número do Lcto. Contábil || Sim
|-
|  ||  || CC00199 || 2  || Filtro || Data || Enviar Data do Lcto. Contábil || Sim
|-
| Movimento de Estoque || %CIGAM_INSTAL%Cab\Geral\CGGeral.ecf || CG00343 || 1  || Filtro || Numérico || Enviar Número do Movimento || Sim
|-
| Lançamentos || %CIGAM_INSTAL%Cab\Geral\CGGeral.ecf  || CG00003  || 1 || Filtro || Numérico || Enviar o Número do Lançamento  || Sim
|}

Edição atual tal como às 12h45min de 2 de julho de 2026

BI > BI Dashboards > BI Funções de Integração com CIGAM

Config
Config

O BI possui funcionalidades de integração entre telas CIGAM, facilitando a demonstração de Dashboards e acesso a documentos presentes nos dashboards criados.

Para entender como cadastrar os programas, acesse: Programas CIGAM

De forma rápida, pode se ter um detalhamento mais completo de alguns cadastros através de um simples atalho para abertura de um painel ou até mesmo abrir um programa CIGAM, de um documento específico (Nota Fiscal, Ordem de Produção, Ordem de Compra, etc), posicionado em um objeto do tipo “Grid” que estiver devidamente configurado dentro desta visão de dados BI.

Abaixo destacamos alguns formatos de integração:

Acesso de dashboard via menu CIGAM

É possível acessar os dashboards disponíveis no ambiente através dos menus do CIGAM, sendo necessário que a versão de acesso Web do BI esteja devidamente configurado e parametrizado no CIGAM.(configurações 100267 e 100325 - com url do BI). de duas maneiras:

  1. Através do cadastro de uma nova opção de menu; ou
  2. Dashboards cadastrados no arquivo de apoio geral do CIGAM (para CIGAM com versão 241007 Beta ou superior).

Cadastro de uma nova opção de menu CIGAM

Abaixo destaca-se os campos para preenchimento:

  • Abrir "Nova opção de Menu"
Int3
Int3
  • Parametrização da Opção de Menu:


Deverá ser informado principalmente a “Descrição” e “URL” ou "ID".

URL_ID
URL_ID


Para extrair a URL para acesso, será necessário o acesso web ao BI, ao painel desejado, e ir até opção em destaque abaixo para copiar o conteúdo a ser inserido neste campo:

Int5
Int5


Int6
Int6


Ao "Confirmar" será copiado para área de transferência:

Int7
Int7

Para captura do ID do dashboard, é necessário abrir o painel em modo "edição" pelo desktop. Na aba "dashboard" do rodapé, está disponível o campo com o código único do dashboard.

ID_URL
ID_URL

IMPORTANTE: Quando cadastrado por ID, é necessário que o cliente possua o token e a API parametrizados, de outro modo o dashboard não abrirá.

O dashboard ficará disponível para acesso no caminho onde o novo menu foi cadastrado, no exemplo abaixo em Finanças > Gestão Financeira > Relatórios Operacionais:

BI_integ2
BI_integ2

E também, nos favoritos, na pasta selecionada, neste exemplo: Relatório BI

BI_integ
BI_integ

Dashboards cadastrados via arquivo de apoio

Os principais dashboards de cada módulo que fazem parte da base padrão do BI, passaram a fazer parte também do menu CIGAM através do cadastro no arquivo de apoio.

Cada módulo agora possui um novo menu abaixo do menu "Parâmetros", chamado: BI - Dashboards. Nele estão os principais dashboards utilizados.

BI_menu
BI_menu


Para a abertura destes dashboards é necessário que o cliente possua os modelos instalados, de outro modo será apresentado a seguinte mensagem:

BI_menu1
BI_menu1

Ainda, é necessário solicitar junto à equipe de Infraestrutura a parametrização do TOKEN CIGAM, pois sem ele os dashboards não serão abertos e acusará a mensagem abaixo:

BI_menu2
BI_menu2

.

IMPORTANTE: Os dashboards ficarão disponíveis no menu CIGAM, mas o seu acesso está condicionado aos direitos adicionados no BI.

Modelos Vinculados

Através do cadastro de modelos vinculados é possível configurar a abertura de um dashboard a partir de um programa CIGAM, passando parâmetros específicos da tela CIGAM para o dashboard BI.

Exemplo: Através da tela de cadastro de materiais, abrir o painel da Disponibilidade de Estoque trazendo as informações do material que está aberto na tela do CIGAM.
Veja abaixo como configurar:

  • Acesse o dashboard e vá na Guia "Dashboard", opção "Filtro"
Int8
Int8


Observar os itens em destaque na imagem.
Na opção “Tipo de Filtro”, informe “Múltipla Seleção”.

Int9
Int9


Crie novo item de DashBoard:

Int10
Int10


Escolha o dashboard desejado e passe valor aos parâmetros, pelo campo "Inicial"

Int11
Int11


Escolha o item que melhor representa o filtro que será submetido

Int12
Int12


Pronto, agora sempre que estiver na tela de um material especifico, indo em modelos vinculados e selecionando o modelo salvo, ele irá trazer as informações do material cadastrado no dashboard.

Int13
Int13


Modelos Vinculados (Menu Extrator)

No BI é possível vincularmos um painel a tela do CIGAM por meio do extrator, abrindo o mesmo sendo filtrado pelos dados em tela.

Abra a tela desejada e, em seguida, clique no botão “BI” no canto superior direito.

extsimpBI
extsimpBI

Abrira a tela “extratores e BI”, clique no botão “exibir todos” ao fim da tela que nos redirecionara para o menu do extrator porem na pasta Modelos Vinculados.

extsimpBI2
extsimpBI2

A seguir clique em “criar dashboard” no canto superior esquerdo.

extsimpBI3
extsimpBI3

Em seguida clique na lupa para pesquisar o dashboard que deseja vincular.

extsimpBI4
extsimpBI4

Após selecionar o dashboard aparecerá os parâmetros daquele dashboard logo abaixo, é necessário preencher o iniciar e, se necessário, o final para que o dashboard filtre, caso não sejam preenchidos o painel ira abrir sem nenhum filtro. Clicando nos três pontos do campo inicial é possível abrir a tela de parâmetros vendo o nome, origem, coluna da tabela e o conteúdo.

extsimpBI5
extsimpBI5
extsimpBI6
extsimpBI6

Após preencher os parâmetros desejados o dashboard está vinculado a tela do CIGAM e, para abri-lo basta voltar para a tela selecionada e, novamente clicar no botão BI para abrir o extrator porém abrindo o dashboard que foi criado dando um clique no mesmo.

extsimpBI7
extsimpBI7

Abrindo, o dashboard é filtrado pelos parâmetros passados anteriormente.

extsimpBI8
extsimpBI8


Integração com Portais

Alguns dashboards já possuem integração com os Portais CIGAM (Portal Financeiro e Portal Compras).

Para habilitar o acesso a estes dashboards pelos portais alguns parâmetros são necessários:

1. As configurações 100267 e 100325 no CIGAM devem estar preenchidas com a url do BI Web.

2. Nas configurações do BI é necessário informar o endereço da API

Portalbi2
Portalbi2

3. O dashboard precisa estar marcado "Permite visualizar em modo público" e a opção "Tipo de integração web como 'liberado'".

Portalbi
Portalbi

4. As licenças dos usuários devem ser do tipo "visualizador" ou 'desenvolvedor".

Abrir dashboard na inicialização do CIGAM

É possível adicionar um dashboard específico por usuário para que ao acessar o CIGAM, no momento da inicialização ele seja aberto. Para isso é necessário preencher a configuração 3194 com a URL do dashboard específico.

Inic_BI
Inic_BI
Inic_BI2
Inic_BI2
Inic_BI3
Inic_BI3
Inic_BI4
Inic_BI4