Cross Segmentos - Backoffice RM - BI - Passagem de parâmetros em planilha Excel

 Tempo aproximado para leitura: 00:02:00 min

Dúvida
Quais são as formas de passagem de parâmetros na Planilha .Net do tipo Excel?

Ambiente
Cross Segmentos - TOTVS Backoffice (Linha RM) - RM BI - A partir da versão 12.1.20

Solução
Segue abaixo os passos e formas de passagem de parâmetros nas Planilha.Net:

Parâmetros da própria consulta sql:

1. Neste exemplo, na estrutura da Planilha Net, utilizaremos o parâmetro da própria consulta SQL como parâmetro:
   Utilize a consulta SQL abaixo que retornará dados de um funcionário. Desta consulta utilizaremos duas passagens de parâmetros; SECAO e SITUACAO.
   O parâmetro :$CODCOLIGADA  desta consulta, não será considerado no exemplo por se tratar de uma variável dinâmica.
   
2.  Elaborada a consulta SQL acesse a Planilha Net através do menu Gestão;
3. Na parte de Ferramentas de Análise clique em Planilha Net;
4. Selecione/crie uma nova planilha;
5. De um duplo clique para abrir a planilha;
6. Na opção Ações do Documento, selecione uma nova consulta SQL.
   
7. Durante a associação da consulta SQL o sistema solicitará o preenchimento dos valores dos parâmetros para consulta.
   
8. Quando finalizada a associação, teremos nas configurações Ações do Documento no grupo Parâmetros, os parâmetros informados na inclusão da consulta SQL.

Importante
Para alterações dos valores dos filtros, clique duas vezes sobre o valor do parâmetro, na coluna Valor. Feita alteração dos valores tecle Enter para registrar a alteração e recalcular a planilha.

Parâmetros da própria consulta SQL em mais de uma planilha:

1. Quando utilizado no mesmo arquivo de Excel mais de uma planilha com consultas SQL diferentes. caso seja necessário modificar o valor de um dos parâmetros, deverá seguir os seguintes passos:
2. Nas configurações das Ações dos Documento, verifique a consulta SQL que deseja alterar o parâmetro;
3. Selecione a a consulta em questão e clique sobre o Parâmetro;
4. Na parte de Dados Importados, na coluna Planilha é possível identificar de qual das planilhas o parâmetro faz parte;
5. Feita a identificação e seleção correta do parâmetro, clique duas vezes sobre seu Valor e digite o novo.
6. Para confirmar as alterações e recalcular a planilha tecla Enter.

 No exemplo abaixo demonstramos as configurações Ações do Documento de um arquivo que possui duas planilhas e em cada planilha uma consulta SQL diferente.

Plan1	Plan2

Parâmetros utilizando células da planilha:

1. Para uso deste método iremos criamos uma consulta SQL com três parâmetros: CHAPA, DTINI e DTFIM.
   

1. Na opção Ações do Documento, selecione a nova consulta SQL criada;
2. Durante a associação da consulta SQL o sistema solicitará o preenchimento dos valores dos parâmetros para a consulta, informe qual a célula da planilha passará os valores do(s) parâmetro(s) para consulta SQL.
   
3. O comando deve ser constituído pelo nome da guia da planilha + nome da célula separado pelo ponto de exclamação. Exemplo: PLAN1!A1;
   Acesse o grupo Parâmetros para visualizar a configuração.
           

Parâmetro utilizando células em várias planilhas:

1. Quando utilizamos mais de uma planilha no arquivo de Excel com mais de uma consulta SQL, devemos nos atentar para definição de qual célula é responsável por repassar o valor de parâmetro para consulta SQL.
2. Selecione a a consulta em questão e clique sobre o Parâmetro;
3. No campo Valor verifique em qual célula e de qual planilha o parâmetro está localizado; 
4. Na parte de Dados Importados, na coluna Planilha é possível identificar de qual das planilhas o parâmetro faz parte;
5. Feita a identificação e seleção correta do parâmetro, clique duas vezes sobre seu Valor e digite o novo.
   Abaixo exemplo destas opções, a primeira consulta está associada a plan1 e a segunda associada a plan2.

Plan1	Plan2

 

Saiba mais
Acesse nosso TDN para mais informações sobre a Passagem de Parâmetros e RM - Frame - Variáveis Dinâmicas.