Todos os produtos
Search
Central de documentação

Quick BI:Configurar cascata condicional para controles de consulta

Última atualização: Jul 02, 2026

Configure a cascata condicional para vincular controles de consulta. Assim, uma seleção em um controle filtra as opções disponíveis em outro.

Pré-requisitos

Informações básicas

A cascata condicional vincula controles de consulta que usam o mesmo conjunto de dados ou conjuntos diferentes.

  • Se os controles de consulta usarem conjuntos de dados diferentes, selecione a cascata não homóloga.

  • Se todos os controles de consulta usarem o mesmo conjunto de dados, escolha entre cascata homóloga ou não homóloga.

    Nota

    Para a mesma fonte de dados, a cascata homóloga é mais simples e produz o mesmo resultado.

  • Para aplicar cascata a vários controles de consulta de data, selecione a cascata de data.

Limites

  • Tipos de cascata e filtro compatíveis:

    Item de configuração de cascata

    Tipos de filtro compatíveis

    Configuração de cascata homóloga

    Lista suspensa com origem em um único conjunto de dados

    Árvore suspensa

    Seleção de data com origem em campo do conjunto de dados

    Configuração de cascata não homóloga

    Lista suspensa com origem em um único conjunto de dados

    Seleção de data com origem em campo do conjunto de dados

    Configuração de cascata de data

    Seleção de data

  • Cada configuração de cascata aceita até 5 condições. Para adicionar mais, crie cascatas adicionais.

Observações

  • Controles de nível superior podem aplicar cascata aos níveis inferiores. Controles do mesmo nível podem aplicar cascata entre si, mas não no sentido inverso.

    Nota
    • Hierarquia: Controle global > Controle de consulta de aba > Controle de consulta de gráfico. Um controle global pode aplicar cascata aos controles de aba e de gráfico. Um controle de aba pode aplicar cascata aos controles de gráfico, mas não aos globais. Controles de gráfico aplicam cascata apenas dentro do próprio nível.

    • Não há suporte para cascata reversa. Por exemplo, se a área aplica cascata ao tipo de produto, o tipo de produto não pode aplicar cascata de volta à área.

  • Se existirem campos idênticos em controles diferentes, selecione Show Title e renomeie o controle para diferenciá-los.

    image

  • Ocultar uma condição de consulta limpa sua configuração de cascata. A exceção é o primeiro nível, que retém a configuração ao ser ocultado.

  • Ao ocultar o primeiro nível nas condições de consulta:

    • Se o primeiro nível tiver um valor padrão, as opções dos subníveis serão filtradas com base nesse valor.

      Por exemplo, se a cascata for Area Province City District e Area tiver como padrão East China, as opções de City e District virão da Province correspondente a East China.

    • Se o primeiro nível não tiver valor padrão, mas usar um parâmetro global, o valor do parâmetro global será aplicado.

    • Se o primeiro nível não tiver valor padrão nem parâmetro global, ocultá-lo remove a condição e todos os valores aparecem nos subníveis.

      46.gif

    • Se houver um valor padrão e um parâmetro global definidos, o parâmetro global substituirá o valor padrão.

Associar controles de consulta

  • A lista suspensa com origem em um único conjunto de dados oferece suporte a cascata homóloga e cascata não homóloga.

    image

  • A opção Select Date com origem em um campo do conjunto de dados oferece suporte a cascata de mesma origem e cascata de origem diferente.

    Nota

    Condições de data também podem aplicar cascata com controles de lista suspensa ou árvore suspensa usando cascata homóloga ou não homóloga.

    image

  • A Tree Drop oferece suporte a cascata homóloga com controles que compartilham o mesmo conjunto de dados.

    image

  • A seleção de data oferece suporte a cascata de data para vincular controles de data.

    Nota

    Vários controles de data sem origem em conjunto de dados podem aplicar cascata diretamente entre si, mas não com controles do tipo lista suspensa ou texto.

    image

