Macros

XenMobile ofrece macros para rellenar datos de propiedades de usuario o dispositivo en el campo de texto de los siguientes elementos:

• Directivas
• Notificaciones
• Plantillas de inscripción
• Acciones automatizadas
• Solicitudes de firma de certificado provenientes del proveedor de credenciales

XenMobile reemplaza una macro por los valores correspondientes al usuario o al sistema. Por ejemplo, puede rellenar de antemano el valor del buzón de correo perteneciente a un solo usuario en un perfil de Exchange entre miles de usuarios.

Sintaxis de macros

Una macro puede presentar el siguiente formato:

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

Incluya todos los elementos de sintaxis posteriores al signo de dólar ($) entre llaves ({ }).

• Los nombres de propiedad calificados hacen referencia ya sea a una propiedad de usuario, una propiedad de dispositivo o a una propiedad personalizada.
• Los nombres de propiedad calificados se componen de un prefijo, seguido del nombre en sí de la propiedad.
• Las propiedades del usuario tienen el formato ${user.[PROPERTYNAME] (prefix="user.")}.
• Las propiedades del dispositivo tienen el formato ${device.[PROPERTYNAME] (prefix="device.")}.
• Los nombres de propiedad distinguen mayúsculas de minúsculas.

• Una función puede ser una lista limitada o un enlace a una referencia externa que define las funciones. Esta macro para un mensaje de notificación incluye la función firstnotnull.

  El dispositivo ${firstnotnull(device.TEL_NUMBER,device.serialNumber)} ha sido bloqueado…

• Para macros personalizadas (propiedades que usted define), el prefijo es ${custom}. Puede omitir el prefijo.

Este es el ejemplo de una macro frecuente, ${user.username}, que rellena el valor de nombre de usuario en el campo de texto de una directiva. Esta macro es útil para configurar perfiles de Exchange ActiveSync y otros perfiles utilizados por varios usuarios. En el siguiente ejemplo, se muestra cómo usar macros en una directiva de Exchange. La macro de Usuario es ${user.username}. La macro para la dirección de correo electrónico es ${user.mail}.

En el siguiente ejemplo, se muestra cómo usar macros en una solicitud de firma de certificado. La macro para el nombre del sujeto es CN=$user.username. La macro para el valor de un nombre alternativo del sujeto es $user.userprincipalname.

En el siguiente ejemplo, se muestra cómo usar macros en una plantilla de notificaciones. La plantilla de ejemplo define el mensaje enviado a un usuario cuando las aplicaciones HDX se bloquean debido a un dispositivo que no cumple las reglas. La macro para el mensaje es:

El dispositivo ${firstnotnull(device.TEL_NUMBER,device.serialNumber)} ya no cumple la directiva de dispositivo. Las aplicaciones HDX se bloquearán.

Para obtener más ejemplos de macros utilizadas en las notificaciones, vaya a Parámetros > Plantillas de notificaciones, seleccione una plantilla predefinida y haga clic en Modificar.

En el siguiente ejemplo, se muestra una macro en la directiva “Nombre de dispositivo”. Escriba la macro, una combinación de ellas o una combinación de macros y texto para darle a cada dispositivo un nombre único. Por ejemplo, para establecer el número de serie de un dispositivo como su nombre, puede utilizar ${device.serialnumber}. Use ${device.serialnumber} ${ user.username } para incluir el nombre de usuario en el nombre del dispositivo. La directiva “Nombre de dispositivo” funciona en dispositivos supervisados iOS y macOS.

Macros para plantillas de notificaciones predeterminadas

Puede utilizar estas macros en las plantillas de notificaciones predeterminadas:

• ${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 para directivas específicas

En la directiva “Nombre de dispositivo” (para iOS y macOS), puede usar estas macros para Nombre de dispositivo:

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

En la directiva “Clip Web”, puede utilizar esta macro para URL:

• ${webeas-url}

En la directiva “Clave de licencia MDM de Samsung”, puede utilizar esta macro para Clave de licencia ELM:

• ${elm.license.key}

Macros para obtener propiedades integradas de dispositivo

Macros para todas las propiedades de dispositivo

Macros para obtener propiedades integradas de usuario

Macros para todas las propiedades de usuario