Utilitzar paràmetres de substitució per configurar l'Unified Service Desk

Els paràmetres de substitució es poden utilitzar per personalitzar les interaccions durant un procés de negoci específic mitjançant accions i regles de navegació per finestres. Més informació: Paràmetres de substitució

En aquest article es proporciona informació sobre les claus de substitució que podeu utilitzar als paràmetres de substitució per indicar una gestió especial de com podeu utilitzar els paràmetres de substitució a l'Unified Service Desk en algunes condicions especials.

Claus de recanvi

La taula següent proporciona informació sobre les claus de substitució que podeu utilitzar als paràmetres de substitució.

Clau de recanvi	Descripció
+	Aquesta clau, quan està present, substitueix una clau nul·la o inexistent per una cadena buida. Per exemple: en l'escenari en què account.name no està definit, la crida [[account.name]] donaria lloc a l'error "No tots els paràmetres de l'acció criden <ActionName> estan disponibles, avortant la crida a l'acció". Això deixa de processar la regla o l'element de línia que s'està executant. No obstant això, [[account.name]+] retorna un espai en blanc i no genera l'error de clau de substitució.
$	Aquesta clau permet escapar de cometes i salts de línia. S'utilitza com a operador quan s'invoca un scriptlet o es retorna una cadena de diverses línies. Per exemple: [[script.MyMultiLineString]$]
^	Aquesta clau impedeix l'escapament de cometes i salts de línia, i s'utilitza per aplanar el conjunt de resultats de diverses línies. Per exemple: MyMultiline=[[myvalue]^]
u	Aquesta clau s'utilitza per codificar URL (també anomenat Percent Encode) el paràmetre de substitució. Per exemple, considereu el paràmetre de substitució a l'adreça URL següent: https://mysite?something=[[opportunity.name]u]. Es retorna la cadena següent: https://mysite?something=My%20Opportunity.
x	Aquesta clau s'utilitza per codificar XML el paràmetre de substitució. El permet que els caràcters XAML, com ara <, s'escapin i es mostrin correctament a la sortida. Per exemple, [[myvalue]x].
g	Aquesta clau s'utilitza per retornar el valor de la sessió global. Si no es troba la clau a la sessió global, es produeix un error de clau no trobada.
un	Aquesta clau s'utilitza per retornar el valor de la sessió activa que està enfocada. Si la clau no es troba a la sessió activa, es produeix un error de clau no trobada.
v	Aquesta clau s'utilitza per substituir les claus dins d'una clau de substitució. Per exemple, considereu els dos valors següents: - account.name = "El meu compte" - mytemplate.value = "La meva plantilla és [[account.name]+]" Quan invoqueu el [[mytemplate.value]], es retorna la cadena següent: "La meva plantilla és [[account.name]+]". Tanmateix, quan invoqueu [[mytemplate.value]v], es retorna la cadena següent: "La meva plantilla és El meu compte".

Manipuladors especialitzats

Sovint, hi ha la necessitat de fer alguna cosa senzilla, com una construcció de tipus if/then/else que no garanteixi la creació d'un scriptlet. Aquestes situacions requereixen l'ús d'un scriptlet dins d'una crida d'acció. Hi ha dos controladors especialitzats per ajudar a crear scriptlets en línia en crides d'acció: $Expression i $Multiline.

$Expression

Penseu en una situació en què heu de canviar el nom de visualització en funció del codi de tipus d'entitat (etc.) de l'entitat actual. Esteu creant un URL que necessita aquesta informació. En aquesta situació, només hi pot haver un compte o un contacte carregat.

En aquest escenari, cridem a l'acció Navega en un control allotjat d'aplicació web estàndard mitjançant el valor següent al camp Dades :

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

Per aconseguir-ho, utilitzarem $Expression el següent:

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

Això crea i executa efectivament un scriptlet a mesura que es processa l'acció.

$Multiline

A la secció $Expression, hem parlat de fer un guió en línia dins d'una acció. En la situació en què hi ha la necessitat de fer un scriptlet més complex, i encara no voleu utilitzar un objecte scriptlet per emmagatzemar el scriptlet, l'ordre $Multiline es pot utilitzar per emmagatzemar scriptlets més complexos.

Per exemple, utilitzant l'exemple que hem utilitzat anteriorment a la $Expression secció, es pot dividir com:

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

Vegeu també

Paràmetres de substitució
Executar scripts mitjançant scriptlets a l'Unified Service Desk
Tutorials de configuració de l'Unified Service Desk