Procedimento

  1. Na página de edição do painel, abra a página de cascata condicional conforme mostrado abaixo.

    image

    Alternativamente, clique em cascata condicional no painel Query Condition Settings.

    image

    A página Conditional Cascade Configuration será exibida.

    image

  2. Configure a cascata condicional.

    • Se todos os controles de consulta usarem o mesmo conjunto de dados, escolha a configuração homóloga.

    • Se os controles de consulta usarem conjuntos de dados diferentes, selecione a configuração não homóloga.

    • Para controles de Date selection:

      • Se vários controles de data não tiverem uma origem de conjunto de dados selecionada, configure a cascata usando Date Cascade na seção Date Query Control Cascade Configuration abaixo.

      • Um único controle de data combinado com controles de lista suspensa ou tipo texto oferece suporte a cascata homóloga ou não homóloga.

Configurar relação de cascata condicional (configuração homóloga)

Exemplo: O Controle A possui campos de área e província, e o Controle B possui campos de cidade e categoria de produto. Ambos usam o mesmo conjunto de dados. Vincular o campo de área no Controle A ao campo de cidade no Controle B filtra o Controle B para mostrar apenas cidades dentro da área selecionada.

  1. Na página Conditional Cascade Configuration, clique em Add New Cascade Configuration -> Homologous Cascade ou selecione Switch To Homologous Cascade.

    image

    • A opção Add New Homologous Cascade Configuration adiciona uma nova cascata sem alterar as existentes.

    • A opção Switch To Homologous Cascade substitui a cascata existente. Esta ação é irreversível.

  2. Selecione o campo alvo Area no Controle de Consulta A e clique no ícone Add.

    image

  3. Selecione o campo de condição City que deve entrar em cascata com o campo alvo.

    image

  4. Clique em Confirm.

    Agora, ao selecionar Area como Northwest no Controle de Consulta A, apenas cidades da região Noroeste estarão disponíveis no campo City do Controle de Consulta B.

    Untitled.gif

Configurar relação de cascata condicional (configuração não homóloga)

Exemplo: O Controle A tem campos de região e tipo de produto, enquanto o Controle B tem campos de província e subcategoria de produto. Eles usam conjuntos de dados diferentes. Vincular o campo de região no Controle A ao campo de província no Controle B filtra as províncias com base na região selecionada.

  1. Na página Conditional Cascade Configuration, na área Cascade Configuration Item, selecione o campo alvo Region e clique no ícone Add.

    image

  2. Na caixa de configuração de cascata, execute as seguintes ações:

    1. Selecione o campo de condição Region que deve entrar em cascata com o campo alvo.

      Se aparecerem vários campos de Provinces, selecione aquele associado ao controle alvo.

      image

    2. Selecione o campo de associação.

      • O campo de associação deve estar no conjunto de dados que recebe valores da condição de nível superior. Por exemplo, se a região aplica cascata à província, selecione o campo que recebe o valor de Region.

        image

      • O campo de associação pode ser uma Dimensão, Espaço reservado para valor de expressão ou Espaço reservado para valor. Lógica de passagem de valores do espaço reservado:

        Tipo de controle de consulta

        Método de consulta

        Espaço reservado para valor

        Espaço reservado para expressão

        Filtro de data

        Hora única:

        ex.: 2024-05-28

        2024-05-28

        >=2024-05-28,<=2024-05-28

        Intervalo de tempo:

        2024.05.28~2024.05.28

        2024-05-28

        >=2024-05-28,<=2024-05-28

        Intervalo de tempo:

        2024.05.21~2024.05.28

        2024-05-21

        >=2024-05-21, <=2024-05-28

        Filtro de texto

        Seleção única: East China

        East China

        in East China

        Seleção múltipla: East China, South China, Northeast

        East China, South China, Northeast

        in East China, South China, Northeast

        Nota

        Para intervalos de tempo, o Espaço reservado para valor assume como padrão a hora de início. Para usar a hora de término, especifique-a na consulta do conjunto de dados. Exemplo: report_date < '$val{report_date_ph.get(1)}'.

        Detalhes de uso estão disponíveis na documentação de Espaços Reservados.

  3. (Opcional)

    Para associar condições de consulta adicionais, clique em Add New Cascade Configuration e repita as etapas anteriores.

    image

  4. Clique em Confirm.

    Selecionar Region como Northeast no Controle A agora filtra o campo Province do Controle B para mostrar apenas províncias do Nordeste.

    image

