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
If et Loop sont des constructions de branches dans Automation 360. Ils sont utilisés pour exécuter une séquence d’actions lorsqu’une condition est définie sur vrai
. Une condition est utilisée avec les If et les packages Loop. Une condition prend un ensemble d’entrées et renvoie une valeur booléenne.
Annotations requises
Pour créer une condition, les annotations suivantes sont requises :
Annotation | Utilisation |
---|---|
BotCommand |
Utilisez l’annotation BotCommand avec la condition comme commandType . Cela garantit 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 requis et aidez au contrôle de validation, ou ils peuvent être affichés dans l’interface pour l’entrée. 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 sera ignorée si elle n’est pas accompagnée de l’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 les 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.
- Créez la classe POJO avec la logique métier :
public class IsGreater { public Boolean checkGreater(Double first, Double checkAgainst) { return first > checkAgainst; } }
- 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; } }
- 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.
- Annotez les paramètres de la méthode
checkGreater
avecIdx
etPkg
.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 renvoie un
Double
.