Configurar componentes automaticamente usando predefinições

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 3 min. de leitura
  • Use predefinições de componente para configurar automaticamente componentes em páginas compatíveis.

    Use predefinições de componente para aplicar valores de configuração predefinidos e mapeamentos de evento aos componentes. Construtor de IU Os modelos de página contêm controladores que 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 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 componente de formulário 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 da página para os autores da página.

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

    • Manipulação de dados complexos e vinculação de evento 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á-lo 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á é 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 da manutenção do componente.

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

    Vinculações de dados e eventos

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

    • Propriedades de saída do controlador (@data)
    • Cargas do evento (@payload)
    • Contexto da sessão (@context.session)
    • Fórmulas complexas (transformações do cliente)

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

    Controladores

    As predefinições conectam componentes a mapeamentos de dados e eventos usando um controlador. Se o controlador necessário para uma predefinição ainda não estiver na página, a predefinição solicitará que você configure as propriedades necessárias do controlador e adicionará 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 Vincule dados a páginas do Construtor de IU usando controladores (recurso avançado).

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

    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é Todos > Estrutura do Now Experience > Construtor de IU.
    2. Abra uma experiência para trabalhar ou crie uma experiência selecionando + Criar.
      Consulte Configure como os usuários interagem com suas aplicações no Construtor de IU para 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 UI Builder, consulte Criar uma página no UI Builder.
    4. Abra a caixa de ferramentas.
    5. Adicione um componente destacado em verde à sua página.

      Os componentes destacados em verde têm predefinições disponíveis.

      Abra a biblioteca de componentes e arraste um componente destacado em verde para a página.
    6. O componente é configurado automaticamente com a predefinição padrão.
      A predefinição de componente padrão é exibida no menu suspenso de predefinição.
    7. Opcional: Selecione uma predefinição diferente na lista do painel de configuração.
      Você pode configurar um componente para não usar uma predefinição selecionando Remover.
      1. Selecione Continuar para substituir a predefinição existente.
      Selecione uma predefinição diferente ou nenhuma predefinição na lista.
    8. Clique em Salvar.

    Substituir 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 Salvar.
      Substitui valores de componente predefinidos por valores personalizados.

    Resultado

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

    Redefinir um componente

    Redefina as predefinições de componente para seus 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 do componente é redefinida para os valores padrão.