Product Documentation

Macros

Mar 02, 2017

XenMobile pone a su disposición potentes macros para rellenar datos de propiedad de usuario o de dispositivo en los campos de texto de un perfil, una directiva, una notificación o una plantilla de inscripción (para algunas acciones), entre otros usos. Con las macros, puede configurar una sola directiva, para implementarla a un usuario básico, además de definir que aparezcan valores específicos por usuario para cada usuario de destino. Por ejemplo, puede rellenar de antemano el valor del buzón de correo relativo a un solo usuario en un perfil de Exchange entre miles de usuarios. 

Por el momento, esta función solo está disponible en el contexto de configuraciones y plantillas para dispositivos iOS y Android.

Definición de macros de usuario

Las siguientes macros de usuario siempre están disponibles:

  • loginname (nombre de usuario y nombre de dominio)
  • username (loginname menos el dominio, si existe alguno)
  • domainname (nombre de dominio o el dominio predeterminado)

Las siguientes propiedades definidas por el administrador pueden estar disponibles:

  • c
  • cn
  • company
  • companyname
  • department
  • description
  • displayname
  • distinguishedname
  • facsimiletelephonenumber
  • givenname
  • homecity
  • homecountry
  • homefax
  • homephone
  • homestate
  • homestreetaddress
  • homezip
  • ipphone
  • l
  • mail
  • middleinitial
  • mobile
  • officestreetaddress
  • pager
  • physicaldeliveryofficename
  • postalcode
  • postofficebox
  • telephonenumber
  • samaccountname
  • sn
  • st
  • streetaddress
  • title
  • userprincipalname
  • domainname (reemplaza la propiedad descrita anteriormente)

Además, si el usuario está autenticado mediante un servidor de autenticación (como LDAP), están disponibles todas las propiedades asociadas al usuario en esa tienda.

Sintaxis de macros

Una macro puede presentar el siguiente formato:

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

Como regla general, todos los elementos de sintaxis posteriores al signo de dólar ($), deben estar 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 de usuario presentan el formato ${user.[PROPERTYNAME] (prefix="user.")}.
  • Las propiedades de dispositivo presentan el formato ${device.[PROPERTYNAME] (prefix="device.")}.

Por ejemplo, ${user.username} rellena el valor de nombre de usuario en el campo de texto de una directiva. Esto es útil para configurar perfiles de Exchange ActiveSync y otros perfiles utilizados por varios usuarios.

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

Nota: Los nombres de propiedad distinguen mayúsculas de minúsculas.