Parámetros de sustitución en Unified Service Desk

Artículo
06/27/2024

Los parámetros de sustitución se pueden usar en la aplicación para extraer datos de elementos de datos (denominados parámetros de datos) capturados durante la ejecución de la aplicación que aumentan e incluyen el contexto de Unified Service Desk. El contexto se compone de pares de cadenas nombre/valor que cambian con frecuencia a medida que se descubren datos de distintas formas mientras se usa la aplicación. Los parámetros de sustitución se usan para una serie de tareas como especificar cadenas de consulta de dirección URL, generar resultados de script en scriptlets, especificar valores de búsqueda para búsquedas de entidad, integración de telefonía informática (CTI), y especificar la entrada de las acciones a las que se llama en otros controles hospedados. Los parámetros de sustitución son elementos clave que permiten un alto nivel de configuración o personalización en Unified Service Desk sin tener que usar el código.

Para obtener información sobre cómo usar parámetros de sustitución para configurar su aplicación de agente, consulte Parámetros de sustitución para configurar Unified Service Desk.

Nota

A veces el parámetro de sustitución se usa en lugar del parámetro de datos porque un parámetro de sustitución esencialmente es la representación de un parámetro de datos.

Ver los parámetros de sustitución en Unified Service Desk

El control Depurador de la aplicación cliente puede usarse para ver la lista de parámetros de sustitución disponibles en un momento determinado.

Inicie el cliente de Unified Service Desk e inicie sesión en la instancia de Dynamics 365 donde ha instalado los paquetes de ejemplo.
En la pantalla principal del cliente de Unified Service Desk, haga clic en la flecha abajo junto al engranaje en la esquina superior derecha, y seleccione Depurar. Aparecerá el Depurador.
En el Depurador, haga clic en Parámetros de datos para ver los parámetros de sustitución.

Una vista de árbol se usa para representar las variables disponibles. Al especificar la variable, especifique el nombre en el nivel de raíz, seguido de un punto (.) y luego el nombre de la lista. Estos son algunos ejemplos:

[[$Session.IsGlobal]]
[[$User.fullname]]

Estos valores cambiarán cuando el usuario interactúe en el cliente de Unified Service Desk. Llamadas a la acción recogerán el valor actual y lo usarán en su lista de parámetros o donde se pueda usar. Cuando se actualizan variables, se desencadena un evento NotifyContextChange en los controles base aunque el contexto de Unified Service Desk no haya cambiado. Esto permite que características como Líneas de sesión vuelvan a comprobar los valores de los parámetros de sustitución para ver si necesita actualizar lo que se muestra.

Parámetros de sustitución del sistema

Los parámetros de sustitución del sistema son los parámetros de sustitución definidos y rellenados por el sistema, y los nombres empiezan por $ para mantenerlos separados de los parámetros de sustitución definidos por el usuario. Por ejemplo, $Global. Unified Service Desk tiene los siguientes parámetros de sustitución:

$Context

Esta sección contiene el contenido del contexto de sesión de User Interface Integration (UII) y proporciona una forma cómoda de usar variables de contexto de sesión de UII en toda la aplicación Unified Service Desk.

Nota

El control hospedado del Administrador global proporciona una acción que permite copiar valores de otros parámetros de sustitución en contexto. Esto puede resultar útil al transferir llamadas o guardar la sesión para su rehidratación más adelante. El contexto se puede guardar en el servidor en estos casos mediante mecanismos estándar de UII.

$Debug

Es un valor de sustitución especial usado solo en un Scriptlet para determinar si le está llamando la ventana de depuración. Sobre todo cuando los scriptlets están causando que se realicen acciones en el sistema, comprobamos este parámetro para determinar si debemos omitir el bloque de código para evitar efectos secundarios al depurar. El siguiente scriptlet iniciaría el control hospedado Cuenta y mostraría la pestaña cuando se abre la ventana de depuración.

CRMGlobalManager.GetApp(“Account”);

Esto se debe a que los scripts se ejecutan en contexto actual para determinar sus valores en el estado actual del sistema. Para evitar que se produzca este efecto secundario, haga lo siguiente.

If ([[$Debug]]!= true) CRMGlobalManager.GetApp(“Account”);

Esto evitará el efecto secundario y seguirá proporcionando información útil al depurador.

$Global

Esta sección se agrega automáticamente para mostrar todas las opciones configuradas en Opciones de Dataverse y sus valores. Esto hace que las opciones sean fácilmente accesibles, ya que se pueden usar para supervisar la ejecución o los comportamientos que se crearon en flujos de trabajo o llamadas a la acción. Todos los indicadores de auditoría son visibles automáticamente desde esta sección.

$Panel

