Automation

Created: Modified: Documentation

Introduction

Rule-based workflow deployment is a powerful system to automatically select and deploy workflows to devices based on the criteria you choose. It works like this:

  1. You plug an iOS device into a GroundControl Launchpad.
  2. The GroundControl launchpad reads basic device information, including serial number, UDID, and model, and sends this information to the GroundControl server.
  3. The GroundControl server determines which workflows to deploy, if any.
  4. The GroundControl server tells the Launchpad to deploy the specified workflows sequentially.

For example, you can set up workflows to deploy when an iPod touch is connected, and another for iPad Air. You can also leverage Launchpad tagging, so your launchpads in the Pacific time zone receive an image with time zone set appropriately.

Important note about automation

Screen Shot 2016-07-11 at 1.29.59 PM

 

When this check mark appears on the Automation tab, it means that at least one rule is set to ON, and workflows will deploy automatically when a device is connected.

Caution: the Automation checkmark should be OFF when you are deploying manually.

Terminology
TermDefinition
RuleA condition or conditions, each of which matches true or false. For example, Condition 1: “Device Type … Is … iPad4,1″ Condition 2: “Launchpad … Contains … Mac”Note that for the rule to operate, all Conditions (1 and 2) must be true; and automation must be enabled (set to On).
Default WorkflowIf no rule matches, then the workflow specified by the Default Workflow is used; this may also be set to “none”

Creating A Rule

Click on the “Automation” tab and click on the “New Rule” button. Enter a name for the Rule in the “Rule Name” field:

Screen Shot 2016-07-11 at 1.33.18 PM

 

Click “Add condition” to select from the Default rules (always available) and Company Rules (see article on Custom Attributes). When you add multiple conditions, keep in mind they must all be true.Screen Shot 2016-07-11 at 1.34.17 PM

Below is a table of Built-In Conditions:

ConditionExample
Device Battery LevelAny whole number from 1 to 100
Device Erased StateErased, Not Erased
Device Recovery ModeOn, Off
Device iOS9.3.5, 10.3.1, etc.
Device MAC AddressAny Launchpad name
Device ModeliPad, iPhone, iPod, AppleTV
Device Model (Detailed)iPad4,1
Device NameiPad 1
Device SerialAAAA11A1A1AA
Device UDID111a1a111a11a1111111aa11a1aa111111a111aa
Launchpad NameAny Launchpad name

Next, click “Add an item” and select a workflow:

Note: A Rule must have at least one condition and one workflow. 

Multiple workflows can be deployed sequentially by clicking “Add an item” and selecting additional workflows. Workflows can be reordered by dragging and dropping the selected workflows.

In the example below, the device serial number is set as the Condition, and two workflows are selected to deploy in sequence: first, a multiple item workflows (restore+MDM); and then, change the device language to French – all automatically, on connecting the specified devices.

ruledetails.pngTo remove  a condition or workflow, simply click the grey “Remove” button.

Activating and Deactivating Rules

Rules are disabled by default. You can enable them by turning the switch button to ON and pressing Save Rule. You can turn automation ON and OFF in the list view as well:

Screen Shot 2016-07-11 at 1.44.15 PM

 

Default Workflow

Designate the Default Workflow by clicking on its row; then making the selection:

Screen Shot 2016-07-11 at 1.43.37 PM“No default workflow” is the default selection of this screen. In the example above, upon Save, the Default Workflow would be to “Demonstration Workflow” – and any device that is plugged into GroundControl will receive this Payload.

Important note (again) on automation: when a Default Workflow is selected or at least one Rule is set to ON, a check mark appears on the Automation tab. This indicator will show on all GroundControl screens, including the Dashboard (home page).