Ações personalizadas do playbook

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

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.

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

As seguintes ações padrão são compatíveis com o Playbook.

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

Personalize ações do playbook

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.

Procedimento

1. Crie a ação e especifique os detalhes.
   1. Navegar até Playbook Experience > Açõ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 .
   3. No formulário, preencha os campos.

      Tabela 1. Formulário Atribuição de ação

      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. Quando uma atividade contém um formulário muito grande para caber em um cartão, o formulário fica oculto em um modal. 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. 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.

2. Configure condições para a ação.
   1. Clique em Condições .
   2. No formulário, preencha os campos.

      Tabela 2. Formulário Condições

      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.

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.
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

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é Tudo > Playbook Experience > Playbook 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.

   Tabela 3. Mapa de atribuição de ações de Playbook Experience

   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

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 com Espaço.