Automation

Created: Modified: Documentation

Mobile Access Management includes a powerful system to automatically select and deploy Workflows to devices based on pre-defined criteria. It works like this:

  1. You plug a mobile device into a Mobile Access Management Launchpad.
  2. The Launchpad reads basic device information, including serial number, UDID, and model, and sends this information to the MAM server.
  3. The server uses the Automation Rules to determine which Workflow(s) to deploy, if any.
  4. The server tells the Launchpad to deploy the specified Workflow(s) sequentially.

For example, you can set up one Workflow to deploy when an iPod is connected, and a different Workflow for iPad.

Terminology

It’s helpful to understand several terms:

  • Rule: A set of one or more conditions to check, plus a set of one or more Workflows to run. There’s a control so you can enable or disable each rule. You can give your rules names, like “Erase patient iPads.”
  • Trigger: Determines what triggers the rule to run, for example a rule can run when a device is attached, or it can run if a device is disconnected from the Launchpad.
  • Condition: A single comparison that evaluates to true or false. For example, Device Name starts with “Nursing iPad”.
  • Built-in Attribute: Details for a device or launchpad that are maintained by Mobile Access Management. For example, Device Serial, Device Erase State, Launchpad Name.
  • Custom Attribute: These are attributes you may create and maintain yourself. See Attributes.
  • Comparison: A way of comparing one value to another, for example Is, Is Not, Starts With, Contains.
Creating A Rule
  1. Click the Automation tab, then New Rule.
  2. Enter a name for the rule in the Rule Name box.
  3. To specify when the rule should run, select a trigger from the dropdown list.
  4. Click Add an optional condition to select from the lists of built-in attributes and custom attributes.
  5. Add a Comparison to the attribute and fill in the right-hand side of the comparison when needed.
  6. If desired, add additional conditions.
    IMPORTANT: When you add multiple conditions, all must be true for the workflows to run.
  7. Click Choose Workflow and select a Workflow to run when all conditions are true.
    NOTE: Each rule must have at least one Workflow.
  8. Add additional workflows, if needed. Unlike conditions, the order of Workflows is important. Arrange the workflows to execute in the desired order by dragging on the three-lined hamburger icon.
  9. To remove conditions and Workflows, click Remove.
  10. Click Save.
Enabling and Disabling Rules

Rules are disabled by default. You can enable them by switching the Enabled setting to ON. This works in both the rule list and the rule editor.

Multiple Rules, Conditions, and Workflows

There are well-defined behaviors for handling multiple rules, conditions and Workflows. Mobile Access Management administrators should be familiar with the following.

Multiple Rules 

  • Rules are grouped based on triggers.
  • Rules are examined one at a time, from top to bottom based on the trigger. In other words, rules at the top of the list have a higher priority than rules at the bottom of the list.
  • If a rule does not match, Mobile Access Management looks at the next rule down the list.
  • Mobile Access Management never executes more than one rule for a single device. If a rule at the top of the list matches all conditions, then Mobile Access Management stops evaluating.
  • The special rule All Other Devices is executed only if no other rules match.
  • If All Other Devices is disabled, and no rules match a device, Mobile Access Management performs no action.
  • Since the order of rules is important, you can rearrange rules by dragging the “ hamburger” icon within each group of triggers.

Multiple Conditions

  • When a rule has multiple conditions all conditions must evaluate true for the rule to match. There is an implicit AND between each rule.
  • New Mobile Access Management users often wish for a way to specify OR.
    For example, you may want both the Launchpad “Unit 1234” and the Launchpad “Unit 3456” as conditions. Here’s the wrong way to do that:

This will never work because there’s no such thing as OR. Mobile Access Management adds the word AND to these conditions. In other words, Mobile Access Management interprets this as “Launchpad name is Unit 1234 AND Unit 3456″ Of course Launchpads can’t have two names.

As an alternative, you can create two rules. Better yet, use a custom attribute to “tag” these Launchpads, and begin unlocking the true power of Mobile Access Management.

Multiple Workflows

  • In general, multiple workflows are not necessary. Keep all the actions in a single workflow, and Mobile Access Management will execute them in the best order for dependable device operation.
  • Multiple workflows may be required when you wish to override Mobile Access Management’s default behavior.
  • If you do use multiple workflows, the order of workflows are important. Mobile Access Management will run the listed Workflows in order. Arrange the Workflows to run in the desired order by dragging on the three-lined “ hamburger” icon.
  • If the first Workflow fails, Mobile Access Management will halt and not execute other workflows in the rule.
When are Rules Evaluated?

Based on triggers you select! But there are a few exceptions to this.

Launchpad is running, and device is plugged inRules are evaluated
Launchpad starts with devices attached, and Launchpad Monitoring is enabledRules are evaluated
Launchpad starts with Recovery devices attachedRules are evaluated
Launchpad starts with devices attachedRules are NOT evaluated
Launchpad restarts due to an updateRules are NOT evaluated
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 Address00:00:00:00:00:00
Device ModeliPad / iPhone / iPod
Device Model (Detailed)iPad4,1 / etc.
Device NameAny text
Device SerialAAAA11A1A1AA / etc.
Device UDID111a1a111a11a1111111aa11a1aa111111a111aa / etc.
Launchpad NameAny text
Device DEP StatusEnrolled
Device IMEI123123412341234
Port Number
Device Last Connected
Device PlatformiOS / Android
Special Conditions

Most conditions accept free text in the right-hand side of the comparison. For advanced applications, it is also possible to use an attribute in that field. This is similar to how attributes can be used in workflows.

This technique is useful when tracking devices that may wander from one Launchpad to another, for example.

Keep some limits in mind when using attributes in this way:

  • Only Launchpad attributes may be used on the right side.
  • Enclose the attribute name within [square brackets].
  • The names are case sensitive.

And one more thing! You can also Schedule Automation Rules