Conditions enable you to set products to download and install on your device only when preset conditions are met. Create a condition to determine when a product downloads and installs onto your devices.

To create a condition, take the following steps.

  1. Navigate to Devices > Staging & Provisioning > Components > Conditions and select Add Condition.

  2. Select the Platform you want to create a condition for.

  3. Complete the Create Condition Type settings.

    Settings Description
    Name Enter a name for the condition. The name cannot be longer than 255 characters.
    Description Enter a description for the condition.
    Condition

    The type of condition affects the parameters on the Condition Details tab.

    • Adapter
    • Adapter Time
    • Battery Threshold*
    • Connectivity State*
    • Confirm
    • File
    • Memory Threshold*
    • Power
    • Schedule
    • SD Card Encryption
    • Time

    * Condition is only available for use in Event Actions. For more information, see Event Actions.

    Managed By Select the organization group that manages the condition.
  4. Select Next.
  5. Complete the Create Condition Details settings based on the condition type chosen.

    • Adapter – This condition type tests to see which, if any, Network Adapters are connected. This can be relevant if network connectivity is a scarce or expensive resource and certain operations should be 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?

      Choose to use the adapters you define or exclude them.

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

      Choose 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 list.
      Specify Adapter Enter the adapter name to use or exclude.
      Adapter 2/Adapter 3 Choose to use or exclude additional adapters.
    • Adapter Time – 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 may be entered, each with their own constrain choices.

      Each Scenario is an OR statement and each option inside a Scenario is an AND statement. For example, a device will check to see if Scenario #1 OR Scenario #2 is true. If Scenario #1 is true, it will check 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.
        • Choose to either Select Network Adapter Class from a drop-down list or Type in a Network Adapter Name.
      • Up to five network adapters may be selected in the Adapter selection method? setting.
        • For each adapter you want to include/exclude, choose between Select a Network Adapter Class drop-down list 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, choose whether it will be included or excluded.
      Constrain months? For each month, choose whether it will be 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 - 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 Choose 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 - 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 Choose between Wi-Fi and Cellular.
      the device is continuously

      Two selections must be made.

      First, choose 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 – This condition type prompts the end user to determine whether or not the condition is met. This prompt is customizable so you can control what displays on the prompt.

      Settings Description
      Message to be displayed
      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).

      Prod_Prov_MacOSX_Confirm

      Allow users to cancel action(s)?

      Select Yes if you want to give users a chance to opt out of the action upon which this condition is placed.

      Select No to obligate users to accept the action.

      Delay
      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 will wait 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 to 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 to hide the delay countdown.

      Defer Action
      Defer time

      This controls the minimum time after the condition is not met before the end user will be prompted again to determine the state of this condition.

      If a non-zero value is entered, the end user will not be prompted again for at least that number of seconds.

      If a value of zero is entered, then the end user could be prompted again as soon as the next execution of the Check-In command.

      Maximum number of defers

      This controls the maximum number of times the condition is not met.

      Once the condition has not been met this number of times, it will either be met or failed, depending on the setting of the next feature.

      If a value of zero is entered, then the condition will be 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
    • Memory Threshold - This condition type tests the device for available memory level.

      Settings Description
      Available memory is less than

      Enter a percentage of available memory such that your action only executes if the device has less than the indicated amount.

    • Power – This condition type tests how a device is being powered, including whether the device is plugged in or has a suitably high 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 offers more granular battery tests than Power offers.

      Settings Description
      Message to be displayed
      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 field.

      For example, "You have %count% seconds to comply" where %count% will be the countdown clock.

      Condition
      Required power level

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

      • A/C
      • A/C or Full Battery
      Delay
      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 will wait 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 will display 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.
    • Schedule – 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 – This condition type tests whether the device's SD card is encrypted or not encrypted. This can be relevant if you need to wait for the SD card to be encrypted before downloading a file.

      Settings Description
      SD card is

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

    • Time – This condition type tests the local date and time on a device.

      Settings Description
      First Time Slot

      Select the month, day and year

      Start

      Finish

      Select Month, Day, and Year for both Start and Finish.

      Select hour and minute

      Start

      Finish
      Select Hour and Minute for Start and Finish.
      Second Time Slot
      Enable time check 2? Select Yes to display a second set of options identical to the First Time Slot.
      Third Time Slot
      Enable time check 3? Select Yes to display a third set of options identical to the First Time Slot.
  6. Select Finish.