Uma consulta define quais dados são extraídos da origem de
dados e obtém a forma de um caminho no esquema da origem de dados. É possível designar uma consulta para um elemento de modelo para
definir o contexto de dados para esse elemento e seus filhos.
Procedimento
- Designe consultas.
- No Document Studio, abra Visualização de origem de
dados.
- Inclua elementos no modelo.
- Arraste as consultas de Visualização da origem de
dados para os elementos.
Uma consulta é designada a um elemento de modelo, você pode
utilizar os atributos do tipo de consulta, o elemento arrastado de
Visualização de origem de dados, em qualquer
lugar no elemento de modelo e seus elementos filhos.
- Configure um limite para o elemento de consulta.
Nota: Você pode processar um subconjunto de elementos de modelo
configurando um
limite para os elementos de consulta.
- No Document Studio, selecione o elemento de modelo que contém a
consulta.
- Na visualização Propriedades, selecione a
guia Dados.
- Para a propriedade Limite,
insira o número de objetos da origem de dados a ser usado na consulta
respectiva. Um valor de 0 (zero) representa
nenhum limite configurado para a consulta.
- Designe propriedades recorrentes às consultas. Você usa a recursão de dados para extrair todos os requisitos
filhos de um requisito de origem principal em um esquema.
- Selecione o elemento que contém a consulta.
- Na visualização Propriedades, para a propriedade
Nível recursivo, insira em quantos níveis de
profundidade a consulta está.
- Para a propriedade Segmentos recursivos,
insira quantas vezes os segmentos se repetem na consulta.
Consulte o exemplo abaixo sobre os níveis recursivos e
segmentos recursivos.
- Salve suas mudanças.
Resultados
Quando você aplica uma consulta para um
elemento, há três indicadores visuais que aparecem em azul por padrão
no editor de conteúdo do modelo:
- O nome do esquema da origem de dados
- O contexto exibido com um símbolo de dólar ($)
- O nome da consulta
Dica: Ao limpar informações de consultas,
Limpar consultas e Limpar
tudo funcionam de forma diferente. Limpar
consultas está disponível apenas quando você seleciona um
elemento que tem uma consulta. Limpar tudo
remove todas as consultas, atributos, filtros, classificações e
condições no elemento que você selecionou e seus elementos filhos, se
eles também tiverem consultas ou atributos designados a eles. Páginas
principais, estilos e propriedades de formatação não são removidos.
Exemplo: nível recursivo e segmentos recursivos
Para cada consulta pai, você pode extrair todos os requisitos filho,
e para cada requisito filho, extraia seus requisitos filhos sem
incluir cada consulta em seu modelo.
Em vez de incluir cada uma
dessas seguintes consultas:
- [$1]
Query1/Query2/Query3
para extrair Query3.
- [$2]
$1/Query4/Query5/Query6
para extrair requisitos filhos de cada Query3.
- [$3]
$2/Query4/Query5/Query6
para extrair requisitos filhos de cada requisito filho de cada Query3.
É possível construir uma consulta para esses requisitos
automaticamente:
- Inclua a consulta Query1/Query2/Query3/Query4/Query5/Query6
em um elemento.
- Inclua valores para as propriedades Nível recursivo e Segmentos
recursivos:
- Execute o relatório para testar.
Na execução do relatório,
estas consultas são incluídas:
Se você achar que o número inserido para a propriedade
Segmentos
recursivos é maior que o número de segmentos
que a consulta contém, poderá utilizar uma dessas duas opções
para resolver o problema:
- Selecione o elemento que tem a propriedade Segmentos
recursivos aplicada. Na visualização Propriedades,
selecione a guia Dados e diminua o valor
para a propriedade de segmentos recursivos.
- Você também pode reprojetar a consulta para iniciar a partir de
uma consulta pai diferente. Se o valor Segmentos
recursivos for um segmento muito alto, crie um
elemento de contêiner e inclua uma consulta que seja um nível mais
alto que a consulta pai do elemento existente.
Em seguida, mova o elemento existente para o elemento do contêiner.
O que Fazer Depois
Dica: Você pode procurar
por uma lista de consultas e atributos clicando com o botão direito
em um elemento e selecionando . A visualização Procurar
é aberta e uma lista de consultas e atributos é exibida. É
possível clicar duas vezes em uma consulta ou atributo nos
resultados para editar seu conteúdo.
Você pode procurar por uma lista de
designações de variáveis, atributos e consultas usados em um elemento
clicando com o botão direito em um elemento e selecionando
. A visualização
Procurar é aberta e uma lista é exibida. É possível dar um clique
duplo em um item nos resultados para editá-lo.
É possível localizar uma consulta ou atributo na
visualização de origem de dados do elemento ao qual ele é aplicado
clicando com o botão direito em um elemento e selecionando
. A visualização de origem de dados
é aberta e a consulta ou atributo é destacado.