Product Documentation

Custom XML device policies

Mar 17, 2015

You can create custom XML policies in XenMobile when you want to customize the following features on Windows Phone 8.1, Windows 8.1 tablet, and Symbian devices:

  • Provisioning, which includes configuring the device, and enabling or disabling features
  • Device configuration, which includes allowing users to change settings and device parameters
  • Software upgrades, which includes providing new software or bug fixes to be loaded onto the device, including apps and system software
  • Fault management, which includes receiving error and status reports from the device

You create your custom XML configuration by using the Open Mobile Alliance Device Management (OMA DM) API in Windows 8.1. Creating custom XML with the OMA DM API is beyond the scope of this topic. For more information about using the OMA DM API, see OMA Device Management on the Microsoft Developer Network site.

  1. In the XenMobile console, click Configure > Device Policies. The Device Policies page appears.

    Select device policies

  2. Click Add to add a new policy. The Add New Policy dialog box appears.

    Select custom XML

  3. Click More and then under Custom, click Custom XML. The Custom XML Policy information page appears.

    Custom XML policy information page

  4. In the Policy Information pane, enter the following information:
    1. Policy Name: Type a descriptive name for the policy.
    2. Description: Type an optional description of the policy.
  5. Click Next. The Policy Platforms page appears.
    Note: When the Policy Platforms page appears, all platforms are selected and you see the Windows Phone 8.1 platform configuration panel first.

    Custom XML platform information page

  6. Under Platforms, ensure only the platforms you want to add are checked.
  7. In XML content, enter the custom XML code you want to add to the policy. If the content is long, you can cut and paste the code from the source file.
  8. Expand Deployment Rules and then configure the following settings: The Base tab appears by default.

    Deployment rules

    1. In the lists, click options to determine when the policy should be deployed.
      1. You can choose to deploy the policy when all conditions are met or when any conditions are met. The default option is All.
      2. Click New Rule to define the conditions.
      3. In the lists, click the conditions, such as Device ownership and BYOD, as shown in the preceding figure.
      4. Click New Rule again if you want to add more conditions. You can add as many conditions as you would like.
    2. Click the Advanced tab to combine the rules with Boolean options.

      Advanced deployment rules with base rules

      The conditions you chose on the Base tab appear.
    3. You can use more advanced Boolean logic to combine, edit, or add rules.
      1. Click AND, OR, or NOT.
      2. In the lists that appear, choose the conditions that you want to add to the rule and then click the Plus sign (+) on the right-hand side to add the condition to the rule.

        At any time, you can click to select a condition and then click EDIT to change the condition or Delete to remove the condition.

      3. Click New Rule again if you want to add more conditions.

        In this example, the device ownership must be BYOD, the device local encryption must be True, and the device mobile country code cannot be only Andorra.

        Advanced deployment rules complete

  9. Click Next. XenMobile checks the XML content syntax. Any syntax errors appear below the content box. You must fix any errors before you can continue.

    If there are no syntax errors, the Custom XML Policy assignment page appears.

  10. Next to Choose delivery groups, type to find a delivery group or select a group or groups in the list to which you want to assign the policy. The groups you select appear in the right-hand Delivery groups to receive app assignment list.

  11. Expand Deployment Schedule and then configure the following settings:
    1. Next to Deploy, click ON to schedule deployment or click OFF to prevent deployment. The default option is ON. If you choose OFF, no other options need to be configured.
    2. Next to Deployment schedule, click Now or Later. The default option is Now.
    3. If you click Later, click the calendar icon and then select the date and time for deployment.
    4. Next to Deployment condition, click On every connection or click Only when previous deployment has failed. The default option is On every connection.
    5. Next to Deploy for always-on connection, click ON or OFF. The default option is OFF.
      Note: This option applies when you have configured the scheduling background deployment key in Settings > Server Properties.
    Note: The deployment schedule you configure is the same for all platforms. Any changes you make apply to all platforms.

    Deployment schedule

  12. Click Save to save the policy.