Macros

XenMobile fournit des macros qui permettent de renseigner les données de propriété utilisateur ou appareil dans le champ de texte des éléments suivants :

• Stratégies
• Notifications
• Modèles d’inscription
• Actions automatisées
• Demandes de signature de certificat de fournisseurs d’identité

XenMobile remplace une macro avec les valeurs utilisateur ou système correspondantes. Par exemple, vous pouvez pré-remplir la valeur boîte aux lettres pour un utilisateur dans un seul profil Exchange pour des milliers d’utilisateurs.

Syntaxe des macros

Une macro pouvez prendre la forme suivante :

• ${type.PROPERTYNAME}
• ${type.PROPERTYNAME ['DEFAULT VALUE'] [ | FUNCTION [(ARGUMENT1, ARGUMENT2)]}

Placez toute syntaxe suivie du symbole dollar ($) entre accolades ({ }).

• Les noms de propriétés qualifiés font référence à une propriété utilisateur, à une propriété d’appareil ou à une propriété personnalisée.
• Les noms de propriétés qualifiés consistent en un préfixe, suivi par le nom de propriété réel.
• Les propriétés de l’utilisateur prennent la forme ${user.[PROPERTYNAME] (prefix="user.")}.
• Les propriétés d’appareil prennent la forme ${device.[PROPERTYNAME] (prefix="device.")}.
• Les noms de propriétés sont sensibles à la casse.

• Une fonction peut être une liste limitée ou un lien vers une référence tierce qui définit les fonctions. La macro suivante pour un message de notification comprend la fonction firstnotnull.

  L’appareil ${firstnotnull(device.TEL_NUMBER,device.serialNumber)} a été bloqué …

• Pour les macros personnalisées (propriétés que vous définissez), le préfixe est ${custom}. Vous pouvez ignorer le préfixe.

Voici un exemple de macro couramment utilisée, ${user.username}, qui remplit la valeur de nom d’utilisateur dans le champ de texte d’une stratégie. Cette macro est utile pour la configuration des profils Exchange ActiveSync et d’autres profils utilisés par plusieurs utilisateurs. L’exemple suivant illustre comment utiliser les macros dans une stratégie Exchange. La macro pour Utilisateur est ${user.username}. La macro pour Adresse e-mail est ${user.mail}.

L’exemple suivant illustre comment utiliser les macros pour une demande de signature de certificat. La macro pour Nom du sujet est CN=$user.username. La macro pour la Valeur d’un Autre nom de l’objet est $user.userprincipalname.

L’exemple suivant illustre comment utiliser les macros dans un modèle de notification. Le modèle en exemple définit le message envoyé à un utilisateur lorsque les applications HDX sont bloquées en raison d’un appareil non conforme. La macro pour le Message est :

L’appareil ${firstnotnull(device.TEL_NUMBER,device.serialNumber)} n’est plus conforme avec la stratégie et les applications HDX vont être bloquées.

Pour plus d’exemples de macros utilisées dans les notifications, accédez à Paramètres > Modèles de notification, sélectionnez un modèle prédéfini et cliquez sur Modifier.

L’exemple suivant illustre une macro dans la stratégie de nom de l’appareil. Vous pouvez entrer une macro, une combinaison de macros, ou une combinaison de macros et de texte pour donner un nom unique à chaque appareil. Par exemple, utilisez ${device.serialnumber} pour définir le nom de l’appareil à partir du numéro de série de l’appareil. Utilisez ${device.serialnumber} ${ user.username } pour inclure le nom d’utilisateur dans le nom de l’appareil. La stratégie de nom d’appareil fonctionne sur les appareils supervisés iOS et macOS.

Macros pour les modèles de notification par défaut

Les macros suivantes sont utilisées dans les modèles de notification par défaut :

• ${account.SUPPORT_EMAIL}
• ${applicationName}
• ${enrollment.andriod.agent.download.url}
• ${enrollment.ios.agent.download.url}
• ${enrollment.pin}
• ${enrollment.url}
• ${enrollment.urls}
• ${enrollment.ios.url}
• ${enrollment.macos.url}
• ${enrollment.android.url}
• ${enrollment.ios.platform}
• ${enrollment.macos.platform}
• ${enrollment.android.platform}
• ${firstnotnull(device.TEL_NUMBER,device.serialNumber)}
• ${firstnotnull(device.TEL_NUMBER,user.mobile)}
• ${outofcompliance.reason(smg_block)}
• ${outofcompliance.reason(whitelist_blacklist_apps_name)}
• ${vpp.account}
• ${vpp.appname}
• ${vpp.url}
• ${zdmserver.hostPath}/enroll

Macros pour les stratégies spécifiques

Pour la stratégie Nom de l’appareil (pour iOS et macOS), vous pouvez utiliser ces macros pour le nom de l’appareil :

• ${device.serialnumber}
• ${user.username}@example.com
• ${device.serialnumber}
• ${device.serialnumber}
• ${user.username}
• ${enrollment.pin}
• ${user.dnsroot}

Pour la stratégie de clip Web, vous pouvez utiliser cette macro pour l’URL :

• ${webeas-url}

Pour la stratégie de clé de licence MDM Samsung, vous pouvez utiliser cette macro pour la clé de licence ELM :

• ${elm.license.key}

Macros pour obtenir des propriétés d’appareils intégrés

Macros pour toutes les propriétés d’appareil

Macros pour obtenir des propriétés utilisateur intégrés

Macros pour toutes les propriétés utilisateur