Adicionar formulários a páginas do Construtor de IU

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 2 min. de leitura

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

    Adicione funcionalidade às suas Construtor de IU páginas incluindo 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 é preenchido e enviado.
    Figura 1. Exemplo de componente de formulário
    Exemplo de componente de formulário chamado 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 do 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 uma versão pré-Xanadu ServiceNow, 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 o 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 a lista Recursos de dados e selecione o controlador de formulário original.

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

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

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

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

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

    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, na guia Configurar, selecione Controlador de formulário.

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

    10. No pop-up Editar controlador de formulário, role para baixo na lista Controlador de formulário para encontrar a opção Está mapeado para o App Shell.

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

    11. Marque ou desmarque a opção para 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.

    Manipulação avançada de eventos de formulário

    Os detalhes a seguir podem ser úteis para desenvolvedores experientes com conhecimento de manipulação de eventos de conflito.

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

    Para obter informações detalhadas sobre o componente Formulário e suas propriedades, consulte Visão geral do formulário no site do desenvolvedor ServiceNow.