Alternative Actions
Alternative actions are used in place of the primary action during a specified time or repetition interval.
Example:
If a device is found to be on the wrong version of iOS and needs to be upgraded, Assemble can be configured to warn the user with a push message for X hours using an alternative action. Each time Assemble runs, it will check if the device is still running the wrong version. If it is, Assemble will continue to warn the user until X hours have elapsed. Once the set interval has elapsed, the primary action will be taken such as block ActiveSync.
The intervals available are minutes, hours and repetitions.
|
Action |
Description | Values |
| alt_id | The key alt_id is the unique identifier for tracking alternative action intervals and must be unique for each rule. It can be set with any alphanumeric string. If multiple Assemble rule files are in use, the alt_id must be unique across all rule INI files. | Examples:alt_id=rules.ini_rule1alt_id=1245 |
| alt_interval | The key alt_internal determines the time or repetitions to apply the alternative actions and settings for matching devices.The available intervals are minutes, hours and repetitions (Assemble runs).Once the interval has been exceeded, the primary action will be applied. The alternative action will not ever be applied again once the interval has been exceeded, unless the key alt_exceeded_interval is set.The intervals are recorded for each device in the file devicehistory.ini. | Example:alt_interval=minutes:60alt_interval=hours:48alt_repetitions:5 |
| alt_exceeded_interval | This optional key determines the how long the alternative action is ignored once it has exceeded its interval.The available intervals are minutes, hours and repetitions (Assemble runs).Once the interval has been exceeded, the alternative action and its interval will once again be applied. This essentially resets the alternative action interval.The intervals are recorded for each device in the file devicehistory.ini. | Example:alt_exceeded_interval=hours:168 |
| alt_action | See the primary key with the same name in Actions. | |
| alt_wakeup | See the primary key with the same name in Actions. | |
| alt_sendmessage | See the primary key with the same name in Actions. | |
| alt_sendmessagetext | See the primary key with the same name in Actions. | |
| alt_message_days | This key will skip sending messages to devices and only send messages to devices on specific days when using alternative actions and the action is set to "message". The use case for this key is to send warning compliance messages to devices during the alternative action time interval only on specific days instead of every time Assemble is run. | alt_message_days=0,5,15 |
| alt_actionreason | See the primary key with the same name in Actions. | |
| alt_sendmessagesms | See the primary key with the same name in Actions. | |
| alt_sendmessagesmstext | See the primary key with the same name in Actions. | |
| alt_sendmessageemail | See the primary key with the same name in Actions. | |
| alt_sendmessageemailtext | See the primary key with the same name in Actions. | |
| alt_sendmessageemailsubject | See the primary key with the same name in Actions. | |
| alt_reportsend | See the primary key with the same name in Actions. | |
| alt_reportmessage | See the primary key with the same name in Actions. | |
| alt_syslogsend | See the primary key with the same name in Actions. | |
| alt_syslogmessage | See the primary key with the same name in Actions. | |
| alt_syslognotice | See the primary key with the same name in Actions. | |
| alt_SendMessageSMTPEmail | See the primary key with the same name in Actions. | |
| alt_SendMessageSMTPEmailText | See the primary key with the same name in Actions. | |
| alt_SendMessageSMTPEmailSubject | See the primary key with the same name in Actions. |