Versões comparadas

Chave

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

Índice:


       

Índice
exclude.*ndice:

 

Objetivo:


       O objetivo deste documento é demonstrar como utilizar parâmetros nas Consultas SQL para a Planilha RM, de forma que será definida na consulta, em qual célula da planilha, o valor do parâmetro deve ser consultado. 

Introdução:


          A Planilha RM permite que sejam criadas Consultas SQL que definam as células da planilha que serão associadas aos parâmetros da consulta. Dessa forma, não é preciso criar várias Consultas SQL com parâmetros diferentes. Neste documento estão descritos os passos para sua criação.

      Exemplo de Consulta SQL a ser utilizada na Planilha RM

         Foi criada a Consulta SQL abaixo, no menu 'Gestão | Visões de Dados' como exemplo. Veja:

Essa consulta retornará dados de Funcionários cujo salário seja maior do que o valor informado na célula 'A1', página 'Sheet1', da planilha onde a consulta for associada.

Atualmente, a planilha suporta os seguintes padrões de parâmetros, que podem ser utilizados na consulta:

  1. :PLN_<nome da página>$<coluna>#_<tipo> – Nesse formato, informe o nome da página da planilha e a coluna para qual deseja fazer referência. O símbolo # representa a linha. Por exemplo, :PLN_SHEET1_$A#_S, indica que o valor do parâmetro está na página “SHEET1”, na coluna “A”, na mesma linha da célula que a consulta está vinculada e que o tipo de dado é String.
  2. :PLN_$<coluna>#_<tipo> – Nesse formato, informe a coluna para qual deseja fazer referência. O símbolo # representa a linha. Por exemplo, :PLN_$AB#_S, indica que o valor do parâmetro está na coluna “AB”, na mesma linha e página da célula que a consulta está vinculada, e que o tipo de dado é String.
  3. :PLN_<nome da página>#$<linha>_<tipo> – Nesse formato, informe o nome da página da planilha e a linha para qual deseja fazer referência. O símbolo # representa a coluna. Por exemplo, :PLN_SHEET1_#$5_S, indica que o valor do parâmetro está na página “SHEET1”, na linha “5”, na mesma coluna da célula que a consulta está vinculada e que o tipo de dado é String.
  4. :PLN_#$<linha>_<tipo> – Nesse formato, informe o nome da página da planilha e a linha para qual deseja fazer referência. O símbolo # representa a coluna. Por exemplo, :PLN_#$12_S, indica que o valor do parâmetro está na linha “12”, na mesma coluna e página da célula que a consulta está vinculada, e que o tipo de dado é String.

 

Informações
titleInformações

O tipo de dado pode ser omitido. Para isso, basta remover do parâmetro a parte _<tipo>. Exemplo :PLN_<nome da página>$<coluna>#.

O padrão antigo (:PLN_<nome da página>$<coluna>$<linha>_<tipo>) continua sendo suportado.

Exemplo:


           Seguindo os passos abaixo, será possível criar uma Planilha RM com parâmetros da Consulta SQL.

Informações
iconfalse
Deck of Cards
idExemplo
Card
idPasso 1
labelPasso 1

Crie a Consulta SQL desejada, que utilize o parâmetro da Planilha.

Para realizar o cadastro, acesse o menu 'Gestão | Visões de Dados' e clique no botão Incluir (Ctrl + Ins). Veja a imagem a seguir:

Image Modified

Neste exemplo, essa consulta retornará dados de Funcionários cujo salário seja maior do que o valor informado na célula 'A1', página 'Sheet1', da planilha onde a consulta for associada.

Card
idPasso 2
labelPasso 2

Após a criação da Consulta SQL no sistema, vamos criar a planilha RM.

Acesse o menu 'Gestão > Planilha Net' e clique no botão Incluir (Ctrl + Ins). Em seguida, preencha os campos como ilustrado na imagem abaixo: 

Image Modified

Card
idPasso 3
labelPasso 3

Após criar a planilha, clique duas vezes sobre ela e será apresentada a sua tela de edição.

Agora, vamos associar a sentença SQL na planilha. Selecione a célula da planilha que executará a Consulta SQL. Lembre que a célula deve ser diferente da célula definida na Consulta SQL, pois esta deve conter o valor do parâmetro (célula 'A1', página 'Sheet1', deste exemplo).

Acesse o menu 'Planilha | Visões de Dados | Associar Consulta SQL à Célula'

Image Modified

Selecione a Consulta SQL e em seguida clique no botão 'OK'.

Image Modified

Card
idPasso 6
labelPasso 6

Informe na célula A1 da página 'Sheet' o valor que o parâmetro receberá. Neste exemplo, o valor mínimo dos salários que devem ser pesquisados.  

Em seguida, execute a Consulta SQL associada à célula.

Image Modified

Ao observar a planilha será possível visualizar o resultado, como na figura a seguir:

Image Modified

 

Informações
titlePara maiores informações:

Consulte o WikiHelp TOTVS


COMUNIDADE  @FRAMEWORK


Canais de Atendimento:

Chamado: Através do Portal Totvs www.suporte.totvs.com.br

Telefônico: 4003-0015 Escolhendo as opções 2 – (Software), 2 – (Suporte Técnico), 3 – (RM), 9 – (Demais Áreas), 4 – (BI) e 3 –  (Gerador de Relatórios e Planilha).

Informações
iconfalse
Informações
iconfalse

Produto: Framework

Informações
iconfalse

Versão: 11.82.XX ou 12.01.XX

Informações
iconfalse

Processo: Planilha RM

Informações
iconfalse

Subprocesso: Planilha RM com parâmetros das Consultas SQL

Informações
iconfalse
Informações
iconfalse

Status: Finalizado

Informações
iconfalse

Data: 19/07/2016

Informações
iconfalse

Autores:

Douglas Maxwell de Oliveira

Fábio Augusto Amaral Melo Nunes

Karina Dos Santos Costa

Stella Gleyse Macedo Vilaca

Wesley Avelino De Carvalho