Jetons dynamiques

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

Opérations de chaîne

Parfois, vous devez 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(string)&

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

#Mid(string,startindex)#
!Mid(string,startindex,length)!
 ! sous-chaîne (chaîne, startindex, longueur) !

#Mod(string,length)#

Remarque :

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

Hashtags

Les hash-tags 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 développe le répertoire final. Cependant, l’évaluation de la valeur que Workspace Environment Management écrit dans le .ini lui-même est plus compliquée : vous pouvez écrire %UserName% littéralement 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##

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. Lorsqu’il est inclus, les utilisateurs sont présenté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 de support à l’emplacement 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 travailler avec les attributs Active Directory, WEM remplace la valeur [adAttribute:AttrName] par l’attribut Active Directory associé. [adAttribute:AttrName] est le jeton dynamique pour tous les attributs Active Directory. Il existe un filtre associé qui vérifie la valeur des attributs spécifiés.

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

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

  • Utilisez le jeton [UserParEntou:Level] dynamique directement dans le chemin d’accès du lecteur réseau. Par exemple, vous pouvez utiliser le chemin suivant : \\Server\Share\[UserParentOU:0]\.
  • Définissez une variable d’environnement appelée OU, puis définissez sa valeur sur [UserParentOU:0]. Vous pouvez ensuite mapper 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 nombre qui correspond 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 à votre disposition d’unité d’organisation.

Vous pouvez également utiliser les attributs Active Directory à des fins de filtrage. Sous 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 des attributs Active Directory
  • Correspondance de groupe Active Directory
  • Correspondance des chemins Active Directory
  • Correspondance du site Active Directory

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

Registres

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

  • [RegistryValue:HKEY_LOCAL_MACHINE \ SYSTEM \ CurrentControlSet \ ControlSet \ Control \ Norskale \ Agent Host \ AgentLocation]

Fichiers XML

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

  • [GetXMLValue : C:\citrix\test.xml |summary] ou
  • [GetXmlValue :%xmlpath%|résumé]

Fichiers INI

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

  • [getIValue : C:\citrix\test.ini |PLD_pool_lic_node_0_0_0|LicExptime] ou
  • [GetIniValue:%inipath%|PLD_POOL_LIC_NODE_0_0|LicExpTime]
Jetons dynamiques