Widget do Playbook do portal

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

    • Explore o widget do Playbook do portal.

    Sobre o widget

    O widget do Playbook é um iFrame que permite que os administradores especifiquem para onde um evento do playbook deve ser direcionado. A URL do iFrame é a 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 em Portal de serviços.

    Os componentes prontos para uso foram criados para qualquer Playbook Experience que você possa precisar para seus usuários Portal de serviços. Não recomendamos a edição direta da página do portal do Playbook pronta para uso Construtor de IU, o widget do Playbook Portal de serviços ou o item de conteúdo do Playbook. Alterar os componentes prontos para uso pode resultar em problemas técnicos.

    Se, por exemplo, você precisar que uma Ação do cliente UXF funcione para sua instância da página do playbook, recomendamos a clonagem do widget do playbook.

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

    Como clonar um widget do Playbook Service Portal

    Navegar até Tudo > Portal de serviços > Widgets e encontre o widget do Playbook.
    Nota:
    Se você clonar o widget do Playbook, certifique-se de que todas as ações prontas para uso e 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 do que o widget faz.
    Aplicação Escolha um escopo da aplicação no qual você deseja que o widget seja executado. Selecionar Global permite que seu playbook seja executado 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 estiver 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 Restrinja o acesso ao widget a determinadas funções.
    Modelo de HTML do corpo Aproveite a vinculação bidirecional do JS angular para vincular as variáveis do controlador à marcação.
    Perigo:
    Somente faça mudanças nos modelos HTML se você tiver conhecimento avançado de codificação e uma sólida compreensão do AngularJS e da API da plataforma.
    A URL do iFrame é a URL da página Construtor de IU. Para saber mais sobre o campo de 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. A configuração de 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 para interagir com a plataforma Glide por meio de APIs do lado do servidor.
    Perigo:
    Um script de servidor requer conhecimento da API da ServiceNow para funcionar 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. O angular combina o modelo com informações do controlador do modelo e 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 da ServiceNow e do AngularJS para criar um controlador de cliente.
    controllerAs O modelo HTML usa a sintaxe controladorAs para vinculação básica.
    Link Use uma função de link para manipular diretamente o DOM.
    Perigo:
    A função de vinculação requer conhecimento do 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 widget.
    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 que um administrador Portal de serviços configure um widget. Para saber mais sobre o campo Esquema de opção, consulte . e Widget option schema.
    Documentos Selecione um link de documentação Portal de serviços.

    Verifique se há erros na configuração da página Construtor de IU do Portal da Playbook Experience e nas propriedades de eventos. Por exemplo, desabilite o evento Abrir registro como um usuário de manutenção.