Use parámetros de sustitución para configurar Unified Service Desk

Article
04/19/2023

Los parámetros de sustitución se pueden usar para personalizar interacciones durante un proceso de negocio específico con acciones y reglas de navegación de ventanas. Más información: Parámetros de sustitución

En este tema se proporciona información sobre las claves de sustitución que puede usar en los parámetros de sustitución para indicar una administración especial en el uso de los parámetros de sustitución en Unified Service Desk en algunas condiciones especiales.

Claves de sustitución

La siguiente tabla proporciona información sobre las claves de sustitución que puede usar en los parámetros de sustitución.

Clave de sustitución	Descripción
+	Esta clave, cuando está presente, reemplazará una clave nula o inexistente por una cadena vacía. Por ejemplo, en el caso de que `account.name` esté sin definir, al llamar a `[[account.name]]` se mostrará el error "No todos los parámetros de la llamada a la acción <NombreDeAcción> están disponibles, anulando llamada". a la acción". Esto detendrá el procesamiento de la regla o del elemento de línea que se esté ejecutando. Sin embargo, `[[account.name]+]` devolverá un espacio en blanco, y no elevará el error de la clave de sustitución.
$	Esta clave permitir el escape de comillas y saltos de línea. Normalmente se usa como un operador cuando se invoca un scriptlet o se devuelve una cadena multilínea. Por ejemplo: `[[script.MyMultiLineString]$]`
^	Esta clave impide el escape de comillas y de saltos de línea, y se usa para aplanar un conjunto de resultados multilínea. Por ejemplo: `MyMultiline=[[myvalue]^]`
u	Esta clave se usa para codificar como dirección URL (lo que también se llama codificar como porcentaje) el parámetro de sustitución. Por ejemplo, supongamos el parámetro de sustitución en la siguiente dirección URL: https://mysite?something=`[[opportunity.name]u]`. Se devuelve la cadena siguiente: https://mysite?something=My%20Opportunity.
x	Esta clave se usa para codificar como XML el parámetro de sustitución. Permite aplicar un carácter de escape a los caracteres XAML, como <, y mostrarlos correctamente en los resultados. Por ejemplo, `[[myvalue]x]`.
g	Esta clave se usa para devolver el valor de la sesión global. Si la clave no se encuentra en la sesión global, producirá un error de clave no encontrada.
a	Esta clave se usa para devolver el valor de la sesión activa actualmente que tiene el enfoque. Si la clave no se encuentra en la sesión activa, producirá un error de clave no encontrada.
v	Esta clave se usa para reemplazar claves en una clave de sustitución. Por ejemplo, supongamos los dos valores siguientes: - account.name = "Mi cuenta" - mytemplate.value = "Mi plantilla es `[[account.name]+]`" Cuando invoca `[[mytemplate.value]]`, se devuelve la cadena siguiente: "Mi plantilla es [[account.name]+]". Sin embargo, cuando invoca `[[mytemplate.value]v]`, se devuelve la cadena siguiente: "Mi plantilla es Mi cuenta".

Controladores especializados

A menudo es necesario hacer algo sencillo, como una construcción de tipo if/then/else que no suponga la creación de un scriptlet. Estas situaciones requieren el uso de un scriptlet en una llamada a la acción. Hay dos controladores especializados para ayudar a generar scriptlets en línea en llamadas a la acción: $Expression y $Multiline.

$Expression

Considere una situación donde necesite cambiar el nombre para mostrar en función del código de tipo de entidad (etc) de la entidad actual. Está generando una dirección URL que necesita esta información. En esta situación, sólo puede haber una cuenta o un contacto cargado.

En este caso, llamamos a la acción Navegar en un control hospedado Aplicación web estándar usando el siguiente valor en el campo Datos:

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

Para ello, utilizaremos $Expression de este modo:

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

Esto crea y ejecuta con efectividad un scriptlet mientras se procesa la acción.

$Multiline

En la sección de $Expression, hablamos sobre la creación de un scriptlet en línea en una acción. En una situación en la que es necesario crear un scriptlet más complejo y no se desea usar un objeto de scriptlet para almacenar el scriptlet, se puede usar el comando $Multiline para almacenar scriptlets más complejos.

Por ejemplo, utilizando el ejemplo que usamos anteriormente en la sección $Expression, es posible desglosarlo como:

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

Vea también

Parámetros de sustitución
Ejecutar scripts con scriptlets en Unified Service Desk
Tutoriales de configuración de Unified Service Desk

Share via