You can learn how each condition works and which platforms support which conditions.

Platform-Specific 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.

Windows 7 Windows
Condition Android macOS QNX & Desktop Rugged
Adapter        
Adapter Time  
Battery Threshold      
Confirm    
Connectivity State        
File –––>    
Memory Threshold        
Power    
Recurring Schedule
Schedule      
SD Card Encryption      
Time    

Adapter

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.

Settings

Descriptions
What would you like to do with the adapters?

Select to use the adapters you define or exclude them.

  • Only use these adapters to connect.
  • Exclude these adapters from connecting.
Adapter 1

Select to select an adapter from the list or enter the adapter by name.

  • Select From List.
  • Enter 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.

Adapter Time

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.

Settings Description
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.

  • Specify any Included or Excluded Network Adapters.
    • Either Select Network Adapter Class from a drop-down list or Type in a Network Adapter Name.
  • Up to five network adapters can be selected in the Adapter selection method? setting.
    • For each adapter you want to include/exclude, Select a Network Adapter Class drop-down menu and entering a specific Adapter name.

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.

Note: ActiveSync and VPN Network Adapters are not supported under the Android platform.

Battery Threshold

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.

Settings Description
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.

Connectivity State

Supported Platform: Windows Rugged – This condition tests the device for the type of connection and the length of time it has been connected.

Settings Description
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.

Confirm

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.

Table 1. Message to Be Displayed (Confirm)
Settings Description
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.

Table 2. Delay (Confirm)
Settings Description
Delay (seconds)

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.

Enable countdown?

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.

Table 3. Defer Action (Confirm)
Settings Description
Defer time.

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.

  • Fail Condition.
  • Display Cancel Button.
  • Pass Condition.

File (1)

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.

Settings Description
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.

File (2)

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.

Settings Description
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.

Memory Threshold

Supported Platform: Windows Rugged – This condition type tests the device for the level of system memory that is available.

Settings Description
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.

Power

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.

Table 4. Message to Be Displayed (Power)
Settings Description
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.

Table 5. Condition (Power)
Settings Description
Required power level

Enter the required power level for the condition to test true.

  • A/C.
  • A/C or Full Battery.
Table 6. Delay (Power)
Settings Description
Delay (seconds).

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.

Recurring Schedule

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.

Settings Description
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.

Table 7. Days of Event Occurrence (Weekly Only), Recurring Schedule
Settings Description
Sunday through Saturday Select Yes for each day you want the event action to start.
Table 8. Start and End Time (Daily and Weekly Only), Recurring Schedule
Settings Description
Start Time. Enter the time of day the event action starts.
End Time.

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.

Schedule

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.

Settings Description
Date Select the specific date from the drop-down calendar.
Time Select the specific hour and minute from the drop-down menu.

SD Encryption

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.

Settings Description
SD card is

Select Encrypted or Unencrypted and limit the product based on the state of the SD card encryption.

Time

Supported Platforms: Android, QNX, and Windows Rugged – This condition type tests the local date and time on a device.

Table 9. First Time Slot (Time)
Settings Description

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.
Table 10. Second Time Slot (Time)
Settings Description
Enable time check 2?. Select Yes to display a second set of options identical to the First Time Slot.
Table 11. Third Time Slot (Time)
Settings Description
Enable time check 3?. Select Yes to display a third set of options identical to the First Time Slot.