Comece a usar layouts personalizados

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

    • Configure um Construtor de IU E comece a configurar seus componentes modulares de layouts personalizados do Playbook para layouts personalizados em Playbook Experience.

    Antes de Iniciar

    • Se você não tiver um playbook para aplicar layouts personalizados ao , crie um playbook. Para saber mais, consulte Criando playbooks.
    • Instale a versão mais recente do Playbook Experience E os aplicativos do componente Playbook Experience do ServiceNow Store. Consulte Playbook Experience .

    Função necessária: iu_builder_admin, admin

    Por Que e Quando Desempenhar Esta Tarefa

    Depois de criar um Construtor de IU, você pode personalizar Playbook Experience páginas de acordo com as suas necessidades. Os modelos de página incluem controladores que podem ser usados com predefinições de componente, incluindo playbook modelos. Para obter mais informações, consulte Bind data to UI Builder pages using controllers (advanced feature).

    Procedimento

    1. Navegar até Tudo > Estrutura do Now Experience > Construtor de IU.
    2. Abra o. Construtor de IU experiência na qual você deseja trabalhar ou criar uma nova experiência.
      . Playbook Experience Builder a experiência foi criada para você personalizar Playbook Experience. Para obter mais informações sobre como criar uma experiência, consulte Configure how users interact with your applications in UI Builder.
    3. Em seu Construtor de IU , você pode:
      Usando um Playbook Experience O modelo acelera o processo de desenvolvimento, porque o controlador de IU de layout personalizado do Playbook e os componentes já foram adicionados a todas as páginas, incluindo geradores de registro a partir da versão 25,2 . O controlador preenche automaticamente todos os componentes fornecidos com dados.
      Nota:
      Você ainda pode criar e adicionar componentes personalizados ao usar um modelo.

      Selecione um playbook modelo.
    4. Se você estiver usando um Playbook Experience modelo, Criar sua página.
      1. Configure os detalhes da página.
        Nome O nome da sua página.
        Caminho da URL O caminho da URL para o qual os usuários navegam para acessar a página.
      2. Revise os parâmetros de teste da sua página.
        tabela Nome da tabela primária do playbook.
        SYSID Sys_id do registro. Para um registro que não existe, o valor é -1 .
        experiência A experiência que você deseja carregar.
        selectedPlaybook O playbook em que o agente ou executante está.
        selectedStage A fase em que o agente ou executante está.
        selectedActivity A atividade em que o agente ou executante está.
      3. Configurar sua página padrão v ariante .
        Nome O nome da variante da página.
        Públicos Os usuários que podem ver sua variante de página. Eles podem ser definidos por:
        • Função
        • Grupo
        • Usuário
        • Empresa
        • Departamento
        • Local
        • Script
        Condições Condições que determinam quando a variante de página é mostrada.
      4. Abra a variante de página padrão que você acabou de criar.
      O novo Playbook Experience o layout já inclui controladores e componentes preenchidos com dados, mas há mais algumas configurações a serem feitas. Para fazer as configurações restantes, vá para a etapa 6.
    5. Se você usou Registro padrão Ou criou sua página do zero, adicione o controlador de IU de layout personalizado do Playbook à página.
      1. No canto inferior da nova página, selecione o ícone de dados ( Ícone de dados.)
      2. Selecione Adicionar .
      3. PESQUISE "Playbook".
      4. Em Recursos de dados , selecione Playbook Custom Layout IU Controller e clique em Adicionar .
      5. Saia do Recursos de dados painel.
    6. Configure o Playbook Personalizado Controlador de IU de Layout você acabou de adicionar.
      1. Para permitir que os usuários criem um novo registro neste personalizado Playbook Experience em vez do formulário de novo registro padrão, selecione uma cápsula de valor de teste no canto superior esquerdo.
        O popover de valores de teste é aberto.
      2. Certifique-se de SYSID o valor de teste está definido como -1 e selecione Aplicar .
        Valores de teste para sua experiência de playbook, com a tabela e o SYSID.
        Um formulário gerador de registro está disponível quando você abre a visualização. Você deve ser capaz de testar o formulário do gerador de registros e confirmar se novos registros foram criados.
      3. Você também pode atualizar o. tabela nome ou qualquer um dos parâmetros opcionais:
      4. Opcional: Em vez disso, você quiser codificar os valores de teste, navegue de volta para Dados > Painel Recursos de dados > Instâncias locais de recurso de dadose selecione Página de registro do controlador de IU .
      5. Em Configuração do controlador, adicione SYSID primário ou Tabela primária . No popover de valores de teste, estes são SYSID e. tabela campos.
        Você pode inserir context.props.table em Tabela primária , e. context.props.sysId para SYSID primário campo.
        Nota:
        Qualquer tabela ou registro inserido tem um playbook.
      6. Adicione Playbook Experience que você deseja usar.
      7. Opcional: Insira valores para os outros campos, se necessário.
        Modo de exibição de atividade Modo de exibição usado para renderizar atividades do Playbook no modo empilhado ou focado
        Consulta do gerador de registro Cadeia de caracteres de consulta codificada para substituir opcionalmente a consulta fornecida para um gerador de registro
        ID de contexto do playbook selecionado ID de contexto opcional do playbook selecionado para link profundo
        ID de contexto da fase selecionada ID de contexto opcional da fase selecionada para link profundo
        ID de contexto da atividade selecionada ID de contexto opcional da atividade selecionada para link profundo
      8. Opcional: Na coluna Saídas, você pode selecionar os valores que deseja codificar.
      O controlador está configurado e você está pronto para adicionar playbook componentes.
    7. Adicionar playbook componentes.
      1. Na árvore de componentes, selecione Guia principal .
        . Guia principal o painel é aberto à direita.
      2. Em Guia principal painel, selecione Adicionar .
        Um modal perguntando "Como você deseja criar esta guia?" exibido.
      3. Selecione Comece a partir de um contêiner vazio e clique em Próximo .
        . Configurações da guia modais são exibidos.
      4. Dê um nome e um ícone à guia e clique em Criar .
        A guia é adicionada à árvore de componentes e uma tela em branco é exibida.
      5. Na árvore de componentes, na nova guia, selecione Adicionar componente e pesquise "redimensionável".
      6. Selecione Painéis redimensionáveis componente, atribua um nome a ele e clique em Criar .
      7. Na árvore de componentes, abra o novo Painéis redimensionáveis componente que você acabou de criar.
        O painel do seu novo Painéis redimensionáveis abre à direita.
      8. Configure conforme necessário e clique em Salvar no canto superior direito.
      9. Para adicionar o seletor de fase, encontre seu novo Painéis redimensionáveis componente na árvore de componentes e selecione Adicionar componente em à esquerda .
      10. Em sua árvore de componentes, selecione o novo seletor de fase.
        O painel do seu novo seletor de fase é aberto à direita.
      11. Selecione a predefinição para este componente no controlador de IU de layout personalizado do Playbook e clique em Salvar no canto superior direito.
        Escolha uma predefinição para o componente.
        Uma mensagem de confirmação é exibida e as entradas e eventos do componente em Eventos a guia no painel do seletor de fases é preenchida automaticamente.
        Configuração do componente.
      12. Para adicionar Visualizador de atividades do Playbook , encontre seu Painéis redimensionáveis componente na árvore de componentes e selecione Adicionar componente em certo .
      13. Repita as etapas 7j e 7k.
      14. Para adicionar Modais do Playbook , localize a guia que você criou em Guia principal na árvore de componentes e selecione Adicionar componente .
      15. Repita as etapas 7j e 7k para Modais do Playbook .
      16. Navegue de volta para Seletor de fases do Playbook e determinam a orientação do seletor de fases.
      17. No canto superior direito, clique em Aberto para visualizar o. playbook layout.
      18. Retornar para Construtor de IU.
      19. Navegue de volta para o seletor de fases na árvore de componentes e determine a orientação do seletor de fases no painel que é aberto à direita.