You can learn how each condition works and which platforms support which conditions.
Select a condition to be taken to its definition. The File condition has two versions, one for Windows Rugged and QNX, the other for Android. Select the check marks for File to be taken to the platform-specific definition.
|SD Card Encryption||✓||✓|
Supported Platform: Windows Rugged – This condition type tests to see which, if any, Network Adapters are connected. This condition can be relevant if network connectivity is a scarce or expensive resource and certain operations are limited to use over certain Network Adapters or prohibited from use over certain Network Adapters.
|What would you like to do with the adapters?||
Select to use the adapters you define or exclude them.
Select to select an adapter from the list or enter the adapter by name.
|Select adapter.||Select the network adapter from the drop-down menu.|
|Specify Adapter.||Use or exclude the adapter you enter here.|
|Adapter 2/Adapter 3||Use or exclude additional adapters you enter here.|
Supported Platforms: Android, macOS, All Windows – This condition type tests for various combinations of constraints related to Network Adapters including local date, time, and frequency on the device.
|Specify scenario #1?||
Set to Specify this scenario to begin configuring the condition scenario.
Up to 5 scenarios can be entered, each with their own constraint choices.
Each Scenario is an OR statement and each option inside a Scenario is an AND statement. For example, a device monitors whether Scenario #1 OR Scenario #2 is true. If Scenario #1 is true, it reviews if all the constraints listed are true because they are AND statements.
|Scenario description||Enter a description for the adapter time scenario.|
|Constrain Network Adapters?.||
Set to Constrain based on the Best Connected Network Adapter and configure the following.
If you want to skip this kind of constraint, then select Don't constrain based on the Best Connected Network Adapter. Then you can proceed with defining another kind of constraint.
|Constrain days of week?.||For each day of the week, select whether it is included or excluded.|
|Constrain months?.||For each month, select whether it is included or excluded.|
|Constrain days of month?.||Enter a Start day of month? and an End day of month?.|
|Constrain years?.||Enter a Start year? and an Last year?.|
|Constrain time of day?.||Enter the Start hour?, Start minute?, End hour?, and End minute?.|
|Set frequency limit?.||
Ranges from Every 15 Minutes to Every 1 Week.
|Set frequency limit?.||
Ranges from Every 15 Minutes to Every 1 Week.
Set frequency limit is a mandatory setting. The Adapter Time condition will not function correctly without it.
Supported Platforms: Android and Windows Rugged – This condition type tests the device to see what level battery charge remains. You can test for charge levels under a defined threshold or over a defined threshold.
|Battery Level||Select between Less than or Equal To, Greater Than or Equal To, and Between to define a range of charge levels.|
|Battery Percentage||Enter a percentage between 1 and 100. When Between is selected, you must enter a range comprised of two percentage levels.|
Supported Platform: Windows Rugged – This condition tests the device for the type of connection and the length of time it has been connected.
|the device is connected to.||Select between Wi-Fi and Cellular.|
|the device is continuously.||
Two selections must be made.
First, select whether to test if the device has been Connected or Disconnected.
Next, select the length of time it has been in such a state.
Supported Platforms: Android, macOS, Windows Rugged – This condition type prompts the end user to determine whether the condition is met. This prompt is customizable so you can control what displays on the prompt.
|First line prompt||
Enter a header of the prompt.
|Second line prompt||
Enter the body of the prompt.
Enter the subheading of the prompt (macOS Only).
|Third line prompt||
If you enable a countdown, you can enter a countdown phrase into this setting.
For example, "You have %count% seconds to comply" where %count% is the countdown.
Enter the body of the prompt into the Third Line Prompt (Mac OSX Only).
|Allow users to cancel actions?||
Select Yes if you want to give users a chance to opt out of the action upon which this condition is placed.
Select No and obligate users to accept the action.
Delay for a specified time or until the end user makes a selection.
If you enter a non-zero value, the prompt waits for that value worth of seconds. Then if the end user does not make a selection in the time allowed, the condition is automatically considered not met.
If a value of zero is entered, then the prompt displays indefinitely until the user makes a selection.
Select Yes and allow the delay time to be “counted” down on the device so the end user knows how much time is remaining to make a selection.
Select No and hide the delay countdown.
The minimum time after the condition is not met before the end user is prompted again to determine the state of this condition.
If a non-zero value is entered, the end user is not prompted again for at least this number of seconds.
If a value of zero is entered, then the end user might be prompted again when the next execution of the Check-In command.
|Maximum number of defers||
The maximum number of times the condition is not met.
After the condition is not met this number of times, it is either met or failed, depending on the setting of the next feature.
If a value of zero is entered, then the condition is met or failed on the first time.
|Action after maximum defers.||
Select the action to trigger after the maximum number of defers is met.
Supported Platforms: QNX and Windows Rugged – This condition type tests the device to see if a file is present or not. You can set the condition to test if the file is on the device, and if it is, test true. You can also set the condition to test true if a file is not on the device. Finally, you can set the condition to create a flag file and save it on the device for use with third-party programs.
|Specify Flag File||Set to Specify Flag File to enable the use of a flag file for use with third-party programs.|
|Specify Flag File Location||Enter a location path for the flag file.|
|Specify Flag File Contents||Enter the content you want in the flag file.|
|Specify Scenario #1||Set to Specify this scenario to enable testing a file's existence on the device.|
|Test File||Enter the name of the test file the condition tests.|
|Test Type||Test whether the File Exists or the File Does Not Exist.|
|Remove File||Either Remove File or Do Not Remove File when the test finishes.|
Supported Platform: Android – This iteration of the file condition is specific to Android, but it still tests the device to see if a file is present or not. You can set the condition to test if the file is on the device, and if it is, test true. Alternatively, if a file is not on the device, you can also set the condition to test true.
|File Name||Enter the name of the file the system searches for, including device path. The system searches for this file before it downloads or installs product components.|
|Condition Met When||Select whether the system downloads or installs based on the existence of the file (File Found) or nonexistence of the file (File Not Found).|
|Frequency||Select how often the system searches for this file.|
|Duration||Select how long this condition performs the action.|
|After Duration Exceeded||Select how to proceed after the condition duration period elapses.|
Supported Platform: Windows Rugged – This condition type tests the device for the level of system memory that is available.
|Available memory is less than||Enter a percentage of available memory such that your action only runs if the device has less than the indicated amount.|
Supported Platforms: Android and All Windows – This condition type tests how a device is being powered, including whether the device is plugged in or has a full battery level. Use a Power condition type to prompt users to place the device into the cradle or to insert a charged replacement battery. If your testing needs are particular, the Battery Threshold condition (Android and Windows Rugged only) offers more granular battery tests than Power offers.
|First line prompt||Enter a header for the prompt.|
|Second line prompt||Enter the body of the prompt.|
|Third line prompt||
If you enable a countdown, you can enter a countdown phrase into the Third line prompt text box.
For example, "You have %count% seconds to comply" where %count% is the countdown clock.
|Required power level||
Enter the required power level for the condition to test true.
Use this to delay for a specified time or until the end user makes a selection.
If you enter a non-zero value, the prompt waits for that value worth of seconds. If the end user does not make a selection in the time allowed, the condition is automatically considered not met.
If a value of zero is entered, then the prompt displays indefinitely until the end user makes a selection.
|Enable countdown?||This allows delay time to be “counted” down on the device so the end user knows how much time is remaining for the user to make a selection.|
Supported Platform: Android – Rather than set an event action to begin based on a specific device condition, you can simply assign it to a recurring schedule.
|Scheduled Interval||Select from Hourly, Daily, and Weekly as the basis for the recurrence.|
|Number of hours / days / weeks between events||
Enter the number of hours, days, or weeks between events.
For example, if you want an event action to run every other Wednesday, then select Weekly, enter 2 in this text box, then select Wednesday as the Day of event occurrence.
After the product with this condition is activated, the recurring schedule begins as soon as is administratively possible. Continuing the above example, the recurring schedule begins the first Wednesday after you activate the product that uses this condition.
|Sunday through Saturday||Select Yes for each day you want the event action to start.|
|Start Time.||Enter the time of day the event action starts.|
Many things can delay an event action from starting such as the device being offline or a previous event still in progress. When the device is ready, you can allow the event action to always start or set an end time at which point the device waits until the next start time.
Enter the time of day the event action stops making start attempts until the next scheduled start time.
|Disable end time.||Select Yes to disable end time. This option causes the device to make continued attempts to start the event action until it succeeds.|
Supported Platforms: Android, Windows 7, and Windows Desktop – This condition type tests the device date and time against a specific date/time entered. When the date/time is met, the condition passes and allows the download.
|Date||Select the specific date from the drop-down calendar.|
|Time||Select the specific hour and minute from the drop-down menu.|
Supported Platforms: Android, Windows 7, and Windows Desktop – This condition type tests whether the device's SD card is encrypted or not encrypted. This condition can be relevant if you must wait for the SD card to be encrypted before downloading a file.
|SD card is||
Select Encrypted or Unencrypted and limit the product based on the state of the SD card encryption.
Supported Platforms: Android, QNX, and Windows Rugged – This condition type tests the local date and time on a device.
Select the month, day and yearStartFinish.
Select Month, Day, and Year for both Start and Finish.
|Select hour and minuteStartFinish.||Select Hour and Minute for Start and Finish.|
|Enable time check 2?.||Select Yes to display a second set of options identical to the First Time Slot.|
|Enable time check 3?.||Select Yes to display a third set of options identical to the First Time Slot.|