Payload Variables

In any payload field you can use variables to create information that is dynamically resolved by Jamf School when the configuration, wallpaper or Managed App Config is sent to the device.

This allows you flexibility in creating configuration that can be used across a variety of situations and devices.

The following variables are available. You can combine the variables with static text, for example:

  • %Username%@domain.com

  • %ProductName% of %FullName%

Global Variables

These variables are always available.

  • %CompanyId%: the internal ID of your organization

  • %CompanyNetworkId% : the Network ID of your organization

  • %CompanyName% : the name of your organization

User Variables

These variables are resolved using information from the user’s record in Jamf School.

Only available if the device that the profile is pushed to has an owner (not Shared iPads).

  • %FullName% : the user’s full name, for example ‘John Doe’

  • %FirstName% : the user’s first name, for example ‘John’

  • %LastName% : the user’s last name, for example ‘Doe’

  • %Email% : the user’s e-mail address, for example ‘john.doe@jamfschool.com’

  • %ShortName% : the user’s short name, for example ‘jdoe’

  • %Username% : alias for %short_name%

  • %Password% : the user’s password, only available if the credentials are stored locally in Jamf School

  • %UserId% : the user’s internal ID

  • %UserGroups% : comma separated list of groups this user is a member of

  • %ManagedAppleId% : the Managed Apple ID of the user (only available if the user has a Managed Apple ID)

  • %ManagedType% : the type of user (Staff, Student or Teacher) (only available if the user has a Managed Apple ID)

  • %ManagedGrade% : the grade of the user (eg. K1) (only available if the user has a Managed Apple ID)

VPP Invitation URL

Only available in profiles (not in devices names or Managed App Configs).

  • %VPP%: link to the iTunes page where the user can accept the VPP invite. Only available when the user is not yet Associated! Use a scope filter like “”VPP Status” not equal to “Associated”” to target the right users!

Device Variables

These variables are resolved using information from the device record in Jamf School and are always available.

  • %Name%: the name of the device

  • %DeviceGroups% : comma separated list of groups this device is a member of

  • %OSVersion% : the version number of the device’s OS, for example: 8.1.3 or 10.9

  • %udid% : the unique identifier of the device

  • %SerialNumber% : the device’s serial number

  • %ProductName% : the device’s product name, for example ‘iPad’, ‘MacBook’, etc..

  • %WIFIMAC% : the MAC address of the device’s WiFi interface

  • %AssetTag% : the device’s Asset Tag

  • %Notes% : the device’s Notes

Functions

  • %VARIABLE,5% : will give the first 5 digits of the variable

  • %VARIABLE,lower% : variable in lowercase letters

  • %VARIABLE,upper% : variable in uppercase letters

  • %VARIABLE,prefix:% : adds a prefix to the variable

  • %VARIABLE,postfix:% : adds a postfix to the variable

  • %url,barcode% : adds a QR code with a link to the device in Jamf School Management System (Wallpapers only)

  • %VARIABLE,barcode% : adds a QR code (Wallpapers only)

Location Variables

  • %LocationName% : Location name

  • %LocationCity% : Location city

  • %LocationAddress% : Location address

  • %LocationPostalCode% :Location postal code

You can also combine these functions, for example: %FullName,prefix:http://google.com/search?q=,barcode%. This will result in a QR code that links to google.com and searches for the user's full name.

Note: The variables full_name, first_name, last_name, email, short_name, username and password are deprecated. We recommend using the new notation (FullName, LastName, etc.) instead.

Copyright     Privacy Policy     Terms of Use     Security
© copyright 2002-2019 Jamf. All rights reserved.