Création d’un déclencheur à l’aide du package SDK

Utilisation d’un déclencheur

Utilisez Automation 360 pour créer un déclencheur. Un déclencheur lance un bot lorsque certaines conditions sont remplies et attend que les conditions aient changé ou soient arrêtées. Lorsque les conditions du déclencheur correspondent, la méthode d’exécution est appelée pour signaler le déclencheur.

Annotations requises

Pour créer un déclencheur, les annotations suivantes sont requises :

Exemple de cas d’utilisation

Le cas d’utilisation suivant montre comment créer un déclencheur de minuterie qui déclenche un bot à intervalles réguliers.

1. Créez la classe POJO avec la logique métier :

   public class TriggerDemo {
   	
   	private static final Timer TIMER = new Timer(true);
   	
   	public void startTrigger(Double interval) {
   		TimerTask timerTask = new TimerTask() {
   
   			@Override
   			public void run() {
   				// Do nothing
   
   			}
   		};
   
   		TIMER.schedule(timerTask, interval.longValue());
   	}
   
   }

   Plusieurs déclencheurs du même type peuvent exister dans un bot. Tous les déclencheurs sont identifiés par un triggerId.

2. Ajouter un triggerId à la classe :

   @TriggerId
   	private String triggerUid;
   	
   	public String getTriggerUid() {
   		return triggerUid;
   	}
   
   	public void setTriggerUid(String triggerUid) {
   		this.triggerUid = triggerUid;
   	}

3. Stockez la TimerTask séparément afin que lorsque vous souhaitez arrêter un déclencheur spécifique, utilisez le triggerId.

   private static final Map<String, TimerTask> taskMap = new ConcurrentHashMap<>();
   	
   	public void startTrigger(Double interval) {
   		TimerTask timerTask = new TimerTask() {
   
   			@Override
   			public void run() {
   				// Do nothing
   
   			}
   		};
           taskMap.put(this.triggerUid, timerTask);
   		TIMER.schedule(timerTask, interval.longValue());
   	}

4. Démarrez un déclencheur lorsque les conditions sont remplies. Acceptez un fichier exécutable et appelez-le de manière appropriée.

   @TriggerRunnable
   	private Runnable runnable;
   	
   	public Runnable getRunnable() {
   		return runnable;
   	}
   
   	public void setRunnable(Runnable runnable) {
   		this.runnable = runnable;
   	}
   	
   	public void startTrigger(Double interval) {
   		TimerTask timerTask = new TimerTask() {
   
   			@Override
   			public void run() {
   				runnable.run();
   
   			}
   		};
           taskMap.put(this.triggerUid, timerTask);
   		TIMER.schedule(timerTask, interval.longValue());
   	}

5. Arrêtez le déclencheur, soit individuellement (utilisez un triggerId), soit tous les déclencheurs en même temps (StopAllTriggers).

   /*
   	 * Cancel all the task and clear the map.
   	 */
   	@StopAllTriggers
   	public void stopAllTriggers() {
   		taskMap.forEach((k, v) -> {
   			if (v.cancel()) {
   				taskMap.remove(k);
   			}
   		});
   	}
   
   	/*
   	 * Cancel the task and remove from map
   	 *
   	 * @param triggerUid
   	 */
   	@StopListen
   	public void stopListen(String triggerUid) {
   		if (taskMap.get(triggerUid).cancel()) {
   			taskMap.remove(triggerUid);
   		}
   	}

6. Ajoutez les annotations restantes.

   @BotCommand(commandType = BotCommand.CommandType.Trigger)
   @CommandPkg(label = "Demo Trigger", description = "Demo Trigger", icon = "email.svg", name = "demoTrigger")
   public class TriggerDemo {
   //Other code
   
   	@StartListen
   	public void startTrigger(@Idx(index = "1", type = AttributeType.NUMBER)
   	@Pkg(label = "Please provide the interval to trigger in seconds", default_value = "120", default_value_type = DataType.NUMBER)
   	@GreaterThan("0")
   	@NumberInteger
   	@NotEmpty
   	Double interval) {
   	//Other code
   	}
   
   }