Configurar componentes automaticamente usando predefinições

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 3 min. de leitura
  • Use predefinições de componente para configurar componentes automaticamente em páginas compatíveis.

    Use predefinições de componente para aplicar valores de configuração predefinidos e mapeamentos de eventos aos componentes. Construtor de IUos modelos de página contêm controladoresque as predefinições usam para definir valores de configuração do componente.

    As predefinições aplicam configurações pré-criadas às propriedades do componente e aos manipuladores de eventos e estão disponíveis somente para determinados componentes. Eles são baseados em casos de uso comuns para componentes, como configurar um Formulário componente com campos que normalmente são incluídos em uma página de registro.

    A aplicação de uma predefinição configura automaticamente os componentes para funcionar imediatamente, simplificando a criação e a manutenção de páginas para autores de páginas.

    As predefinições oferecem os seguintes benefícios aos autores de página:

    • Manipulação de dados complexos e vinculação de eventos para componentes
    • Custo de propriedade e manutenção reduzido devido à definição externa às páginas

    No painel Configuração, você pode selecionar se deseja aplicar uma predefinição ao componente selecionado ou configurá-la manualmente. As predefinições padrão são aplicadas automaticamente aos componentes quando uma página é criada a partir de um modelo ou o controlador necessário para a predefinição já foi adicionado à página. Todas as propriedades ou eventos configurados pela predefinição são exibidos como somente leitura quando uma predefinição é aplicada.

    Você pode substituir valores configurados por uma predefinição, mas, ao fazer isso, assume a propriedade da configuração e manutenção do componente.

    As subpáginas não herdam controladores e não podem usar predefinições em Zurich.
    Figura 1. Predefinição aplicada a um componente
    Propriedades do componente de título configuradas por uma predefinição.

    Vinculações de eventos e dados

    As predefinições podem incluir vinculações para:

    • Propriedades de saída do controlador (em dados)
    • Cargas do evento (na carga)
    • Contexto da sessão (a context.session)
    • Fórmulas complexas (transformações de cliente)

    As predefinições também podem incluir mapeamentos de eventos para eventos manipulados de um controlador. Para obter mais informações, consulte Gerencie ações nas páginas do Construtor de IU.

    Controladores

    As predefinições conectam componentes a mapeamentos de dados e eventos usando um controlador. Se o controlador exigido por uma predefinição ainda não estiver na página, a predefinição solicitará que você configure as propriedades necessárias do controlador e adicione o controlador. Depois que um controlador é adicionado a uma página, os componentes que têm predefinições associadas ao controlador aparecem realçados na lista de componentes. Para obter mais informações, consulte Vincular dados a Construtor de IUpáginas que usam controladores (recurso avançado).

    Figura 2. Componentes com predefinições
    Guia Componentes mostrando componentes com rótulo predefinido realçado.

    Verifique o. Predefinições disponíveis para exibir componentes com predefinições na caixa de ferramentas.

    Selecione uma predefinição de componente

    Escolha uma predefinição de componente ao adicionar um componente à sua página.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Navegar até Tudo > Estrutura do Now Experience > Construtor de IU.
    2. Abra uma experiência para trabalhar ou crie uma experiência selecionando Criar > Experiência.
      Consulte Configure como os usuários interagem com suas aplicações no Construtor de IUpara obter mais informações sobre como criar experiências.
    3. Crie ou abra uma página ou variante de página.
      Para obter mais informações sobre como criar uma página no Construtor de IU, consulte Crie uma página no Construtor de IU .
    4. Abra a caixa de ferramentas.
    5. Selecione Predefinições disponíveis caixa.
    6. Selecione o componente que você deseja adicionar à sua página.
      Abra a caixa de ferramentas mostrando componentes com predefinições.
    7. O componente é configurado automaticamente com a predefinição padrão.
      A predefinição de componente padrão é exibida no menu suspenso predefinido.
    8. Opcional: Selecione uma predefinição diferente na lista no painel de configuração.
      Você pode configurar um componente para não usar uma predefinição selecionando Remover predefinição atual .
      1. Selecione uma nova predefinição de componente no painel de configuração.
      2. Selecione Aplicar para substituir a predefinição existente.
      Selecione uma predefinição diferente ou nenhuma predefinição na lista.
    9. Clique em Salvar.

    Substitua uma predefinição de componente

    Substitua uma predefinição de componente para inserir seus próprios valores personalizados.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Selecione um componente com uma predefinição.
      Selecione o componente que você deseja substituir na árvore de conteúdo.
    2. Encontre o valor de dados que você deseja substituir no painel de configuração.
    3. Clique no ícone de cadeado no campo de dados.
    4. Insira o valor de dados que você deseja substituir o valor predefinido.
    5. Selecione Save (Salvar).
      Substitua valores de componente predefinidos por valores personalizados.

    Resultado

    O painel de configuração exibe o valor personalizado no campo.

    Redefina um componente

    Redefina as predefinições de componente para os valores padrão.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Selecione o componente que você deseja redefinir na árvore de conteúdo.
      Selecione o componente que você deseja substituir na árvore de conteúdo.
    2. Selecione o nome do componente no painel de configuração.
      Nome do componente no painel de configuração.
    3. Clique em Redefinir componente .
      Redefina os valores do componente com a opção Redefinir componente.
    4. Clique em Redefinir .

    Resultado

    A predefinição de componente é redefinida para os valores padrão.