--- sourceDocument: Criar ou modificar aplicações do Xanadu sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/application-development Release : - xanadu ft:locale : - pt-BR ft:publication_title : - Criar ou modificar aplicações do Xanadu ft:clusterId : - cadev bundleId : - cadev workflow : - Creator --- # Configurar componentes automaticamente usando predefinições # Configurar componentes automaticamente usando predefinições {#ariaid-title1} * Versão de lançamento: Xanadu * * Atualizado 1 de ago. de 2024 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 min. de leitura Use predefinições de componente para configurar automaticamente componentes em páginas compatíveis. Use as predefinições de componente para aplicar valores de configuração predefinidos e mapeamentos de eventos aos componentes. Construtor de IU modelos de página contêm [controladores](https://servicenow-prod.fluidtopics.net/K13DUGUgW4oiiQXteBMKFg#gloss-controller-ui-builder "Um tipo de recurso de dados que inclui dados e lógica de eventos e habilita predefinições de componente. Os controladores são adicionados automaticamente ao usar um modelo de página. Existem dois tipos de controladores: Os controladores de dados contêm recursos de dados e podem ser adicionados manualmente a uma página Os controladores de IU são adicionados às páginas ao usar modelos de página e não podem ser adicionados manualmente. A criação de controladores não é compatível no momento.") que as predefinições usam para definir valores de configuração de 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 funcionarem imediatamente, simplificando a criação e a manutenção de páginas para os autores de páginas. As predefinições oferecem os seguintes benefícios aos autores de páginas: * Manipulação de dados complexos e vinculação de eventos para componentes * Custo reduzido de propriedade e manutenção devido à definição externa às páginas {#presets__ul_tn4_lcf_zsb} 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á está 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, você 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 Xanadu.Figura 1. Predefinição aplicada a um componente ## Vinculações de dados e eventos {#presets__section_rvd_32f_zsb} 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) {#presets__ul_dg3_c54_1tb} 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)](https://servicenow-prod.fluidtopics.net/DGcmaC3dw6Q7Mii9xIi4fw "Aprenda a trabalhar com eventos para que você possa adicionar ações a componentes, páginas, recursos de dados e ações declarativas em Construtor de IU."). ## Controladores {#presets__section_chn_ym2_zsb} 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 IU páginas usando controladores (recurso avançado)](https://servicenow-prod.fluidtopics.net/5gsUs5SRTqPcjjRLgxlrPw#controllers "Os controladores simplificam a vinculação de dados e a lógica de eventos para habilitar predefinições de componente em Construtor de IU."). Figura 2. Componentes com predefinições ## Selecione uma predefinição de componente {#ariaid-title2} 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é TodosEstrutura do Now ExperienceConstrutor de IU. 2. Abra uma experiência para trabalhar ou crie uma experiência selecionando CriarExperiência. Consulte [Configure como os usuários interagem com suas aplicações no Construtor de IU](https://servicenow-prod.fluidtopics.net/lLqYhwc21ggWGJvxakpXWA "Saiba o que é uma experiência em Construtor de IU. Entenda o que uma experiência contém.") 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 Construtor de IU, consulte [Criação de uma página no Construtor de IU](https://servicenow-prod.fluidtopics.net/oXLwDAYTDqDRVYtO2ECqbg "Crie uma página em Construtor de IU para um portal, espaço ou aplicação personalizada para que você possa criar uma experiência na Web para seus usuários."). 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. ## Substitua uma predefinição de componente {#ariaid-title3} 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 dos 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 {#ariaid-title4} 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.