Please note, that this article covers BOTH Jamf Pro and Jamf School Integrations.

 

Below are some quick links to take you to specific areas in the article

• Jamf Pro
• Jamf School
• Creating Saved Filters for Synced Apple Devices
• Checking Out Synced Apple Devices

 

High-Level Information About Both Jamf Integrations

To navigate to our Jamf Pro Integration, please go to Settings >Integrations >Jamf Integration

Here are some high-level notes before we get into the steps of the integration setup:

• IMPORTANT! Because of the technical knowledge required, your district’s IT administrator (or someone with a similar role) will most likely need to perform this procedure to sync Jamf Pro to ML Work Orders.
• Once the Jamf integration is active, you will see a green banner message posted at the top of the page.
  • 
• The Jamf Apple Device integration will auto-sync every 24 hours.
• Once the Jamf Apple Device is synced in, ONLY the mapped fields on the asset record can not be edited, otherwise, most fields on the Asset record will still be editable

• Asset Creation in ML Work Orders

  • The integration keys in on the serial number of the Jamf Apple device to uniquely identify the device. 
  • If the integration finds a match on the serial number, it will update the existing ML Work Order asset record with the information from the Jamf platform, otherwise, it will make a brand new asset record
  • The integration will bring over the devices as iPad, iPhone, and Macbook Asset Types based on the model of the device.

 

Jamf Pro Apple Device Integration

 

Step 1: Connection Tab within ML Work Orders

 

The connection tab will require field information to link your Jamf Pro instance to ML Work Orders.

• Jamf URL - This is the URL of your Jamf Pro instance
  • 
• Username - The Username of your admin account for Jamf Pro
• Password - The Password of your admin account for Jamf Pro

Once you have entered your Jamf Pro credentials:

1. Select "Save" so your information is ready to test the connection
   1. 
2. Select "Test" to test the connection with your credentials. If the test is successful, you'll see the below message
   1. 
3. Select "Next" to begin your Field Mapping for the integration

Step 2: Field Mapping Tab within ML Work Orders

This integration will auto-map the serial # and the Model field to ML Work Orders Serial # and Model fields. The Field mapping offers customization for which field you would like to map to the ML Work Order Asset Name field and barcode field. The following fields are options:

1. Serial #
2. Asset Tag
3. Mobile Device Name

Note: We are keying in on the serial # field in ML Work Orders/Jamf Pro to indicate if a Jamf device will update an existing asset in ML Work Orders or create a new asset record in ML Work Orders.

 

Once your field mapping is finished, please select "Next" to start your location mapping.

 

 

Step 3: Location Mapping Tab within ML Work Orders

 

Jamf location mapping will populate all of your buildings from Jamf. On this tab, you can map each applicable building to an ML Work Order (MLW) Location. 

 

To map a Jamf Building to an MLW Location:

1. Select the icon.  A dropdown that contains all spaces grouped by the buildings will display.
   1. 
2. Select the Space that the devices with this building in Jamf should map to in MLW
3. Select the icon to the right of the dropdown and save the selection. 
   1. If you need to cancel your selection, select the icon to the right of the dropdown
4. Once all appropriate buildings are mapped to MLW locations, select the "Next" Button in the bottom right of the page
   1.  

Location Mapping Notes:

1. 1. 1. You do NOT have to map all Jamf buildings to an MLW Location. If certain buildings in Jamf do not apply to MLW OR if you don't want devices at certain Jamf buildings mapped into MLW, then feel free to leave the MLW location blank for those kinds of buildings. 
      2. In addition, if a Jamf Device does not have a building associated to it, then MLW will not sync over that device.

 

Step 4: Sync Data Tab within ML Work Orders

 

The Sync data tab is where you can add your Smart and/or Static device groups. The sync will bring in devices tagged to a group that's added on this tab and if the devices building has a mapped MLW location via the location mapping tab.

 

MasterLibrary Recommendation:

• Create one single smart group called "MasterLibrary" and put all devices you'd like to sync into ML Work Orders into that group. This way, you only need to add one group into ML Work Orders.

 

To Add a Group and Sync in your Apple devices:

1. Select the button in the top right of the grid
2. Select the group you would like synced into ML Work Orders
   1. 
   2. NOTE: The active checkbox will default to being checked
3. Select Save
4. Select OK to refresh the page with the newly added group
   1. 
5. Select the icon on the right side of the grid to initiate the sync process for the group
   1. The Sync process can take a while depending on how many devices are in your group. So in the meantime, this load message will display
   2. 
6. Once the sync is completed, a new prompt will display
   1. 
      
      1. Total Apple Device
         1. Total Devices records part of the group. The other field counts should add up to this number.
      2. Total Asset Updated
         
         1. This count represents the number of assets in MLW that had a matching serial # in Jamf and therefore were updated.
      3. Total Asset Added
         1. Newly created asset records in MLW
      4. Total Device Not Synced
         1. This count represents devices that did not have a building in Jamf OR their building in Jamf was not mapped to an MLW location.
7. Select OK and the Sync is now set up for this group!
   1. NOTE: Now that the group is manually synced, it will be part of the nightly sync that happens every night. If you would like to ad-hoc sync this group anytime, feel free to select the again

Jamf Pro Field Display in ML Work Orders

The following areas will display the remaining Jamf Pro fields synced in ML Work Orders:

