Workspace Environment Management

Jetons Dynamiques

Vous pouvez utiliser des jetons dynamiques dans n’importe quel Workspace Environment Management actions pour les rendre plus puissants.

Opérations de chaîne

Il est parfois nécessaire de manipuler des chaînes dans un script pour mapper des lecteurs ou lancer des applications. Les opérations de chaîne suivantes sont acceptées par l’agent de Workspace Environment Management :

#Left(string,length)#
#Right(string,length)#
#Truncate(string,length)#

&Trim(string)&
&RemoveSpaces(string)&
&Expand (chaîne) &

$Split(string,[splitter],index)$

#Mid(string,startindex)#
!Mid(string,startindex,length)!
!substring(string,startindex,length)!

#Mod(string,length)#

Remarque :

Tous les opérateurs sont sensibles à la casse. Les opérations de chaîne sont également prises en charge par des hashtags et des attributs Active Directory. Dans les cas où vos opérations de chaîne sont imbriquées, les opérations Mid sont toujours exécutées en dernier.

Hashtags

Les hashtags sont une fonctionnalité de remplacement largement utilisée dans le traitement des éléments Workspace Environment Management. L’exemple suivant illustre la façon dont vous utilisez les hashtags :

Pour écrire dans un fichier .ini, vous pouvez utiliser%USERNAME% dans le chemin d’accès du fichier.ini et Workspace Environment Management le traite et étend le répertoire final. Toutefois, l’évaluation de la valeur écrite par Workspace Environment Management dans le .ini lui-même est plus compliquée : vous pouvez écrire littéralement %USERNAME% ou écrire la valeur développée.

Pour augmenter la flexibilité, # #UserName ## existe sous forme de hash-tag, de sorte que l’utilisation de %UserName% pour une valeur l’écrit littéralement et # #UserName ## écrit la valeur développée.

Les balises de hachage suivantes ont été implémentées pour une utilisation générale :

##UserName##
##UserProfile##
##FullUserName##
##UserInitials##
##UserAppData##
##UserPersonal##
##UserDocuments##
##UserDesktop##
##UserFavorites##
##UserTemplates##
##UserStartMenu##
##UserStartMenuPrograms##
##ComputerName##
##ClientName##
##ClientIPAddress##
##ADSite##
##DefaultRegValue##
##UserLDAPPath##
##VUEMAgentFolder##
##RDSSessionID##
##RDSSessionName##
##ClientRemoteOS##
# #ClientOSInfos ##

Le hash-tag ##UserScreenCaptureComment## est implémenté pour une utilisation dans des parties spécifiques du produit. Cette balise peut être incluse dans le modèle d’e-mail sous Paramètres avancés > Personnalisation de l’agent d’interface utilisateur > Options du service d’assistance. Une fois inclus, les utilisateurs sont affichés avec un champ de commentaire situé sous la capture d’écran dans l’utilitaire de capture d’écran de l’agent. Le commentaire est inclus dans l’e-mail d’assistance à l’endroit où vous avez placé la balise dans le modèle d’e-mail.

Remarque :

Tous les hashtags sont sensibles à la casse.

Attributs Active Directory

Pour utiliser les attributs Active Directory, WEM remplace la valeur [ADAttribute:AttrName] par l’attribut Active Directory associé. [ADAttribute:AttrName] est le jeton dynamique de tous les attributs Active Directory. Un filtre associé vérifie la valeur des attributs spécifiés.

Pour les structures d’unités organisationnelles utilisateur (UO), WEM remplace la valeur [UserParentU:Level] par le nom d’unité d’organisation Active Directory associé. Le chemin Active Directory est le chemin d’accès utilisateur complet (LDAP) dans Active Directory et [UserParentU:Level] est un sous-ensemble de celui-ci.

Par exemple, supposons que vous souhaitiez créer un lecteur réseau pour une unité d’organisation à laquelle les utilisateurs appartiennent. Vous pouvez utiliser le jeton dynamique [UserParentU:Level] dans le chemin du lecteur réseau pour résoudre dynamiquement l’unité d’organisation des utilisateurs. Il existe deux manières d’utiliser le jeton dynamique :

  • Utilisez le jeton [UserParentU:Level] dynamique directement dans le chemin du lecteur réseau. Par exemple, vous pouvez utiliser le chemin suivant : \\Server\Share\[UserParentOU:0]\.
  • Définissez une variable d’environnement appelée unité d’organisation, puis définissez sa valeur sur [Utilisateur Parent : 0]. Vous pouvez ensuite cartographier le lecteur en tant que \\Server\Share\%OU%\.

Remarque :

  • Tous les attributs AD sont sensibles à la casse.
  • Vous pouvez remplacer le chiffre « 0 » par le chiffre correspondant au niveau que vous souhaitez atteindre dans la structure de l’unité d’organisation.
  • Vous pouvez ajouter des variables au chemin d’accès. Pour ce faire, assurez-vous que vous disposez d’une structure de dossiers exacte qui correspond à la disposition de votre unité d’organisation.

Vous pouvez également utiliser des attributs Active Directory à des fins de filtrage. Dans l’onglet Administration > Filtres > Conditions > Liste des conditions de filtre, vous pouvez ouvrir la fenêtre Nouvelle condition de filtre après avoir cliqué sur Ajouter. Dans la fenêtre Nouvelle condition de filtre, vous pouvez voir les quatre types de condition de filtre suivants associés aux attributs Active Directory :

  • Correspondance d’attributs Active Directory
  • Correspondance de groupe Active Directory
  • Correspondance du chemin Active Directory
  • Correspondance de site Active Directory

Pour la correspondance d’attributs Active Directory, le jeton dynamique est [ADAttribute:AttrName]. Aucun jeton dynamique n’est disponible pour Active Directory Group Match, car ce type de condition est utilisé pour vérifier l’appartenance à un groupe. Pour Active Directory Path Match, le jeton dynamique du chemin LDAP complet est # #UserLDAPPath ##. Pour Active Directory Site Match, le jeton dynamique est ##ADSite##.

Registres

Pour utiliser un registre, WEM remplace la valeur [RegistryValue:<Registry path>] par la valeur de registre associée. Par exemple, vous pouvez spécifier la valeur suivante :

  • [Valeur de registre : HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Norskale\Agent Host\AgentLocation]

fichiers XML

Pour utiliser un fichier XML, WEM remplace la valeur [GetXmlValue:<XML path>|<tag name>] par la valeur de balise spécifique dans le fichier XML. Le chemin XML peut être un chemin d’accès réel ou une variable d’environnement qui se résout en chemin. Vous devez entourer la variable d’environnement avec%. Par exemple, vous pouvez spécifier la valeur suivante :

  • [GetXmlValue:C:\citrix\test.xml|summary] or
  • [GetXmlValue:%xmlpath%|summary]

Fichiers INI

Pour utiliser un fichier .ini, WEM remplace le fichier [GetIniValue:<INI path>|<section name in the .ini file>|<key name in the .ini.file>] par la valeur de clé. Le chemin INI peut être un chemin réel ou une variable d’environnement qui se résout en chemin. Vous devez entourer la variable d’environnement avec%. Par exemple, vous pouvez spécifier la valeur suivante :

  • [GetIniValue:C:\citrix\test.ini|PLD_POOL_LIC_NODE_0_0|LicExpTime] or
  • [GetIniValue:%inipath%|PLD_POOL_LIC_NODE_0_0|LicExpTime]
Jetons Dynamiques