Skip to content

Guia de Navegação com Parâmetros de Rota

Como parte do suporte ao estado da aplicação, o uso de variáveis no App Builder agora facilita a navegação dentro da aplicação com um tipo especial de variáveis, ou seja, Parâmetros de rota.

Entendendo Parâmetros de Rota

Os parâmetros de rota funcionam como variáveis, permitindo aos usuários criar, armazenar valores, atribuir valores e vinculá-los a outras propriedades na aplicação. No entanto, esses parâmetros de rota têm um uso principal específico - permitir que os usuários construam navegação dentro do app (consulte Navegação). Quando uma rota de navegação requer vinculação de parâmetros, os usuários podem vincular um parâmetro de rota para facilitar esse processo.

Distinções principais entre Variáveis de App e parâmetros de rota:

  • Os parâmetros de rota só podem ser criados em uma visualização filha, onde a visualização filha pode servir como página de destino para uma rota de navegação específica.
  • Os parâmetros de rota só podem ser dos tipos string, numeric ou boolean. O suporte para outros tipos será introduzido em versões futuras.
  • Os parâmetros de rota suportam valores iniciais, com parâmetros de rota boolean suportando apenas um valor inicial FALSE.
  • Os parâmetros de rota não são variáveis de destino para uma ação Set Variable.

Introdução a Variáveis

Criando um Parâmetro de Rota

Os usuários podem criar um Parâmetro de Rota de duas formas:

  1. Através do fluxo Nova Variável > Param. de rota na seção Variáveis.
  2. Usando o botão + adicionar na seção Parâmetros de Rota, parte do painel Propriedades.

O nome do parâmetro passa pela mesma validação que uma variável.

Criar Parâmetro de Rota

Uso de Parâmetro de Rota

  • Se uma visualização filha tem apenas um Parâmetro de Rota, ele é tratado como um parâmetro de caminho para roteamento de aplicação. Isso permite navegação para /child-view/pathParameter enquanto passa um certo valor para o pathParameter.

  • Quando mais de um parâmetro de rota é criado para a visualização, esses parâmetros são tratados como parâmetros de consulta na navegação: /child-view/pathParameter=value1&pathParameter2=value2. Se o único parâmetro de rota em uma visualização é do tipo boolean, ele é tratado como um parâmetro de consulta.

Parâmetros de Rota Opcionais e Obrigatórios

Se um Parâmetro de Rota tem um valor inicial, ele é tratado como um parâmetro opcional na navegação. Criar um Parâmetro de Rota opcional significa que sua aplicação terá duas rotas válidas:

  1. /app/customerDetails/customerID
  2. app/customerDetails

Na opção 2, quando um valor para o parâmetro customerID não é definido, o tratamento da propriedade customerID pode variar dependendo do seu framework de destino. Os frameworks Angular e WebComponents atribuirão um valor de undefined por padrão, mas esse valor será substituído pelo valor inicial definido para a propriedade no App Builder.

  1. Adicione um componente na superfície de design (por exemplo, um botão) e anexe uma interação Navegar para a ele, escolhendo uma visualização filha na lista suspensa.

  2. Se a visualização filha selecionada tem Parâmetros de Rota, o usuário terá a opção de abrir um diálogo, onde os Parâmetros de Rota podem ser fornecidos com ou vinculados a valores:

Inicializar dados de um endpoint

Recursos Adicionais