Partager via


Utiliser des paramètres de remplacement pour configurer Unified Service Desk

Les paramètres de remplacement permettent de personnaliser les interactions pendant un processus d’entreprise spécifique par le biais d’actions et de règles de navigation dans la fenêtre. Pour plus d’informations : Paramètres de remplacement

Cette rubrique fournit des informations sur les touches de remplacement que vous pouvez utiliser dans vos paramètres de remplacement pour indiquer des manipulations spéciales, et montre comment utiliser les paramètres de remplacement dans Unified Service Desk dans certaines conditions particulières.

Touches de remplacement

Le tableau suivant fournit des informations sur les touches de remplacement pouvant être utilisées dans vos paramètres de remplacement.

Touche de remplacement Description
+ Cette touche, lorsqu’elle est présente, remplace une touche « null » ou inexistante par une chaîne vide.

Par exemple : dans un scénario où account.name n’est pas défini, l’appel de [[account.name]] aboutirait à l’erreur suivante : certains paramètres de l’appel à l’action <Nom_Action> ne sont pas disponibles, annulation de l’appel à l’action. . Cela aurait pour effet d’interrompre la règle ou la ligne en cours d’exécution.

Toutefois, [[account.name]+] renverra un espace, et n’indiquera pas l’erreur de touche de remplacement.
$ Cette touche permet d’ignorer les guillemets et les sauts de ligne. Elle est généralement utilisée comme opérateur lors de l’appel d’un scriptlet ou le retour d’une chaîne contenant plusieurs lignes.

Par exemple : [[script.MyMultiLineString]$]
^ Cette touche empêche d’ignorer les guillemets et les sauts de ligne, et elle est utilisée pour aplanir un ensemble de résultats contenant plusieurs lignes.

Par exemple : MyMultiline=[[myvalue]^]
u Cette clé est utilisée pour encoder le paramètre de remplacement à l’aide d’un codage d’URL (également appelé codage à l’aide d’un pourcentage).

Par exemple, prenons le paramètre de remplacement dans l’URL suivante : https://mysite?something=[[opportunity.name]u].

La chaîne suivante est renvoyée : https://mysite?something=My%20Opportunity.
x Ce paramètre est utilisée pour encoder le paramètre de remplacement à l’aide d’un codage XML. Cela permet d’ignorer les caractères XAML, comme <, et de les afficher correctement dans le résultat.

Par exemple, [[myvalue]x]
g Cette touche est utilisée pour retourner la valeur de la session globale. Si cette touche est introuvable dans la session globale, cela entraîne une erreur indiquant que la touche est introuvable.
a Cette touche est utilisée pour renvoyer la valeur à partir de la session active qui est visée. Si la touche est introuvable dans la session active, cela entraîne une erreur indiquant que la touche est introuvable.
v Cette touche est utilisée pour remplacer des touches au sein d’une touche de remplacement.

Par exemple, prenez les deux valeurs suivantes :

- account.name = « Mon compte »
- mytemplate.value = « Mon modèle est [[account.name]+] »

Lorsque vous appelez [[mytemplate.value]], la chaîne suivante est renvoyée : « Mon modèle est [[account.name]+] ».

Cependant, lorsque vous appelez [[mytemplate.value]v], la chaîne suivante est renvoyée : « Mon modèle est Mon compte ».

Gestionnaires spécialisés

Il est souvent nécessaire de faire quelque chose de simple, comme une construction du type if/then/else qui ne justifie pas la création d’un scriptlet. Ces situations requièrent l’utilisation d’un scriptlet à l’intérieur d’un appel à l’action. Il existe deux gestionnaires spécialisés pour vous assister lors de la génération de scriptlets intégrés dans des appels à l’action : $Expression et $Multiline.

$Expression

Imaginez que vous ayez besoin de changer de nom complet en fonction du code du type d’entité (etc) de l’entité active. Vous générez une URL qui nécessite ces informations. Dans ce cas, seul un compte ou un contact peut être chargé.

Dans ce scénario, nous appelons l’action Naviguer sur un contrôle hébergé Application web standard en utilisant la valeur suivante dans le champ Données :

url= https://mysite/showmessage.aspx?displayname={either the account or contact display name}  

Pour ce faire, nous utiliserons $Expression comme suit :

url= https://mysite/showmessage.aspx?displayname=$Expression("[[$Context.etc]]" == "1" ? "[[account.name]u+]" : "[[contact.fullname]u+]")  

Cette opération permet effectivement de créer et d’exécuter un scriptlet lorsque l’action est traitée.

$Multiline

Dans la section $Expression, nous avons parlé de la réalisation d’un scriptlet intégré dans une action. Lorsqu’il est nécessaire de créer un scriptlet plus complexe, et que vous ne souhaitez toujours pas utiliser un objet scriptlet pour stocker le scriptlet, la commande $Multiline peut être utilisée pour stocker des scriptlets plus complexes.

Par exemple, si nous reprenons l’exemple utilisé précédemment dans la section $Expression, on obtient :

url= https://mysite/showmessage.aspx?displayname=$Multiline( $Expression(  
function doWork()  
{  
      If ("[[$Context.etc]]" == "1")  
          return "[[account.name]u+]"   
      else   
          return "[[contact.fullname]u+]"  
}  
doWork();   
))  

Voir aussi

Paramètres de remplacement
Exécuter des scripts à l’aide de scriptlets dans Unified Service Desk
Guides pas-à-pas pour la configuration de Unified Service Desk