Map data into Destiny templates: Jamf Pro

After you've configured sites, you can map data into the Destiny Resource Manager Mobile Device Management (MDM) Integration feature.

Note: If you have never logged in to your account via the Destiny Resource Manager MDM integration feature, first you need to authenticate your Jamf Pro account.

To access the Destiny Resource Manager MDM integration homepage:

  1. Log in as a Destiny Administrator.
  2. Select Setup > Sites sub tab.
  3. Next to the district name, click the Edit icon, Edit icon.. The Edit District page appears.
  4. Under Resource Management, click Configure.

    Synchronize with MDM checkbox

    The Mobile Device Management integration homepage appears.

  5. At the top-right of the Mobile Device Management homepage, use the Account Setup drop-down to select your MDM.

    Select MDM drop-down

    Note: Destiny will remember your MDM selection.

To map your configured Jamf Pro data to a Resource Manager template:

  1. Click Map Account Data into Destiny Templates. The Data Mapping page appears.

    Jamf Pro data mapping template

  2. To match your existing Destiny items, select District ID or Barcode.

    Important: Add Item will NOT be supported if the barcode already exists elsewhere in the district, EVEN IF the district has "Prevent duplicate barcodes across the district" turned off.

  3. To ignore the Displayable Name, and ONLY match on District ID and Barcode, select the Relax Matching Rules checkbox.
    Note: The Displayable Name in your MDM system might not be exactly how you want it in Destiny. For example, you might want the Jamf Pro values of Apple iPad 5th Generation and Apple iPad 6th Generation to appear as Apple iPad in Destiny. Use the Transform function, instead of relaxed matching rules, to match incoming data to existing data and to ensure desired matching when new items are added in the future.
  4. If you do not want to replace Destiny descriptions with resource data from your configured account, select the Keep Destiny Resource Manager Descriptions checkbox.
  5. Under Destiny Resource Manager Templates, click the drop-down, and select the Destiny Resource Manager template you want to map data to.
  6. In the table, for each of the Resource Description Fields and Item Specific Fields you want to change, use the Selectable Fields drop-down to select a Jamf Pro field.

    Notes:

    • Fields marked with an * is a required field and must be mapped.
    • Fields marked with an Important icon make up part of the Displayable Name. At least one of these fields must be populated.
    Available FieldsClosed
    Asset TagDepartmentEnrollment Method
    Initial Entry TimestampLast Enrollment TimestampLocation Email Address
    Location Phone NumberLocation Real NameLocation Username
    ManagedManagement IdModel
    Model IdentifierModel NumberName
    Network EidNetwork lccidNetwork Imei
    Network MeidNetwork Phone NumberOS Build
    OS VersionSerial NumberSupervised
    TypeUdidWifi Mac Address
  7. To overwrite a Selectable Field for Resource Description or Item Specific Fields, select the Sync Data checkbox in its row.
    Important: If the Sync Data checkbox is selected, the value from the MDM system is always overwritten in subsequent updates. If you want to use the MDM value as the default value only when the item is created in Destiny, letting Destiny manage the data, deselect the checkbox to prevent data from being overwritten in subsequent updates.
  8. To add regex patterns to a Selectable Field for Resource Description or Item Specific Fields, select the Regular Expression checkbox. The RegEx Pattern Editor pop-up appears.
    1. Type the requested information into the RegEx Pattern Editor:
      • RegEx Pattern
      • Substitution String (Optional)
      • Data Sample String
    2. Click Save RegEx Pattern.
    Important: Using regex is complicated. If done incorrectly, it can cause complications.
  9. To add if/then conditional mapping to a Selectable Field, select the Transform checkbox in the appropriate row. The Transform Field Values pop-up appears.
    1. Type the Actual Field Value and the Custom Field Value to set the conditions.
    2. Click Save Transform Settings.

      Notes:

      • If data in your MDM and Destiny isn't exactly the same, the Transform function allows incoming data to match existing data in Destiny on the initial synchronization, and prevents the creation of unwanted data in Destiny when new devices are added. This is important for the Displayable Name fields in Destiny, but also applies to any field where you want to manipulate the data.
      • To add or remove additional conditions, click or .
      • To edit existing if /then conditional mapping, click .
    3. To stop mapping the template fields and delete the selections, click Cancel Data Mapping.
  10. To see a preview of the mapped data, click View Data Mapping Sample.
  11. When finished, click Set Data Mapping.