Configurar componentes automaticamente usando predefinições

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 [

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

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.

   
6. O componente é configurado automaticamente com a predefinição padrã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.
   
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.
   
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.
   

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.
   
2. Selecione o nome do componente no painel de configuração.
   
3. Clique em Redefinir componente.
   
4. Clique em Redefinir.

Resultado

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