You can create event actions that run on a device when certain conditions are met.

Procedure

  1. Navigate to Devices > Provisioning > Components > Event Actions and select the Add Event Action button.
    The Add Event Action wizard displays.
  2. Select your device platform.
    The available conditions and available actions for the platform display.
  3. Select Next.
  4. Complete the Details settings and select Next when complete.
    Settings Descriptions
    Name Enter a name for the event action. The name cannot be longer than 255 characters.
    Description Enter a short description for the event action.
    Managed By Select the organization group that can edit the event action.
  5. Select a Condition that triggers the device action.
    Table 1. Event-Action Conditions by Platform
    Condition Android WinRugg Description
    AC Power Detects when the device is connected to an AC adapter.
    Adapter Detects network adapters, enabling you to select which to allow/disallow.
    Battery Threshold Detects battery charge, enabling you to direct the device as it reaches prescribed battery levels.
    Connectivity Detects connectivity, enabling you to take action when certain requirements are met.
    Memory Detects memory levels, enabling you to take actions when it reaches certain levels.
    Recurring Schedule Enables you to schedule your actions on a recurring basis.
    Time Enables you to schedule your actions to take place on certain dates, days of the week, and within time-slots.
    You can select a previously created condition from the drop-down menu or create a new one.
    1. To create a condition, select Create Condition from the drop-down menu.
    2. Select Next when complete.
    For more information, see Create a Condition.
  6. Complete the required option (Android only) Minimum Time Between Actions (hours) which limits the number of times the action is run when triggered by the prescribed event.

    This option is not available when Recurring Schedule is included in the selected conditions.

    You can select zero hours for this option but only for AC Power conditions.

  7. Select an Action to perform. The actions available depend on the device platform.
    Table 2. Event-Action Actions by Platform
    Action Android WinRugg Description
    Apply Custom Settings.

    Apply custom, OEM-specific device settings based on the selected XML file, which must be delivered to the device through a separate File/Action.

    If the file entered in the File Path text box is not found, then the Event Action does not run. However, the Event Action remains active, making attempts to run the custom setting XML file each time the condition is met.

    Supported Devices:

    • Android MSI devices with the Android Hub v7.1+
      • Upload the ZIP file created by MSI.
    • Android Zebra devices with the Android Hub v7.2+
      • Upload the XML configuration file created by the Zebra Stage Now program.
    Copy Files Copy files from one location to another on the WinRugg device.
    Create Folder. Create a folder on the WinRugg device.
    Delete Files. Delete folders from the WinRugg device.
    Device Check-in Command the Workspace ONE Intelligent Hub to check in the WinRugg device for updates.
    Download Files.

    You can download a file from the selected File Server source path onto the selected Destination folder of your Android or Windows Rugged device.

    For details, see Configure Download and Upload Actions for Event Actions, Android.

    Install Install files on the Windows Rugged device. You must use the Run manifest action to install files or applications by using command lines. Supports the following file types:

    .reg, .cab, and .xml

    Launcher Logout Checks-in the device, making it ready for another end user.
    Move Files Move files from one location to another on the WinRugg device.
    Reboot Restart the Android device.
    Remove Folder. Remove a folder from the WinRugg device.
    Rename File. Rename a file on the WinRugg device.
    Rename Folder. Rename a folder located in the WinRugg device.
    Run

    Run command lines and arguments on the WinRugg device.

    If you want to install executable files (EXE), then you must use the Run manifest action on Windows Rugged devices. This is accomplished using command lines. The Run command must use the syntax of "\[full file path]". For example, \program files\program.exe.

    Run Intent. Run command lines and arguments on the Android device. See RunIntent Action, File-Action Android for more information.
    Send Sample Data. Send the WinRugg device data sample to the UEM console.
    Terminate End a process or application running on the WinRugg device.
    Uninstall

    Uninstall a program or application on the WinRugg device. You must enter the application name.

    The application name must match the name that appears in the Uninstall menu in the Control Panel.

    Note: The Uninstall Manifest is for deleting files when a product is removed. If you remove a product from a device, any files installed remain on the device until uninstalled using an Uninstall Manifest.
    Upload Files

    You can upload a file from a source file path on your Android device to the selected File Server destination folder.

    For details, see Configure Download and Upload Actions for Event Actions, Android.

    Warm Boot Restart the WinRugg device.
  8. Select Update to add the action to the event action. You can add additional actions to the event action. Select Next.
  9. Review the Summary and select Save.

What to do next

To push event actions to devices, add them as a component to a product. For more information, see Create a Product.