Adicione formulários às páginas do Construtor de IU

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 2 min. de leitura

    • Use o componente Formulário para adicionar um ou mais formulários a. Construtor de IUpáginas.

    Adicione funcionalidade ao seu Construtor de IUincluindo formulários. Você define os campos no formulário e suas propriedades, como torná-los obrigatórios. Em seguida, colete dados conforme o formulário for preenchido e enviado.
    Figura 1. Exemplo de componente de formulário
    Componente de formulário de amostra chamada tarefa de linha de ordem de transferência em uma página.
    Você pode adicionar mais de um formulário a uma única página. Você também pode adicionar um formulário a uma página que já contém um componente com um formulário aninhado. Exemplos de casos de uso incluem:
    • Estenda as páginas de registro adicionando uma guia em linha com um formulário usando sua própria instância de controlador de formulário.
    • Adicione modais com um formulário em uma página de registro.
    Para páginas existentes com formulários criados em um pré-Xanadu ServiceNowversão, você deve aplicar uma predefinição ao formulário original antes de adicionar outro formulário à página. A aplicação da predefinição é um pré-requisito para adicionar vários formulários a uma página e permite que vários formulários funcionem conforme esperado em uma página. A predefinição do controlador de formulário deve ser aplicada a todos os controladores de formulário.
    1. Abra a página que contém um formulário existente.
    2. Na gaveta de dados, expanda Recursos de dados e selecione o controlador de formulário original.

      Gaveta de dados com a lista de recursos de dados expandida e seta preta apontando para o controlador de formulário.

    3. Selecione Predefinição campo.
    4. Selecione Predefinição do controlador de formulário .

      Editar pop-up do controlador de formulário com seta preta apontando para o campo predefinido e a segunda seta preta apontando para a opção predefinida do controlador de formulário.

    5. Selecione Aplicar.
    6. Selecione X para fechar o. Editar controlador de formulário pop-up.

      Exatamente um de seus controladores de formulário deve ter Está mapeado para o shell da app propriedade definida como verdadeira. Esta propriedade é usada para especificar o formulário primário na página. O formulário primário é responsável por processar eventos globais. Você não deve definir a propriedade como verdadeiro para mais de um controlador de formulário ou ter nenhum controlador de formulário com a propriedade definida como verdadeiro.

    7. Abra a página que contém um ou mais formulários.
    8. Na árvore de conteúdo, selecione um formulário.

      Árvore de conteúdo com seta preta apontando para um componente de formulário.

    9. No painel de configuração, no Configurar , selecione Controlador de formulário .

      Painel de configuração de formulário com a guia de configuração exibida e seta preta apontando para o link do controlador de formulário.

    10. Em Editar controlador de formulário pop-up, role para baixo no Controlador de formulário lista para encontrar o. Está mapeado para o shell da aplicação opção.

      Editar janela pop-up do controlador de formulário com a seta preta apontando para a opção de shell do app mapeado.

    11. Selecione ou desmarque a opção de cada componente de formulário na página para confirmar que exatamente um controlador de formulário está mapeado para o shell da aplicação.

    Tratamento avançado de eventos de formulário

    Os desenvolvedores experientes com conhecimento de manipulação de eventos de conflito podem achar os seguintes detalhes úteis.

    Se isMapped to app shell estiver definido como verdadeiro, o formulário manipulará estes eventos automaticamente:
    Status da tela alterado
    • Descrição: Ação para indicar que um formulário está sujo.
    • Saída: SCREEN_STATUS_CHANGED
    Atualizar menu de configuração solicitado
    • Descrição: Ação para definir itens de menu de configuração de registro no menu de avatar.
    • Saída: UPDATE_CONFIGURATION_MENU_REQUEST
    Telefone solicitado
    • Descrição: Ação para fazer uma chamada quando o plug-in CTI está habilitado.
    • Saída: PHONE_REQUESTED
    Estado de carregamento do formulário alterado
    • Descrição: Ação para mostrar uma rotação de carregamento quando esse formulário está carregando dados.
    • Saída: FORM_LOADING_STATE_CHANGED

    Para obter informações detalhadas sobre o componente de formulário e suas propriedades, consulte Visão geral do formulário em ServiceNowSite do desenvolvedor.