El parámetro de sustitución $Panel contiene todos los controles hospedados y sus nombres de panel actuales como pares clave-valor que se han desplazado a otro panel después de iniciar por última vez el cliente de Unified Service Desk. El parámetro de sustitución está disponible únicamente si al menos un control hospedado ha cambiado de panel cuando inició por última vez el cliente de Unified Service Desk. El resto de los controles hospedados y sus paneles existentes cargados actualmente en el panel del agente no están disponibles en este parámetro de sustitución.

$Resources

Esta colección de parámetros de sustitución la rellena el Administrador global con identificadores de idioma. En la configuración del control hospedado del Administrador global, puede especificar distintos recursos de idioma. Estos recursos toman el formulario de archivos .resx pero se cargan en recursos web como archivos XML. Al cargar la aplicación, Unified Service Desk leerá la configuración de idioma actual de Dataverse y luego buscará este idioma en la lista de idiomas del Administrador global. Si aparece el artículo, el recursos de los identificadores de idioma se cargarán en esta colección de $Resources.

En las partes que tuviera la intención de proporcionar texto neutro de idioma en los resultados, puede usar en su lugar los parámetros de sustitución de la colección $Resources. Por ejemplo, puede usar lo siguiente para el texto del botón.

[[$Resources.MyButtonName]+]

Dependiendo del idioma seleccionado para el usuario, se utilizará el texto localizado adecuado.

También es importante tener en cuenta aquí que estos parámetros de sustitución y, por tanto, los archivos .resx que se cargan, pueden contener la propia sintaxis de parámetros de sustitución. Después de reemplazar los valores de $Resources, se vuelven a comprobar en busca de parámetros de sustitución adicionales. De esta forma, aunque usted proporciona cadenas específicas del idioma, también puede sustituir datos del resto de la aplicación en esta cadena.

Para obtener información sobre cómo agregar recursos localizados para configurar Unified Service Desk, consulte Agregar soporte multilingüe para las aplicaciones del agente.

$Return

Algunas acciones devuelven un valor de cadena. Este valor de cadena se sitúa en el parámetro de sustitución de $Return con el nombre de la llamada a la acción. Seguirá este patrón:

[[$Return.ActionCallName]]

Un ejemplo de esto sería llamar CreateEntity en el Administrador global. Esto creará un registro y devolverá la GUID del nuevo registro. Esta nueva GUID estará en la lista de parámetros de sustitución de $Return y se podrá usar como entrada en la acción siguiente.

$Session

La sección $Session expone variables útiles necesarias para llamadas a la acción como el recuento de sesión, si la sesión activa es global, el ID. de la sesión activa actualmente. La sesión StartTime puede usarse para escribir la horas de inicio a una actividad. Esta sección se rellena automáticamente.

$Settings

Esta sección proporciona la configuración de usuario que solo se aplica al usuario actual. Esta configuración se cargará automáticamente al iniciar y se pueden leer mediante una llamada a la acción en tiempo de ejecución. A menudo incluye los valores de la selección de tema del usuario, pero puede proporcionar acceso a las opciones específicas del usuario que el configurador desea que estén disponibles.

Esta configuración de usuario se define en el área Configuración de usuario (Configuración>Configuración de usuario) en Dataverse al configurar Unified Service Desk.

Estos valores se pueden usar como cualquier otro parámetro de sustitución del sistema. El control hospedado Administrador global proporciona una acción, SaveSetting, que escribirá la configuración de usuario en el servidor, asumiendo que el usuario tiene acceso de escritura. Esto se puede usar para almacenar preferencias específicas del usuario, como selección de tema y diseños.

Nota

La configuración de usuario se puede guardar en el servidor de Dataverse si el usuario tiene acceso de escritura.

$Subject

Una función útil en Unified Service Desk es rellenar automáticamente el árbol de temas en un nuevo caso que crea en nombre del usuario. Algunas veces le convendrá rellenar automáticamente el campo de asunto, pero necesita conocer los valores correctos que debe usar, que pueden cambiar de un sistema a otro.

Con esta entrada, puede hacer referencia a un asunto específico cuando esté creando el caso empleando el siguiente parámetro de sustitución.

[[$Subject.Default Subject.Id]][[$Subject.Default Subject.LogicalName]]

$SystemParameters

Esta sección contiene una variable denominada HighContrast que muestra si el modo de alto contraste en Windows está habilitado o no (true/false). Puede usar esta variable para decidir si desea habilitar colores personalizados normales o colores del sistema (conformes con la configuración de alto contraste) cuando personaliza el tema del cliente. Más información: Personalizar temas en Unified Service Desk

$User

Este grupo de parámetros de sustitución se rellena automáticamente con el contenido del registro del usuario actual en la aplicación basada en modelo. Por ejemplo, si el administrador extiende la entidad de usuario del sistema en la aplicación basada en modelo para incluir un identificador de agente, este identificador de agente aparecerá en la lista. Esto se puede usar para establecer una configuración de usuario especial.