Status Conditions are triggered when the status of an associated command becomes equal to a predefined value.

Overview

A Status Condition is related to an automation command that is capable of indicating its execution status. For each condition instance you have to set a target command (the one which is controlled by the condition) and a target status. If the command completes with this status, the condition becomes satisfied.

Managing Status Conditions

Via Java API

After creating a condition as described in Managing Conditions  you can configure it by using the following methods:

• setCommandType - Excepts the type of the command, that the condition listens for.
• SetCommandId - Excepts the unique ID of the command that the condition listens for.
• SetStatus - The status string that when returned by the command, triggers the condition. Can be set to "OK" (Command.STATUS_OK), "exception" (Command.STATUS_EXCEPTION), "ERROR" (Command.STATUS_ERROR) or some custom status, related to the specific command type.

After you configure your condition, call the save method. The Condition Provider will save the condition in Config Tree

Via ConfigTree

All conditions are stored in the Config Tree, which allows you to import/export them and to add/edit them by simply creating and modifying XML files.

The following snippet contains a Status condition that is triggered when a log command with an ID LogCommand1 returns an error status.

<config name="StatusCondition1">

  <property key="command_type" value="LogCommand" type="string"/>

  <property key="status" value="ERROR" type="string"/>

  <property key="command_id" value="LogCommand1" type="string"/>

</config>