Product Documentation

Macros no XenMobile

Oct 06, 2016

O XenMobile fornece macros poderosas como uma forma de preencher dados de propriedade de usuário ou dispositivo no campo de texto de um perfil, uma política, uma notificação ou um modelo de registro (para algumas Ações), entre outros usos. Com as macros, você pode configurar uma única política e implantá-la em uma grande base de usuários e fazer com que valores específicos do usuário sejam exibidos para cada usuário de destino. Por exemplo, você pode preencher previamente o valor da caixa de correio de um usuário em um perfil do Exchange entre milhares de usuários.

Esse recurso está disponível somente no contexto das configurações e dos modelos para dispositivos Android e iOS.

Definição de macros de usuário

As seguintes macros de usuário estão sempre disponíveis:

  • loginname (nome do usuário mais domainname)
  • username (loginname menos o domínio, se houver)
  • domainname (nome de domínio ou o domínio padrão)

As seguintes propriedades definidas pelo administrador podem estar disponíveis:

  • 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 (substitui a propriedade descrita anteriormente)

Além disso, se o usuário for autenticado mediante o uso de um servidor de autenticação, como o LDAP, todas as propriedades associadas ao usuário nesse armazenamento estarão disponíveis.

Sintaxe de macro

Uma macro pode assumir a seguinte forma:

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

Como regra geral, todas as sintaxes que seguem o sinal de cifrão ($) devem ser colocadas entre chaves ({ }).

  • Os nomes qualificados de propriedade fazem referência a uma propriedade de usuário, uma propriedade de dispositivo ou uma propriedade personalizada.
  • Os nomes qualificados de propriedade consistem de um prefixo, seguido do nome real da propriedade.
  • Propriedades de usuário assumem a forma ${user.[PROPERTYNAME] (prefix="user.")}.
  • Propriedades de dispositivo assumem a forma ${device.[PROPERTYNAME] (prefix="device.")}.

Por exemplo, ${user.username} preenche o valor de nome do usuário no campo de texto de uma política. Isso é útil para configurar perfis do Exchange ActiveSync e outros perfis usados por vários usuários.

Para macros personalizadas (propriedades que você define), o prefixo é ${custom}. Você pode omitir o prefixo.

Observação: os nomes de propriedade diferenciam maiúsculas de minúsculas.