Designando consultas

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

  1. Designe consultas.
    1. No Document Studio, abra Visualização de origem de dados.
    2. Inclua elementos no modelo.
    3. 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.
  2. 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.
    1. No Document Studio, selecione o elemento de modelo que contém a consulta.
    2. Na visualização Propriedades, selecione a guia Dados.
    3. 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.
  3. 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.
    1. Selecione o elemento que contém a consulta.
    2. Na visualização Propriedades, para a propriedade Nível recursivo, insira em quantos níveis de profundidade a consulta está.
    3. 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.
  4. 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
Elemento de célula com uma consulta aplicada
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:
  1. Inclua a consulta Query1/Query2/Query3/Query4/Query5/Query6 em um elemento.
  2. Inclua valores para as propriedades Nível recursivo e Segmentos recursivos:
    • Para a propriedade Nível recursivo, insira 4.

      Nível recursivo representa a quantos níveis de profundidade a consulta está. Se você inserir um valor de um ou maior, também deverá configurar um valor de um ou maior para a propriedade Segmentos recursivos.

    • Para a propriedade Segmentos recursivos, insira 3.
      Segmentos recursivos representa quantas vezes os segmentos se repetem na consulta. Os segmentos neste exemplo são Query4/Query5/Query6.
      Nota: O número inserido para a propriedade Segmentos recursivos não pode ser maior que o número de segmentos que a consulta contém. A consulta pai não está incluída como um segmento.
  3. Execute o relatório para testar.
    Na execução do relatório, estas consultas são incluídas:
    • [$1] – Query1/Query2/Query3/Query4/Query5/Query6
      Nota: A primeira consulta deve incluir o contexto completo para a consulta.
    • [$2] – $1/Query4/Query5/Query6
    • [$3] - $2/Query4/Query5/Query6
    • [$4] – $3/Query4/Query5/Query6
    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 Procurar > Referências de dados no elemento. 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 Procurar > Todas as referências no elemento. 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 Procurar > Ir para esquema. A visualização de origem de dados é aberta e a consulta ou atributo é destacado.