1. Assets -> View All Assets - there will be an Apple Icon () on the right side of the row.
2. Assets -> View All Assets -> Selecting Asset Name link. On the main asset page there will be a Apple icon () to the right of the Asset Name (top left of page).

Selecting theicon at either location will open up a window with all available Jamf Pro device fields and their associated values.

 

 

Jamf School Apple Device Integration

Step 1: Connection Tab within ML Work Orders

 

The connection tab will require field information to link your Jamf School instance to ML Work Orders.

• Jamf URL - The URL of your Jamf School instance
• Network Id - To find your Network ID, please log in to Jamf School and navigate to Devices -> Enroll Devices
• API Key - To find your API Key, please login to Jamf School and navigate to Organizations -> Settings -> API in Jamf School

Step 2: Field Mapping Tab within ML Work Orders

This integration will auto-map the serial # and the Model field to ML Work Orders Serial # and Model fields. The Field mapping offers customization for which field you would like to map to the ML Work Order Asset Name field. The following fields are options:

1. Serial #
2. Asset Tag
3. Mobile Device Name

Note: We are keying in on the serial # field in ML Work Orders/Jamf School to indicate if a Jamf device will update an existing asset in ML Work Orders or create a new asset record in ML Work Orders.

 

Once your field mapping is finished, please select "Next" to start your location mapping.

 

Step 3: Location Mapping Tab within ML Work Orders

 

Jamf location mapping will populate all of your locations (buildings) from Jamf. On this tab, you can map each applicable building to an ML Work Order (MLW) Location. 

 

To map a Jamf Location to an MLW Location:

1. Select the icon.  A dropdown that contains all spaces grouped by the buildings will display.
   1. 
2. Select the Space that the devices with this building in Jamf should map to in MLW
3. Select the icon to the right of the dropdown and save the selection. 
   1. If you need to cancel your selection, select the icon to the right of the dropdown
4. Once all appropriate buildings are mapped to MLW locations, select the "Next" Button in the bottom right of the page
   1.  

Location Mapping Notes:

1. 1. 1. You do NOT have to map all Jamf Locations to an MLW Location. If certain buildings in Jamf do not apply to MLW OR if you don't want devices at certain Jamf buildings mapped into MLW, then feel free to leave the MLW location blank for those kinds of buildings. 
      2. In addition, if a Jamf Device does not have a building associated with it, then MLW will not sync over that device.

Step 4: Sync Data Tab within ML Work Orders

 

The Sync data tab is where you can add your Smart and/or Static device groups. The sync will bring in devices tagged to a group that's added on this tab and if the devices building has a mapped MLW location via the location mapping tab.

 

MasterLibrary Recommendation:

• Create one single smart group called "MasterLibrary" and put all devices you'd like to sync into ML Work Orders into that group. This way, you only need to add one group into ML Work Orders.

 

To Add a Group and Sync in your Apple devices:

1. Select the button in the top right of the grid
2. Select the group you would like synced into ML Work Orders
   1. 
   2. NOTE: The active checkbox will default to being checked
3. Select Save
4. Select OK to refresh the page with the newly added group
   1. 
5. Select the icon on the right side of the grid to initiate the sync process for the group
   1. The Sync process can take a while depending on how many devices are in your group. So in the meantime, this load message will display
   2. 
6. Once the sync is completed, a new prompt will display
   1. 
      
      1. Total Apple Device
         1. Total Devices records part of the group. The other field counts should add up to this number.
      2. Total Asset Updated
         
         1. This count represents the number of assets in MLW that had a matching serial # in Jamf and therefore were updated.
      3. Total Asset Added
         1. Newly created asset records in MLW
      4. Total Device Not Synced
         1. This count represents devices that did not have a building in Jamf OR their building in Jamf was not mapped to an MLW location.
7. Select OK and the Sync is now set up for this group!
   1. NOTE: Now that the group is manually synced, it will be part of the nightly sync that happens every night. If you would like to ad-hoc sync this group anytime, feel free to select the again

Jamf School Field Display in ML Work Orders

The following areas will display the remaining Jamf Pro fields synced in ML Work Orders:

1. Assets -> View All Assets - there will be an Apple Icon () on the right side of the row.
   1. 
2. Assets -> View All Assets -> Selecting Asset Name link. On the main asset page there will be a Apple icon () to the right of the Asset Name (top left of page).
   1. 

Selecting theicon at either location will open up a window with all available Jamf School device fields and their associated values.

 

Creating a Saved Asset Filter for Your Apple Devices

1. Navigate to Assets > View All Assets
2. Add the "Apple ID" column to your view
   1. If you have Jamf School, you can use the "Apple Device UDID" field 
   2. 
3. Filter the Apple Device ID to "NotIsNull"
   1. 
4. Select Actions > Saved Filters
   1. 
5. Provide a name for the saved filter
   1. For example "Apple Devices"
6. Now you can access your synced Apple devices with fewer clicks!
   1. 

 

 

Checking Out Jamf Assets in ML Work Orders

In ML Work Orders you can check-out synced Jamf device asset records under certain conditions:

1. The Jamf device Asset record must have an asset status of "Available" or blank.
2. For Jamf Pro Only
   1. The "Assigned User" is not mapped from Jamf Pro via the field mapping tab of the integration setup page.