--- sourceDocument: Interface do usuário da Now Platform Yokohama sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/yokohama/platform-user-interface Release : - yokohama ft:locale : - pt-BR ft:publication_title : - Interface do usuário da Now Platform Yokohama ft:clusterId : - platux bundleId : - platux workflow : - Platform --- # Ações personalizadas do playbook # Ações personalizadas do playbook {#ariaid-title1} * Versão de lançamento: Yokohama * * Atualizado 30 de jan. de 2025 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 7 min. de leitura Personalize as interações do playbook configurando condições que adicionam botões, menus suspensos, itens de lista e ícones clicáveis. Esta personalização permite que você envie formulários, abra registros e conclua e ignore atividades em todas as experiências do playbook. ## Visão geral {#playbook-actions-components__section_ecg_qzs_1mb} As ações do playbook podem executar scripts de servidor, expedir ações de cliente ou renderizar componentes de IU quando acionadas. Ao executar scripts de servidor, a variável atual é vinculada ao registro associado à atividade. Se você quiser que as ações do cliente acionem eventos em Construtor de IU, consulte [Configure ações do cliente UXF para playbook](https://servicenow-prod.fluidtopics.net/sYU6TACgLTEoZoBsUyJOxw#playbook-client-actions "Crie ações do cliente UXF do playbook para uso em Construtor de IU."). Registros de dados de fluxo (sys_flow_data) são frequentemente usados como registros associados para controlar a configuração de um fluxo por meio de um script do servidor de ação. Esses scripts de servidor podem definir o estado dos fluxos como Concluído ou Ignorado, permitindo que um agente afete diretamente a lógica em um fluxo. Os registros de dados de fluxo também podem coletar dados do usuário de um agente para usar em um fluxo. Um registro associado pode ser vinculado a qualquer tabela. Você pode definir suas próprias ações além dessas ações padrão para realizar a lógica de fluxo de trabalho do processo de negócios desejada. Você pode habilitar o recurso salvar e depois em qualquer ação de script que não seja do servidor selecionando Campos de formulário são necessários caixa de seleção. Uma ação com o recurso salvar e então envia um formulário, executa scripts de cliente e validações de regra de negócio e executa a ação quando o registro é salvo com sucesso. A ação não será executada se qualquer validação ou regra de negócio impedir que o registro seja salvo. Por padrão, isso acionará o. sysverb_ws_save Ação de IU para enviar o formulário, mas pode ser substituída especificando outra ação de IU em um UiActionName propriedade da carga de ação do cliente. ## Ações padrão {#playbook-actions-components__section_kwj_tzs_1mb} As seguintes ações padrão são compatíveis com o Playbook. {#playbook-actions-components__table_sh4_n1t_1mb__entry__2} | Nome da Ação | Descrição | |-|-| | Pular skip_instructional | Ignora uma etapa do processo instrucional | | Pular skip_email | Ignora o envio de um e-mail | | Pular skip_knowledge | Ignora uma etapa do processo de conhecimento | | Pular skip_update | Ignora uma etapa do processo de atualização de registro | | Pular skip_list | Ignora uma etapa do processo de lista | | Pular skip_create | Ignora uma etapa do processo de criação de registro | | Marcar como concluído complete_activity | Marque uma atividade como concluída | | Criar Registro create_record | Crie um novo registro a partir de um novo formulário de registro | | Enviar e-mail send_email | Informa a automação de processos para enviar e-mail | | Reiniciar restart_activity | Reinicia a atividade | | Pular skip_activity | Usando um registro de status de experiência, marque as atividades como ignoradas. | | Exibir registro Exibir registro | Exiba o registro atual | | Salvar save_record | Salvar o registro atual | | Exibir Aprovadores Aprovadores de exibição do playbook | Exibir aprovadores deste registro | | Marcar como Concluído mark_complete_knowledge | Marca uma etapa do processo de conhecimento como concluída | | Marcar como Concluído mark_complete_instructional | Marca uma etapa do processo instrucional como concluída | | Marcar como Concluído mark_complete_list | Marca uma etapa do processo de lista como concluída | | Marcar como Concluído mark_complete | Marca o processo atual como concluído | | Marcar como Concluído save_and_complete_activity | Salve o registro atual e marque o processo como concluído | [ ] {#playbook-actions-components__table_sh4_n1t_1mb} ## Personalize ações do playbook {#ariaid-title2} Personalize ações do playbook usando formulários, condições e scripts, componentes ou ações do cliente. Essa personalização permite que os usuários enviem formulários, abram registros e concluam e ignorem atividades. ### Antes de Iniciar Função necessária: playbook_experience.admin ### Por Que e Quando Desempenhar Esta Tarefa * As ações padrão não podem ser editadas. Essas ações são exibidas como somente leitura. * As ações só podem operar em um registro. {#set-up-custom-actions-playbook__ul_q12_qv3_bmb} ### Procedimento 1. Crie a ação e especifique os detalhes. 1. Navegar até Playbook ExperienceAções Ações do playbook , Ações de fase , ou Ações de atividade . 2. Selecione uma atribuição de ação ou clique em Novo para criar um novo. Nota: Para obter uma lista de ações padrão, consulte [Ações do playbook](https://servicenow-prod.fluidtopics.net/yVlmqn4RYHzK0nNdTufDyQ#playbook-actions-components "Personalize as interações do playbook configurando condições que adicionam botões, menus suspensos, itens de lista e ícones clicáveis. Esta personalização permite que você envie formulários, abra registros e conclua e ignore atividades em todas as experiências do playbook."). 3. No formulário, preencha os campos. {#set-up-custom-actions-playbook__table_xhl_bhh_bmb__entry__2} | Campo | Descrição | |-|-| | Rótulo de Ação | Rótulo que aparece no botão criado por meio da ação. | | Nome da Ação | Nome da sua ação que aparece na lista de atribuição de ação. Uma atribuição de ação substitui outras com o mesmo nome. | | Implementados como | Tipo de ação implementada. Por exemplo, componente de IU. | | Especifique o componente de IU | Quando o. Implementado como O campo está definido como Componente de IU, este campo especifica um componente de IU que é exibido quando a ação é acionada. | | Dica da ferramenta | Texto exibido quando um agente aponta o cursor sobre um botão ou ícone. | | Ícone | Ícone exibido no cartão de atividades. | | Modo de renderização | Modo de renderização em um cartão do playbook. Especifique como a ação é renderizada no cartão do playbook. Botão Selecionar , Menu suspenso de cabeçalho , ou Ícone do cabeçalho . | | Tipo de botão | Tipo de botão exibido na IU do Playbook. Selecione Primária , Secundário , ou Terciário . | | Campos de formulário obrigatórios | Opção que comunica que a ação requer dados do usuário para prosseguir. Este campo é consumido na IU do Playbook Experience das seguintes maneiras. 1. Quando uma atividade contém um formulário muito grande para caber em um cartão, o formulário fica oculto em um modal. 2. Quando uma Atividade contém um formulário, mas não tem ações que exigem campos de formulário, o formulário não é renderizado. Em vez disso, os campos no formulário são renderizados como uma coleção empilhada de pares rótulo-valor. {#set-up-custom-actions-playbook__ol_uhp_yxl_cmb}Este campo pode ser substituído criando um renderizador de atividade personalizado. | | Descrição | Descrição da ação exibida na lista Atribuições de ação. | | Aplicação | Aplicação para a atribuição de ação. | | Espaço | Espaço ao qual a ação do playbook está associada. Por exemplo, ServiceNow® ITSMOu RH. Nota: Este campo não é obrigatório. | | Tabela | Campo para limitar esta ação a atividades com esta tabela associada. | | Exibição | Campo para limitar esta ação a atividades com esta Exibição de formulário. | | Ativo | Opção para ativar a ação. | | Ordem | Número inteiro que determina a precedência desta ação em relação às ações correspondentes com o mesmo nome. Quanto menor o número, maior a probabilidade de ele ser selecionado em relação a outras ações. Esta ordenação permite substituir outras ações pelas suas próprias. A prática típica é usar números que estão na casa das centenas. Por exemplo, 100, 200, 300 ou 400. | [Tabela 1. Formulário Atribuição de ação] {#set-up-custom-actions-playbook__table_xhl_bhh_bmb} {#set-up-custom-actions-playbook__substeps_kmf_wgh_bmb} 2. Configure condições para a ação. 1. Clique em Condições . 2. No formulário, preencha os campos. {#set-up-custom-actions-playbook__table_gss_d3h_bmb__entry__2} | Campo | Descrição | |-|-| | Condição de Script | Condição de script para a atribuição de ação. Insira Playbook.PlaybookExperience.ParentRecordContainsPlaybook(atual) . Este script permite que você mostre um playbook somente quando o registro acionar uma execução de processo. Nota: A adição de consultas que envolvem várias junções pode prejudicar o desempenho. | | Condições do Cliente | Escolha condições para limitar colisões com base no seu caso de uso. | | Condições de Registros | Escolha condições para limitar colisões com base no seu caso de uso. | | Funções Necessárias | Funções para limitar o acesso ao playbook. | | Requer acessos de criação | Opções para exigir acesso de criação. | | Requer acessos de leitura | Opção para exigir acesso de leitura. | | Requer acesso de gravação | Opções para exigir acesso de gravação. | | Requer acessos de exclusão | Opções para exigir acesso de exclusão. | [Tabela 2. Formulário Condições] {#set-up-custom-actions-playbook__table_gss_d3h_bmb} {#set-up-custom-actions-playbook__substeps_t12_b3h_bmb} 3. Se Script do servidor está selecionado em Implementado como forneça um script para a ação. * Os scripts do servidor podem fazer referência ao registro associado de uma atividade usando o. Currentvariável. * Chamando current.update()Atualiza o registro associado com valores que o usuário fornece a partir de formulários incorporados nos cartões do Playbook. {#set-up-custom-actions-playbook__ul_rbs_dkn_dmb} 4. Se Ação do cliente está selecionado em Implementado como opcionalmente, especifique o mapeamento de carga no Atributos de ação . O mapeamento de carga permite substituir partes da carga expedida pela ação do cliente. Por exemplo, a ação do cliente Visualizar registro permite que você abra um registro em um novo Espaço. Usando o mapeamento de carga, você pode especificar uma guia de item relacionado que é exibida quando o formulário é aberto. Defina o. DefaultTab para fazer isso. 5. Se Componente de IU está selecionado em Implementado como opcionalmente, especifique os atributos do componente no Atributos do componente . 6. Clique em Enviar. ## Aplique ações do playbook às experiências do playbook {#ariaid-title3} Aplique ações padrão ou personalizadas do playbook às experiências do playbook. ### Antes de Iniciar Função necessária: playbook_experience_admin ### Procedimento 1. Navegar até TudoPlaybook ExperiencePlaybook Experiences. 2. Selecione uma experiência do playbook. 3. Clique na lista relacionada Mapeamento de ação. 4. Clique em Novo. 5. No formulário, preencha os campos. {#apply-playbook-actions__table_mwc_w33_knb__entry__2} | Campo | Descrição | |-|-| | atribuição de Ação | Selecione a atribuição de ação declarativa | | Playbook Experience | Escolha qual experiência do playbook aplicar a ação | | Aplicação | Aplicação na qual a ação é aplicada | | Definição de Atividade | Selecione a definição de atividade para aplicar a ação | [Tabela 3. Mapa de atribuição de ações de Playbook Experience] {#apply-playbook-actions__table_mwc_w33_knb} 6. Clique em Enviar. 7. Na seção Links relacionados, selecione Mapeamento da experiência do playbook . 8. Verifique se a experiência do playbook foi adicionada à tabela. ### O que Fazer Depois [Integre sua experiência do playbook](https://servicenow-prod.fluidtopics.net/Z62qya2HOe32dmYWd4YZ6A "Integre o playbook na guia Itens relacionados ou no painel lateral contextual em Espaço")com Espaço.