Configuração de cascata de controle de consulta de data

Cascata de data

Exemplo: O Control-Date possui campos de trimestre e mês. Vincular esses campos cria uma cascata de data. Assim, selecionar o 1º trimestre de 2023 limita o controle de mês a janeiro, fevereiro e março.

  1. Na página Conditional Cascade Configuration, clique em Add New Cascade Configuration e selecione Date Cascade.

    image

    Nota

    A cascata de data oferece suporte apenas a controles do tipo data. Granularidades compatíveis: ano, ano-trimestre, ano-mês, ano-semana, ano-mês-dia e ano-mês-dia-hora-minuto-segundo.

  2. Selecione o campo alvo Quarter no Control-Date e clique no ícone Add.

    image

  3. Selecione o campo de condição Month que deve entrar em cascata com o campo alvo.

    image

  4. Clique em Confirm.

    Selecionar o primeiro trimestre de 2023 agora limita o filtro de mês ao período de janeiro a março de 2023.

    image

Cascata entre controles de data e outros controles

Controles de data só podem aplicar cascata com listas suspensas quando a fonte de dados do controle de data for um campo do conjunto de dados.

  • Exemplo: Cascata homóloga com um controle de data

    1. Na página Conditional Cascade Configuration, clique em Add New Cascade Configuration -> Homologous Cascade ou selecione Switch To Homologous Cascade.

      image

      • A opção Add New Homologous Cascade Configuration adiciona uma nova cascata sem alterar as existentes.

      • A opção Switch To Homologous Cascade substitui a cascata existente. Esta ação é irreversível.

    2. Selecione o campo alvo Transport Date no Controle C e clique no ícone Add.

      image

    3. Selecione o campo de condição Area que deve entrar em cascata com o campo alvo.

      image

    4. Clique em Confirm.

      Selecionar Date como 2023-04-01 filtra Area para mostrar apenas áreas com dados nessa data.

      image

  • Exemplo: Cascata não homóloga com um controle de data

    1. Na página Conditional Cascade Configuration, clique em Add New Cascade Configuration -> Non-homologous Cascade.

      image

    2. Na área Cascade Configuration Item da página Conditional Cascade Configuration, selecione o campo alvo Promotion Activity no Controle D e clique no ícone Add.

      image

    3. Na caixa de configuração de cascata, execute as seguintes ações:

      1. Selecione o campo de condição Date que entrará em cascata com o campo alvo.

        Se aparecerem vários campos de Dates, selecione aquele associado ao controle alvo.

        image

      2. Selecione o campo de associação.

        Nota

        O campo de associação deve receber valores da condição de nível superior. Por exemplo, se Promotion Activity aplica cascata a Date, selecione o campo Promotion Activity que recebe o valor transmitido.

        image

    4. Clique em Confirm.

      Selecionar Promotion Activity como Spring Festival Activity filtra o controle de data para mostrar apenas datas associadas.

      image

      Nota

      Quando outros controles aplicam cascata a um controle de data, o intervalo de datas selecionável abrange todas as datas associadas ao valor selecionado no conjunto de dados.

      Por exemplo, se o conjunto de dados tiver entradas de Spring Festival Activity em 2024-02-05, 2024-02-10 e 2024-02-17, o intervalo selecionável abrangerá de 2024-02-05 a 2024-02-17.

Modificar configuração de cascata condicional

Para modificar uma configuração de cascata existente:

  • Renomeie um item de configuração de cascata.

    Novas configurações são nomeadas como Cascade Configuration Item por padrão. Clique no título para renomear.

    image

  • Exclua um item de configuração de cascata.

    Clique no ícone Delete acima de uma condição para removê-la ou clique no ícone Delete ao lado do item de configuração de cascata para excluir o item inteiro.

    image