Créer une condition à l'aide du package SDK

Lorsque vous utilisez Automation 360, vous pouvez créer une condition avec le package SDK.

Utilisation d'une condition

Si et Boucle sont des constructions de branches dans Automation 360. Elles sont utilisées pour exécuter une séquence d'actions lorsqu'une condition est définie sur true. Une condition est utilisée avec les packages Si et Boucle. Une condition prend un ensemble d'entrées et retourne une valeur booléenne.

Annotations obligatoires

Pour créer une condition, les annotations suivantes sont obligatoires :

Annotation Utilisation
BotCommand Utilisez l'annotation BotCommand avec la condition commandType. Cette opération permet de garantir que l'ancien objet Java (POJO) est adapté à la création d'une condition Automation 360.
CommandPkg Ces valeurs sont utilisées lors de la création d'un package. Fournissez un nom, une étiquette et une description à l'annotation.
Idx Annotez tous les paramètres et variables membres qui sont obligatoires et aident au contrôle de validation, ou ils peuvent être affichés dans l'interface pour être saisis. Fournissez l'index (Idx) et le type.
Pkg Annotez tous les paramètres et variables membres qui seront affichés dans l'interface. Cette annotation est ignorée si elle n'est pas accompagnée de Idx.
ConditionTest La méthode qui doit être appelée pour tester la condition. Elle doit renvoyer une valeur booléenne. Si la méthode accepte des paramètres, annotez-les avec Idx.

Exemple de cas d'utilisation

Le cas d'utilisation suivant vérifie si le nombre donné est supérieur à l'autre nombre.

  1. Créez la classe POJO avec la logique métier :
    public class IsGreater {
    
    	public Boolean checkGreater(Double first, Double checkAgainst) {
    		return first > checkAgainst;
    	}
    
    }
  2. Annotez la classe POJO pour l'activer pour la condition Automation 360 et pour créer le package :
    @BotCommand(commandType = Condition)
    @CommandPkg(label = "Is greater condition", name = "IsGreater",
    	description = "Checks if the given number is greater than the other.", node_label = "{{first}} > {{checkAgainst}} ")
    public class IsGreater {
    	public Boolean checkGreater(Double first, Double checkAgainst) {
    		return first > checkAgainst;
    	}
    }
  3. Annotez la méthode checkGreater pour indiquer que cette méthode doit être utilisée comme méthode de comparaison.
    @ConditionTest
    public Boolean checkGreater(Double first, Double checkAgainst) {
    	return first > checkAgainst;
    }

    Chaque condition doit avoir exactement une méthode de condition de test.

  4. Annotez les paramètres de la méthode checkGreater avec Idx et Pkg.

    Ajoutez @NotEmpty pour vous assurer que la valeur n'est pas nulle.

    @ConditionTest
    public Boolean checkGreater(
    	@Idx(index = "1", type = AttributeType.NUMBER) @Pkg(label = "Number to check") @NotEmpty Double first,
    
    	@Idx(index = "2", type = AttributeType.NUMBER) @Pkg(label = "Number to compare against") @NotEmpty Double checkAgainst) {
    
    	return first > checkAgainst;
    }

    Le numéro du type d'attribut retourne un Double.