O evento Assert é uma ferramenta de depuração, semelhante ao evento condicional , que testa a lógica da cadeia e valida se ela funciona conforme o esperado. No nível mais básico, uma ramificação de cadeia continuará ininterruptamente quando uma asserção for aprovada e parará quando uma asserção falhar, mas há várias condições que afetam essa regra. Você pode encontrar uma lista de casos de uso comuns no final deste artigo.
Etapa 1. Adicionar o evento à cadeia
- Em Construtor de Cadeia, na guia Cadeias device_hubEditar criar
- Clique em Chain Events e mova Assert para o local onde o evento deve ocorrer na cadeia.
- Arraste um link para o evento do nó anterior na cadeia.
Observação: Para alterar a posição de um nó na cadeia, desvincule-o de outros nós e, em seguida, mova-o para o local onde ele deve ocorrer. Para mover vários nós de uma vez, mantenha pressionado SHIFT enquanto você os seleciona.
- Selecione o nó do evento e clique em Editar .
- Em Informações básicas, insira um nome e uma descrição exclusivos para ajudar a identificar o evento.
Observação: Ative Stop Chain on Fail se toda a cadeia deve ser interrompida quando essa afirmação falhar. Se você não marcar a opção, outras ramificações em cadeia serão executadas até a conclusão, mesmo que essa em particular falhe.
Etapa 2: configurar a lógica condicional
Em Condições, crie a lógica condicional como regras ou grupos de regras para testar saídas e variáveis de vários tipos de dados:
- String, para um ou mais caracteres
- Integer, para qualquer valor numérico inteiro, não decimal
- Date, para uma string ou variável de data
- Float, para qualquer valor numérico
- JSON, para Javascript Object Notation
Observação: Para JSON, use uma transformação de variável para analisar valores.
- Selecione se você deseja adicionar uma regra Rule ou Group de regras.
- Se você incluir várias regras ou grupos, junte-os com um booleano AND ou OR:
- Se todas as regras ou grupos de tiverem de ser verdadeiros para que a condição seja aprovada, selecione E.
- Se qualquer regra ou grupo de deve ser verdadeiro para que a condição seja aprovada, selecione OU.
- Para cada regra, selecione o tipo de dados e a saída ou variável a ser testada e defina seus critérios para passar na condição:
- Para testar se o valor está em branco, selecione Is blank ou Is not blank.
- Para testar se o valor inclui caracteres específicos ou outro valor de saída ou variável, selecione Contains e digite ou selecione o valor a ser correspondido.
- Para testar se o valor corresponde a uma expressão regular, selecione Matches RegExp e digite a expressão a ser correspondida.
- Para testar se o valor começa ou termina com caracteres específicos ou com outro valor de saída ou variável, selecione Start with ou Ends with e digite ou selecione o valor a ser correspondido.
- Para testar se um valor numérico é igual a uma quantia, selecione = ou != e digite ou selecione a quantia.
- Para testar se um valor numérico é maior ou menor que um valor, selecione < ou > e digite ou selecione o valor.
- Para testar se um valor numérico é maior, menor ou igual a um valor, selecione <= ou >= e digite ou selecione o valor.
- Depois que você configurar a lógica condicional, clique em Salvar.
Observação: Para remover uma regra da lógica condicional, clique em Excluir .
Condições e casos de uso comuns
O evento Assert pode ser adicionado a vários caminhos ou "ramificações" de uma cadeia. Cada asserção opera de forma independente, o que significa que uma asserção com falha interromperá apenas o ramo específico em que foi colocada - todos os outros ramos continuarão a ser executados até a conclusão. No entanto, se uma única asserção falhar, toda a cadeia será marcada como "Failed" (Falha).
Coisas para saber
- Ative a opção Stop chain on fail para interromper imediatamente toda a cadeia quando houver falha em uma afirmação.
- Você pode substituir uma falha de cadeia adicionando um evento Set Chain Result. Quando um nó Set Chain Result for definido como "Succeed", a cadeia sempre será aprovada, independentemente de qualquer falha nas asserções.
Condição |
Resultado |
Explicação |
|---|---|---|
| A asserção é aprovada | A execução continua; a cadeia é bem-sucedida | A execução em cadeia continua sem interrupção. |
|
Falha na asserção (asserção única) |
Falha na execução; falha na cadeia |
Quando uma única asserção é colocada em um caminho de cadeia, a execução em cadeia é interrompida quando a asserção falha. Exemplo: (Clique para ampliar) Observação: Um evento Assert pode ser usado como uma "guarda" que interrompe uma cadeia antes de pontos críticos se uma condição não for atendida. Quando um evento Assert for uma dependência dos nós subsequentes, toda a cadeia será interrompida. |
|
Falha na asserção (com a opção "Parar a cadeia em caso de falha" ativada) |
A execução falha; a cadeia falha; a cadeia é interrompida imediatamente |
Quando a opção "Stop Chain on Fail" estiver ativada e essa afirmação falhar, todas as outras ramificações serão imediatamente interrompidas. Exemplo: (Clique para ampliar) |
|
Falha na asserção (várias ramificações/afirmações) |
A execução da cadeia é interrompida no ramo com falha, mas continua em todos os outros ramos até que uma condição Guard/Stop seja atendida; a cadeia falha |
O evento Assert pode ser colocado em vários caminhos ou "ramificações" dentro da mesma cadeia. Uma asserção com falha interromperá esse ramo específico, mas todos os outros ramos continuarão a ser executados. Isso permite que você teste várias condições dentro da mesma cadeia. Exemplo: (Clique para ampliar) |
Evento de afirmação vs. evento condicional Evento condicional
O evento Conditional, quando combinado com o evento Set Chain Result, pode ser usado para obter resultados semelhantes, mas são necessários vários nós e caminhos de ramificação em relação ao evento Assert. O evento Assert tem o objetivo de simplificar e substituir esse processo mais complexo.
Para demonstrar, aqui está um exemplo da lógica típica necessária para recriar uma ramificação "Pass" e "Fail" com um evento condicional:
E aqui está a mesma lógica usando um único evento Assert:
Observação: Quando usado na mesma cadeia, o evento Definir resultado da cadeia sempre substituirá os resultados de um evento Assert. Por exemplo, uma cadeia com um nó Set Chain Result definido como "Succeed" sempre será aprovada, independentemente do evento Assert.