Using Macros in SOTI MobiControl

You can use macros to automatically pull information from your devices and input it as a value into SOTI MobiControl. For example, when enrolling your devices, you can instruct SOTI MobiControl to name your devices according to data specific to each device, such as a device's IMEI number or MAC address.

You can use macros in various places throughout the SOTI MobiControl console such as device naming during enrollment, certain profile configurations and other device configuration and tracking actions.

Note: Macros are resolved whenever a device checks into SOTI MobiControl and updated accordingly. Therefore, device names will change to reflect new information.

Available Macros

SOTI MobiControl supports several macros. However, not every macro is available for every situation or for every device type. Supported macros for a particular situation will be displayed in the macros drop-down list beside the relevant field.

Tip: When naming devices, you can link multiple macros together to create unique names.
Description Macro
Auto Incrementing Numbered Sequence

The default %AUTONUM% macro begins numbering at 00001

The customizable %AUTONUM:X%, where X = a number ranging from 0-9, allows you to specify a minimum number of padding of leading zeroes. %AUTONUM:3% would begin numbering with 0001.

Both %AUTONUM% macros increase in increments of 1.

%AUTONUM%

%AUTONUM:X%

Cellular Provider %CELL_PROVIDER%
Device ID
  • %DeviceID% for Android Plus devices
  • %DeviceIdentifier% for iOS devices
Device MAC Address %MAC%
Device Manufacturer %MANUFACTURER%
Device Model %MODEL%
Device Platform %PLATFORM%
Device Serial Number %SERIALNUM%
Enrolled User Domain %ENROLLEDUSER_DOMAIN%
Enrolled User Email %ENROLLEDUSER_EMAIL%
Enrolled User Principal Name %ENROLLEDUSER_UPN%
Enrolled User Username %ENROLLEDUSER_USERNAME%
ESN (Electronic Serial Number) for Samsung devices %ESN%
The IP address from which the device is connecting to the DS. This may or may not be the local IP address of the device, depending on the connection topolgy. %HOSTNAME%
ICCID (Integrated Circuit Card Identifier) %ICCID%
IMEI (International Mobile Equipment Identity) %IMEI%
IMSI (International Mobile Subscriber Identity) %IMSI%
IP address of the device %IP%
Lockscreen Message

If a lockscreen message is not configured on the device, SOTI MobiControl will use %PLATFORM% %AUTONUM% to name the device.

%LOCKSCREEN_MESSAGE
Phone Number %PHONENUMBER%
Personalized Device Name %PERSONALIZED_DEVICE_NAME%
SD Card

Points to the primary shared/external storage directory.

Note: This directory might not be accessible on Android 11 and later due to the scoped storage enforcement.
%SDCARD%