Criação de uma regra de análise

Preencha as variáveis de saída definidas em uma atividade personalizada com dados de carga retornados de um teste de entradas em um host externo ou endpoint.

Antes de Iniciar

Funções necessárias: activity_admin, activity_creator

Por Que e Quando Desempenhar Esta Tarefa

Procedimento

1. Navegar até Todos > Workflow > Editor de fluxo de trabalho.
2. Na guia Personalizado na paleta, abra uma atividade personalizada.
3. No formulário Designer de atividades, avance para a fase de Saída.
4. Arraste uma variável de saída do construtor de estrutura de dados para o campo Nome da variável no construtor de regras de análise.

   Figura 1. Mapeamento de variáveis para regras de análise

   

   O formulário de regras de análise aparece para a variável selecionada. Por padrão, o tipo de análise é definido como Direto, o que preenche a variável com todos os dados da carga selecionada, sem analisar o conteúdo. Cada modelo tem uma origem de análisepadrão específica.

5. Preencha o formulário usando os campos da tabela.
   Neste exemplo, o tipo de análise selecionado é XML, o que permite selecionar parâmetros específicos da carga para analisar.

   

   Tabela 1. Campos de regras de análise

   Campo	Descrição
   Analisando origem	Origem dos dados retornados do host ou endpoint de destino. Cada modelo é aberto para uma carga padrão específica. As opções disponíveis dependem do modelo de execução selecionado para a atividade. Você também pode usar variáveis locais como uma origem de análise se uma regra de análise tiver sido definida para elas. Para obter uma lista das cargas disponíveis para cada modelo, consulte Origens de análise do designer de atividades.
   Expressão	Expressão usada para extrair dados específicos da origem de análise selecionada. Esta expressão é criada a partir de dados clicáveis na carga de amostra e aparece no formato selecionado no campo Tipo de análise. Ao testar, a expressão pode retornar vários resultados. Verifique qual opção fornece resultados confiáveis ou previsíveis antes de escolher sua expressão. Nota: O sistema não pode gerar expressões RegEx clicáveis a partir de dados de amostra. Você deve gravar todas as expressões regulares manualmente.
   Nome da variável	Nome da variável revisada conforme usado na expressão de saída final. O sistema adiciona o prefixo activityOutput ou activityLocal à variável especificada.
   Tipo de análise	A linguagem a ser usada para consultar a carga do host de destino. As seleções são: Direta: mapeia para todo o conteúdo da carga selecionada no campo de origem de análise, sem qualquer análise. Esse é o tipo de análise padrão. XML: consulta XPath usada para selecionar nós de uma carga XML. JSON: consulta JSONPath para selecionar partes de uma carga JSON. RegEx: método de análise que usa uma expressão regular para extrair dados de uma carga. O tipo de análise RegEx não oferece suporte à análise de várias linhas e não faz distinção entre maiúsculas e minúsculas.
   Descrição resumida	Descrição resumida desta regra de análise.
   Exemplo de dados de carga	Dados de amostra da origem que contém os dados solicitados. Este campo não está disponível para tipos de análise direta. Depois de clicar em Analisar dados de amostra, os dados neste campo não podem ser editados, mas se tornam clicáveis para a finalidade de criar expressões. Clique em Editar dados de amostra para tornar o campo editável novamente.
   Resultados da análise	Exibe os dados retornados da origem pela expressão selecionada. Este campo não está disponível para tipos de análise direta.

6. Para testar novamente as entradas, clique em Obter carga de amostra do teste.
   Esta ação reabre o formulário de teste, permitindo que você substitua diferentes valores de teste e crie uma carga diferente.
7. Clique em Salvar para que as regras de análise substituam a carga anterior pela que você acabou de criar.
8. Para criar uma expressão para a regra de análise, clique no parâmetro específico que você deseja ver na carga de amostra.
   O valor desse parâmetro aparece no campo Resultado da análise e o sistema cria a expressão apropriada no campo Expressão.
9. Clique em Enviar para salvar a regra de análise dessa variável.

Origens de análise do designer de atividades

Esta tabela lista as origens de análise disponíveis com cada modelo de execução.

Tabela 2. Origens de análise

Modelo	Fonte
SOAP Web Service	executionResult.body (Padrão) executionResult.status_code executionResult.header executionResult.error
JDBC	executionResult.output (Padrão) executionResult.errorMessages executionResult.probeCompletedEccId executionResult.totalRows
JavaScript Probe	executionResult.payload (Padrão) executionResult.output executionResult.eccSysId executionResult.errorMessages
Powershell	executionResult.output (Padrão) executionResult.tags executionResult.hresult executionResult.eccSysId executionResult.errorMessages
Serviços web REST	executionResult.body (Padrão) executionResult.status_code executionResult.header executionResult.error
SFTP	executionResult.output (Padrão) executionResult.eccSysId executionResult.errorMessages executionResult.tags
Probe	executionResult.output (Padrão) executionResult.payload executionResult.eccSysId
SSH	executionResult.output (Padrão) executionResult.eccSysId executionResult.errorMessages executionResult.tags
JMS	executionResult.status executionResult.standardHeaders executionResult.customHeaders executionResult.messagePayload executionResult.eccSysId executionResult.errorMessages

Exemplo de regra de análise do designer de atividades

Neste exemplo, a regra de análise é configurada para preencher a variável activityOutput.ipv4 com o valor do endereço IP de um servidor de domínio, usando o PowerShell.

Antes de Iniciar

Função necessária: activity_creator, activity_admin

Por Que e Quando Desempenhar Esta Tarefa

Para gerar os dados de amostra, o administrador deve executar o comando no host e colar os dados retornados no campo Dados de carga de amostra ao criar a regra de análise. O administrador pode criar uma expressão que retorna endereços IP dessa amostra em dois formatos: ipv4 e ipv6. Neste exemplo, o sistema produz duas expressões a serem usadas para a regra de análise.

Procedimento

1. Navegar até Todos > Workflow > Editor de fluxo de trabalho e abra a atividade que é executada no host.
2. Clique na guia Entradas e observe o Comando.

   Figura 2. Regra de análise do comando de entradas do PowerShell

   

3. Em um console do PowerShell, execute o comando no host para extrair a amostra XML que contém os valores necessários.
4. Copie os dados que são retornados para a área de transferência.
5. No designer de atividades, clique na guia Saídas e cole os dados retornados no campo Dados de carga de amostra.

   Neste exemplo, os dados incluem endereços IP em dois formatos diferentes e o nome do domínio.

6. Selecione o tipo de análise para a origem.
   No exemplo a seguir, você selecionaria XML.

   

7. Clique em Analisar dados de amostra

   O sistema exibe o XML no formato apropriado e ele se torna clicável. Nesta exibição, o sistema pode converter os dados clicados da amostra em uma expressão.

   

8. Para criar a expressão, clique nos elementos da amostra de dados que você deseja mapear para a variável.

   Com base nos dados de amostra em que você clicou, o sistema cria duas expressões.

   

9. Selecione uma expressão na lista.

   O resultado desejado é o endereço IP que tem um atributo de tipo de ipv4. O sistema preenche o campo Expressão com esta opção.

   

10. Clique em Testar expressão.

    O sistema analisa a carga usando a expressão selecionada e retorna os dados solicitados no campo Resultado da análise.

    

11. Clique em Enviar.

    A exibição retorna para a guia Saídas do Designer de atividades. A nova regra de análise é listada e uma linha em branco é disponibilizada para outra regra.