Widget Playbook do portal

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

    • Explore o Widget Playbook do Portal.

    Sobre o widget

    O widget Playbook é um iFrame que permite que os administradores especifiquem para onde um evento do playbook deve ser direcionado. O URL do iFrame é Construtor de IU Página do Portal de Playbooks. O widget lida com eventos que o playbook está ouvindo por meio da API de armazenamento de sessão para que ele saiba quando executar uma ação no portal, como abrir um registro ou lista em um modal no Portal de serviços.

    Os componentes prontos para uso são criados para qualquer um Playbook Experience você pode precisar para seu Portal de serviços usuários. Não recomendamos editar diretamente o pronto para uso Construtor de IU Página do Portal do Playbook, o. Portal de serviços Widget do Playbook ou o Item de conteúdo do Playbook. Mudar os componentes prontos para uso pode resultar em problemas técnicos.

    Se, por exemplo, você precisar de uma Ação de cliente UXF para trabalhar sua instância da página do playbook em vez disso, recomendamos clonar o widget do playbook.

    Nota:
    Para saber mais sobre como clonar ou criar seu próprio widget, consulte Developing custom widgets.

    Clonar um widget do Portal de serviços do Playbook

    Navegar até Tudo > Portal de serviços > Widgets e encontre Playbook widget.
    Nota:
    Se você clonar o. Playbook widget, certifique-se de que todas as ações prontas para uso e as propriedades de configuração sejam copiadas para o widget clonado.
    Tabela 1. Campos de formulário
    Campo Descrição
    Nome Insira um nome para o widget clonado.
    ID O ID do widget é criado automaticamente com base no nome do widget por padrão, mas você pode alterá-lo para o que quiser.
    Descrição Adicione uma descrição opcional que forneça detalhes para o widget.
    Aplicação Escolha um escopo da aplicação no qual você deseja que o widget seja executado. Selecionando Global permite que seu playbook execute em qualquer escopo da aplicação. Para obter mais informações, consulte Escopo da aplicação .
    Público(a) Selecione se o widget for público. Se desmarcado, seu widget será privado e somente usuários autenticados com a função snc_internal ou snc_external poderão ver o widget.
    Funções Restringir o acesso ao widget a determinadas funções.
    Modelo de HTML do corpo Aproveite a vinculação bidirecional JS angular para vincular suas variáveis do controlador à marcação.
    Perigo:
    Só faça mudanças nos modelos HTML se você tiver conhecimento avançado de codificação e um entendimento firme do AngularJS e da API da plataforma.
    O URL do iFrame é o URL do Construtor de IU página.Para saber mais sobre o campo Modelo HTML, consulte Developing custom widgets.
    Aviso:
    Certifique-se de que a URL do iFrame do widget clonado seja diferente da URL do iFrame do widget pronto para uso.
    CSS Configure o CSS do widget. Configurar CSS em um widget real afeta todas as instâncias desse widget. Para saber mais sobre o campo CSS, consulte Developing custom widgets.
    Script do servidor Script da lógica do lado do servidor. Isso é útil principalmente na interação com a plataforma Glide por meio de APIs do lado do servidor.
    Perigo:
    Um script de servidor requer conhecimento da API da ServiceNow para trabalhar com dados de registro.
    Para saber mais sobre o campo Script do servidor, consulte Developing custom widgets.
    Controlador do cliente No Angular, os modelos HTML contêm elementos e atributos específicos do angular. Angular combina o modelo com informações do modelo e do controlador do cliente para renderizar a exibição dinâmica que um usuário vê no navegador. Nome do identificador para uma referência ao controlador no escopo da diretiva
    Perigo:
    Um client script requer conhecimento da API ServiceNow e do AngularJS para criar um controlador de cliente.
    controllerAs O modelo HTML usa a sintaxe controllerAs para vinculação básica.
    Link Use uma função de link para manipular diretamente o DOM.
    Perigo:
    A função de link requer conhecimento de AngularJS.
    Para saber mais sobre o campo Link, consulte Developing custom widgets.
    Tem visualização Selecione a opção para habilitar uma visualização do widget no Editor de widgets.
    Dados de demonstração Forneça dados ao visualizar o widget no editor de widgets.
    Tabela de dados Selecione uma tabela para usar como fonte de dados.
    Campos Selecione os campos a serem exibidos como opções de instância.
    Esquema de opções Permite um Portal de serviços administrador para configurar um widget. Para saber mais sobre o campo de esquema de opção, consulte . e. Widget option schema.
    Documentos Selecione um Portal de serviços link da documentação.

    Verifique se há erros no Construtor de IU Configuração da página do Portal Playbook Experience e propriedades de eventos, por exemplo, desabilitar o evento Abrir registro como um usuário de manutenção.