Trabalhe com o simulador do Playbook
O simulador de guias interativos oferece uma abordagem simplificada para desenvolver guias interativos com menos tempo e esforço.
O Simulador de manuais oferece várias funcionalidades principais que lhe permitem:
- Trabalhar num ambiente de pré-produção, o que lhe permite testar ações e observar resultados sem afetar os dados de produção em direto (especialmente quando o manual de estratégias está desativado).
- Facilitar os testes de cada passo ou bloco individual do manual de estratégias para confirmar que o fluxo de trabalho funciona como previsto.
- Teste todos os ramos de condições possíveis no seu manual de procedimentos, confirmando uma cobertura abrangente e um comportamento previsível.
Use o simulador de guias interativos com o seu guia interativo
Quando trabalha com manuais de soluções, quer esteja a usar um existente ou a criar um novo, comece sempre por ativar o simulador de manuais de soluções. É apresentado um indicador verde na parte superior a confirmar que está ativo.
Se usar o Simulador de manuais de soluções num manual de soluções ativo, isso afeta todos os alertas recebidos que acionam esse manual de soluções. Isto deve-se ao facto de guardar um manual de procedimentos com dados simulados aplicar esses dados a registos ativos em produção, o que pode afetar potencialmente os resultados reais.
- Passe o cursor do rato sobre um alerta de registo, clique em more_vert Opções de alerta e selecione Carregar alerta como registo de teste. Esta ação cria um exemplo de teste para executar o seu manual simulado. As entidades modificadas em casos de teste não têm influência nas entidades em casos normais.
- Mantenha o ponteiro na parte inferior da página Playbooks e selecione um exemplo de teste. Certifique-se de que o exemplo de teste selecionado corresponde ao manual que pretende executar. Para confirmar, clique em Entidades e verifique se o manual de soluções consegue processar as entidades presentes nesse exemplo de teste.
- Clique em Executar. O simulador processa os passos, executa as ações definidas e apresenta os resultados.
Interprete os resultados do simulador para cada passo
Depois de clicar em Executar, a primeira linha na consola é apresentada como se fosse um manual de procedimentos em direto. Cada passo simulado apresenta opções, normalmente incluindo: Dados de registo, Ver resultados e Fixar resultados (ou Inserir resultados). Os passos manuais pedem um botão para introduzir parâmetros, fornecer respostas e executar o passo.
Dados do registo
O ícone Dados do registo abre uma caixa de diálogo para apresentar as informações do registo nessa fase específica, após a conclusão da ação atual. Esta caixa de diálogo é atualizada dinamicamente com os resultados do passo atual. Se uma ação adicionou o enriquecimento ao registo, vê-lo-á refletido aqui. Uma vez que mostra o estado do registo após a execução de um passo, os dados variam para cada passo na consola de simulação. A inspeção dos dados do registo em diferentes passos ajuda a compreender as alterações aplicadas ao registo durante a execução do plano de ação. Vários separadores na caixa de diálogo fornecem detalhes adicionais.
Ver resultados
A opção Ver resultados apresenta os resultados de ações específicos do passo atual. As informações apresentadas são semelhantes a uma vista geral ou a um mural de casos, e também incluem detalhes sobre quaisquer enriquecimentos.
Pode aceder a estes tipos de informações:
- O separador principal mostra a mensagem de saída, as tabelas, os links e os anexos.
- O separador Detalhes técnicos apresenta o resultado da ação e o resultado JSON (se estiver presente).
Tal como noutras opções, pode clicar nos dados para uma inspeção mais detalhada. Na página Ver resultados, também pode clicar em Definir resultado JSON. Esta funcionalidade permite-lhe substituir o exemplo JSON da ação atual. Pode modificar este exemplo de JSON diretamente no ambiente de desenvolvimento integrado (IDE) e, em seguida, usá-lo no criador de expressões para extrair dados específicos do resultado JSON.
Fixe resultados
A opção Fixar resultados está disponível quando um passo é executado com êxito. Esta é uma funcionalidade muito útil que lhe permite tratar o resultado de uma ação como fixo.
A fixação de resultados pode poupar-lhe tempo das seguintes formas:
- Eliminar a necessidade de aguardar os resultados de serviços de terceiros.
- Reduzir o número de consultas feitas a estes serviços, o que ajuda a conservar as credenciais.
Essencialmente, quando volta a executar o playbook, qualquer passo com resultados fixados é "ignorado": o respetivo código não é executado novamente e os resultados fixados são usados tal como estão. Também pode modificar este resultado inserindo os seus próprios dados simulados. Quando ativa a opção Fixar resultados, a ação entra no modo de simulação e a representação visual do passo muda normalmente de um fundo azul para cinzento, o que indica claramente que o modo Simular está ativo para esse passo.
Inserir resultados
A opção Inserir resultados fica disponível se um passo tiver falhado. Esta funcionalidade permite-lhe inserir manualmente dados de simulação. Da próxima vez que executar este passo específico, devolve os dados que forneceu manualmente como resultado.
Depois de clicar nesta opção, a ação tem automaticamente o modo Simular ativado. A representação visual do passo muda de um fundo azul para um cinzento, o que indica claramente que o modo Simular está ativo. O campo Script Result é obrigatório para todos os passos quando está no modo Simulate.
Insira dados simulados
Para inserir dados simulados, tem alguns exemplos de utilização a considerar:
- Criar e testar o seu guia rapidamente: pode executar um passo, ver os resultados e compreender imediatamente como pode usar esses dados mais adiante no seu guia.
- Poupar tempo após uma execução bem-sucedida: pode querer fixar os resultados do passo. Isto poupa-lhe tempo, pois impede que o passo seja executado repetidamente em APIs de terceiros durante os testes subsequentes.
- Testar diferentes cenários: pode alterar os resultados dos passos para testar o seu manual em várias condições. Ao definir dados de simulação diferentes, pode influenciar as condições e as ações subsequentes que dependem dos resultados anteriores. Por exemplo, se o seu manual de estratégias tiver uma condição que se ramifica em dois ou mais caminhos, pode fazer experiências com dados de simulação para "forçar" o manual de estratégias a seguir um ramo específico.
Insira dados de simulação
Pode inserir dados de simulação (fictícios) no seu manual de procedimentos de duas formas principais: através da caixa de diálogo de configuração do passo do manual de procedimentos ou usando a opção Fixar resultados (ou Inserir resultados) após a execução de um simulador.
Use a caixa de diálogo de configuração do passo do manual de estratégias
- Clique na caixa de diálogo de configuração do passo no seu playbook.
- Ative/desative o Modo de simulação. A representação visual da ação muda para cinzento, indicando que está no modo de simulação.
- Na secção Resultados da ação, pode inserir os dados de simulação (fictícios). Isto inclui:
- Resultado do script: forneça um resultado simulado para ações baseadas em scripts.
- Resultado JSON: introduza dados JSON, potencialmente extraindo dados específicos do código JSON. Também pode carregar um exemplo de resultado clicando em Carregar exemplo. Isto carrega o resultado JSON esperado da ação, o que é particularmente útil se:
- A simulação ainda não foi executada e a saída está vazia.
- A simulação falhou e não são apresentados resultados.
- Quer substituir os resultados existentes (de fixações ou inserções anteriores) pela amostra.
- Enriquecimentos: pode usar enriquecimentos de execuções de simulação anteriores ou criar as suas próprias chaves de enriquecimento personalizadas.
Use os resultados após a execução de um simulador
Fixe resultados
Se um passo for executado com êxito, pode clicar em Fixar resultados junto a essa ação. Ocorre o seguinte após:
- O passo é aberto automaticamente no modo Simular .
- Os resultados da execução de simulação bem-sucedida mais recente estão fixados ao passo. Pode usar estes resultados ou editá-los.
- Pode editar o resultado JSON através do editor JSON ou clicar em Carregar exemplo para substituir.
- Pode usar enriquecimentos de execuções de simulação anteriores ou criar chaves de enriquecimento personalizadas.
Inserir resultados
Se um passo falhou, pode clicar em Inserir resultados junto a essa ação. Ocorre o seguinte após:
- Estes dados vão ser devolvidos sempre que o passo for executado.
Desative o simulador do Playbook
Quando desativa o Simulador do Playbook, a consola inferior é ocultada, e qualquer passo no Modo de simulação reverte para o modo "em direto" normal. A exceção são os blocos de guião de testes. Tem de desativar o simulador de blocos para fechar o respetivo modo de simulação. Todos os dados de simulação (fictícios) inseridos são guardados para utilização na próxima vez que ativar o simulador.
Trabalhe com blocos de guias interativos
Também pode usar o simulador de manuais de vendas para criar e testar um novo bloco de manuais de vendas. Quando um bloco está no modo de simulação, todos os manuais de procedimentos principais que usam este bloco também usam os dados simulados do bloco.
Precisa de mais ajuda? Receba respostas de membros da comunidade e profissionais da Google SecOps.