Configurar la aplicación CX Companion

CX Companion puede utilizarse tal cual o personalizarse según las necesidades de tu negocio. Esta sección documenta cómo puedes configurar CX Companion, utilizando la aplicación de muestra para ejemplificar algunas de las configuraciones.

Requisitos previos

• CX Companion requiere que se configure un robot sin servidor o unattended en la carpeta implementada.
• Recomendamos utilizar CX Companion en modo de eventos externos, pero ten en cuenta que, para facilitar su uso, el modo de parámetros de consulta está habilitado de forma predeterminada. Consulta la sección Configurar el modo de entrada de datos a continuación para obtener más detalles. Al utilizar eventos externos:
  • Para integrarse con Salesforce, instala y configura el complemento CX Companion SF en Salesforce.
  • Para integrarse con una plataforma de host diferente, instala y configura el controlador de comunicación de UiPath en la aplicación host.
• Para ejecutar acciones en modo atendido, CX Companion requiere la versión 2025.0.167 o posterior de UiPath Assistant.
• Si quieres lanzar otras aplicaciones desde CX Companion, debes utilizar el conector de Apps en Integration Service. Asegúrate de que las políticas de control de tu organización están configuradas para permitir el uso de este conector:
  • Dado que este conector está actualmente disponible en vista previa, la opción Habilitar vista previa de paquetes y actividades debe seleccionarse en la política de gobernanza de Studio Web implementada en tu organización. Esto hace que la actividad Enumerar aplicaciones implementadas esté disponible en los flujos de trabajo. Para obtener más información, consulta Configuración de las políticas de Studio Web en la guía de Automation Ops.
  • Asegúrate de que el conector de Apps está habilitado en tu política de Integration Service. Para obtener más información, consulta Configuración de las políticas de Integration Service en la guía de Automation Ops.

Configurar el modo de entrada de datos

La aplicación puede utilizar uno de los siguientes modos de entrada de datos:

• Parámetros de consulta : utiliza esta opción si CX Companion se va a implementar como independiente. Para permitirte probar rápidamente la aplicación CX Companion, esta opción está habilitada de forma predeterminada en la plantilla. El flujo de trabajo de inicio para utilizar parámetros de consulta es MainPage_Load_Initiate_Request_QueryParam.xaml.
• Eventos externos : utiliza esta opción si quieres integrar CX Companion en una aplicación host como Salesforce. El flujo de trabajo de inicio para utilizar eventos externos es MainPage_Initiate_Request.xaml. Esta es la opción recomendada, pero no está habilitada de forma predeterminada en la plantilla. Para utilizar esta opción:

  • En el diseñador de aplicaciones CX Companion : en el panel Propiedades de la aplicación, asegúrate de que Eventos externos está habilitado y añade el dominio de tu aplicación host en el cuadro de texto Orígenes permitidos . Para obtener más información sobre la habilitación de eventos externos, consulta Establecer un contexto externo utilizando eventos externos.

    

  • En el diseñador de aplicaciones CX Companion : deshabilita el modo de parámetros de consulta abriendo Data Manager en el archivo de flujo de trabajo

    MainPage_Load_Initiate_Request_QueryParam.xaml y estableciendo la variable ConfigEnableQueryParamMode en False. El valor predeterminado es True.
  • En la aplicación host : para Salesforce, instala y configura el complemento CX Companion SF. Para todas las demás aplicaciones host, instala y configura el controlador de comunicación de UiPath.

Configurar un proceso 360 (opcional)

Se incluye un proceso simulado de 360 en la solución y la aplicación lo invoca para recuperar los datos del cliente de la aplicación host. Puedes personalizar este proceso según sea necesario o crear otro proceso, publicarlo en Orchestrator y configurar CX Companion para utilizarlo seleccionándolo de la actividad Invocar proceso: iniciar proceso 360 en el flujo de trabajo de inicio y configurando los argumentos necesarios según sea necesario.

Configurar la carpeta para acciones

Las acciones se refieren a las automatizaciones, las aplicaciones y los agentes publicados en Orchestrator que los usuarios pueden ejecutar. CX Companion está configurado para tener diferentes carpetas para acciones en función del tipo de objeto de entrada. Por ejemplo, en la aplicación de ejemplo se definen dos tipos, Caso y Cuenta. Siempre que la estructura de carpetas en Orchestrator coincida con la configuración de la aplicación, cuando se carga un registro de un tipo determinado en la aplicación, el panel Acciones se rellena con las acciones de la carpeta definida para ese tipo.

1. Abre Data Manager en el flujo de trabajo de inicio para el modo de entrada de datos.
2. Introduce la ruta de la carpeta raíz de las automatizaciones en el campo de valor de la variable ConfigAutomationsRootFolderPath . Por ejemplo, CXCompanionAutomations/AllActions en la aplicación de ejemplo.
3. Configura los tipos de automatización en la variable ConfigAutomationFoldersByType . En esta variable de diccionario, cada clave es un tipo de objeto y su valor es el nombre de la subcarpeta de Orchestrator que contiene las automatizaciones para ese tipo de objeto.

   En la aplicación de ejemplo, la variable está configurada de la siguiente manera:

   Clave	Valor
   Caso	Automatizaciones de casos
   Cuenta	Automatizaciones de cuentas

   Esto corresponde a la siguiente estructura de carpetas en Orchestrator.

   

   En el panel Acciones de la aplicación, se muestran las acciones para el tipo de objeto, con una pestaña que representa cada subcarpeta encontrada en la carpeta para ese tipo.

   
4. Configura si incluir o no las aplicaciones implementadas en las acciones disponibles:
   • Si utilizas el modo de parámetros de consulta y quieres lanzar también aplicaciones implementadas, configura la actividad Enumerar aplicaciones implementadas tanto en MainPage_Load_Initiate_Request_QueryParam.xaml como en MainPage_Initiate_Request.xaml añadiendo una conexión de UiPath Apps.
   • Si utilizas el modo de eventos externos y también quieres implementar aplicaciones, configura la actividad Enumerar aplicaciones implementadas en MainPage_Initiate_Request.xaml añadiendo una conexión de UiPath Apps, y elimina o deshabilita la actividad Si: Cargar lista de aplicaciones si está habilitada en MainPage_Load_Initiate_Request_QueryParam.xaml.
   • Si no tienes la intención de implementar aplicaciones desde CX Companion, elimina o deshabilita la actividad Si: Cargar lista de aplicaciones si está habilitada en ambos flujos de trabajo de inicio.

5. Después de implementar la solución:

   1. Ve a la carpeta donde está implementada la aplicación y edítala.
   2. En la página Requisitos del paquete , selecciona la configuración de conexión.
   3. Si quieres que todos los usuarios utilicen la misma conexión, selecciona esa conexión. Si quieres permitir que los usuarios de la aplicación creen su propia conexión, selecciona Configurable por los usuarios para pedirles que creen una conexión la primera vez que carguen la aplicación.

Nota: puedes probar la aplicación utilizando automatizaciones simuladas de muestra.

Ejecutar en modo atendido o desatendido

CX Companion requiere que se configure un robot sin servidor o unattended en la carpeta implementada.

Para ejecutar acciones en modo desatendido o sin servidor, después de implementar la aplicación, puedes utilizar la URL en tu entorno de host sin necesidad de configuración adicional.

Si necesitas ejecutar algunas acciones en modo atendido, debes ejecutar la aplicación en modo atendido añadiendo un parámetro de consulta a la URL de la aplicación:

• Al utilizar CX Companion dentro de Salesforce, añade attendedMode=enabledWithRobotJSHandler.
• Cuando utilices CX Companion dentro de otro sistema de terceros, añade attendedMode=enabled.

Asegúrate de que UiPath Assistant se está ejecutando y está conectado al mismo tenant donde está implementada la aplicación. CX Companion requiere la versión 2025.0.167 o posterior de Assistant.

De forma predeterminada, todas las acciones se ejecutarán solo en modo desatendido, incluso si la aplicación se ejecuta en modo atendido. Para ejecutar acciones en modo atendido, marca la acción como atendido o añade la etiqueta Attended al proceso implementado en Orchestrator.

Configurar la aplicación para utilizar un único tipo de objeto

Si no desea que se muestren acciones en función de diferentes tipos de objetos (p. ej. caso y cuenta), puedes configurarlo para utilizar un solo tipo de objeto:

1. Elimina el valor predeterminado de la variable ConfigInputDataObjectTypeKeyName en el flujo de trabajo de inicio.
2. Elimina Type de la variable ConfigRequiredInputProperties en el flujo de trabajo de inicio.
3. Par clave-valor remoto Type de la variable ConfigQueryParameterNameMap en el flujo de trabajo de inicio.
4. Establece el nombre de la carpeta raíz en la variable ConfigAutomationsRootFolder en el flujo de trabajo de inicio.
5. Si la carpeta raíz está en el nivel superior, puedes eliminar el valor en ConfigAutomationsRootFolderPath. Si está en un nivel anidado, establece la ruta de la carpeta raíz en esta variable.
6. Personaliza el panel 360 según sea necesario. Para obtener más información, consulta Datos mostrados en el panel 360 en la sección Personalizaciones adicionales a continuación. Los bloques Cambiar caso pueden eliminarse y puedes mantener el conjunto de actividades Asignar valor. Además, si procede, actualiza la propiedad oculta del contenedor del panel 360 para que se base solo en show360Spinner y no en el tipo.

Entradas de acción

El formulario de entrada se crea dinámicamente en función de los argumentos de entrada. El formulario actualmente solo admite los siguientes tipos primitivos: Texto, Número, Booleano, SoloFecha. Si se pasa cualquier otro argumento de tipo, se mostrará un cuadro de texto. Para las entradas basadas en fechas, en lugar de utilizar DateTime, utiliza DateOnly para obtener un control de selector de fecha.

Salidas de acción

Todos los argumentos de salida de la acción se muestran en Automation Tracker con el nombre del argumento como título. Los valores de los argumentos de salida pueden ser texto sin formato o HTML. Cualquier otro dato de tipo complejo recibido se muestra en formato de cadena.

Automation Tracker admite la copia en el portapapeles. Se puede añadir una de las siguientes tres opciones a un elemento y el elemento obtendrá un icono de copia:

• data-copyable="true" : copia el contenido de texto del elemento.
• class="copyable" : copia el contenido de texto del elemento.
• data-copy-text="custom text" : copia el texto personalizado especificado.

Insertar la aplicación

Puedes copiar la URL de la aplicación desde un cuadro de diálogo que se muestra al final del proceso de implementación. Como alternativa, después de implementar la aplicación, ve a Orchestrator > Automatizaciones > [folder_name] > Apps y, a continuación, haz clic en Más opciones junto a la aplicación y selecciona Copiar URL.

Para obtener más información, consulta Publicar, implementar y actualizar proyectos de aplicación y Gestionar aplicaciones.

Al integrar la aplicación en iframes de la aplicación host, incluye embed_ en la URL para permitir el inicio de sesión a través de una ventana emergente. Para el modo de eventos externos, incluye el parámetro de consulta target y establece el nombre de dominio como valor, por ejemplo &target=https://www.example.com. Por ejemplo: https://cloud.uipath.com/embed_/appsdev/apps_/default/run/production/22986e36-8b04-4593-b82f-aae4c14bb2dc/bd8c8ef5-a94a-43f5-9a5b-6df73d8f7aa6/IDc0b72c47295b49abaea6b701cfa5b730?el=VB&uts=true&target=https://www.example.com

Personalizaciones adicionales

La mayoría de las personalizaciones pueden realizarse editando variables en los archivos de flujo de trabajo de la aplicación. Las variables con un nombre que comienza con Config se pueden cambiar para personalizar la aplicación. En algunos escenarios, las actividades también deben actualizarse.

• Nombre de clave único : en el modo de eventos externos, el objeto de solicitud de entrada puede tener varias propiedades, mientras que en el modo de parámetros de consulta, se pueden enviar varios parámetros de consulta como entradas. La propiedad que contiene el identificador único debe configurarse en la variable ConfigInputDataObjectUniqueKeyName en el flujo de trabajo de inicio. En la aplicación de ejemplo, Id es el nombre de propiedad utilizado para identificar de forma única la solicitud actual. Este valor único se utiliza también para mantener los resultados de ejecución de la acción.
• Nombre de clave de tipo de entrada : para permitir la configuración de diferentes carpetas raíz en función del tipo de solicitud, la aplicación debe conocer el nombre de la propiedad que contiene el tipo de objeto. La propiedad que contiene el identificador único debe configurarse en la variable ConfigInputDataObjectTypeKeyName en el flujo de trabajo de inicio. En la aplicación de ejemplo, Type es el nombre de la propiedad. Si no tienes diferentes tipos de objetos, elimina el valor de esta variable.
• Propiedades necesarias para iniciar : si se requiere alguna entrada obligatoria para iniciar el proceso 360, especifica esas propiedades en la variable ConfigRequiredInputProperties en el flujo de trabajo de inicio. Si las propiedades requeridas definidas no tienen valores, se lanzará un mensaje de error en tiempo de ejecución y las actividades posteriores no se ejecutarán. Al configurar esta variable, ten en cuenta que:
  • Es obligatorio añadir el Nombre de clave única a la colección.
  • Si no tienes diferentes tipos de objetos, no debes incluir el nombre de la clave de tipo de entrada en la colección.
  • Añade cualquier propiedad adicional necesaria a la colección.
• Configurar parámetros de consulta: en el modo de parámetros de consulta, los valores de los parámetros de la variable ConfigQueryParameterNameMap en MainPage_Load_Initiate_Request_QueryParam.xaml se obtendrán y se establecerán en el objeto de entrada. En este diccionario, las claves son los nombres de propiedad en el objeto de entrada y los valores son los nombres de los parámetros de consulta.
• Datos mostrados en el panel 360 : se configura estableciendo directamente el valor de cada elemento. En la aplicación de ejemplo, hay dos conjuntos disponibles, uno para el tipo Caso y otro para el tipo Cuenta . Cuando se muestra un conjunto, el otro se oculta en función del tipo. Las etiquetas son estáticas y se pueden cambiar según sea necesario.
  • Establece los valores de control respectivos en la actividad Intentar capturar: establecer datos de entrada en el panel 360 en el flujo de trabajo de inicio. Dentro de este bloque, se utiliza un conmutador para configurar en función del tipo. Utiliza este bloque para establecer valores basados en los datos del objeto de entrada.
  • Para establecer los datos del proceso 360 para que se muestren en el panel 360, utiliza la actividad Intentar capturar: establecer datos 360 del proceso en el panel 360 en el flujo de trabajo de inicio y configura los valores según sea necesario.
• Ocultar el panel 360 : para ocultar el panel 360 de la aplicación, establece la variable ConfigHide360Panel como True en el flujo de trabajo de inicio. Aunque el panel está oculto, el proceso 360 se sigue ejecutando y los valores se utilizan para rellenar previamente los argumentos de entrada en el formulario cuando se ejecuta una acción.
• Asignar propiedades de entrada a argumentos de entrada de acción : los valores procedentes de un evento externo, un parámetro de consulta y el proceso 360 pueden utilizarse para rellenar previamente el formulario de entrada que se muestra antes de ejecutar una acción. De forma predeterminada, si los nombres de los argumentos de la acción coinciden con cualquiera de los nombres de propiedad del objeto de entrada o nombres de propiedad de salida 360, los valores se rellenan previamente. Puedes configurar valores adicionales utilizando las siguientes variables en el flujo de trabajo ActionListPage_StartActionButton_click.xaml :
  • ConfigInputArgumentsInputObjectPropertyMap : diccionario en el que las claves son nombres de argumentos de entrada de acción y los valores son nombres de propiedades de objetos de entrada. Los objetos de entrada se crean a partir de parámetros de consulta o mensajes de eventos externos.
  • ConfigInputArgumentsDat360ObjectPropertyMap : diccionario en el que las claves son nombres de argumentos de entrada de acción y los valores son nombres de argumentos de salida 360.
• Habilitar el filtrado de acciones basado en el contexto : de forma predeterminada, todas las acciones se enumeran siempre para todos los tipos de solicitudes. Al utilizar esta opción, puedes mostrar acciones relacionadas en función del contexto de la solicitud actual. Para habilitarlo:
  1. En el flujo de trabajo MainPage_Action_Folder_Change.xaml , establece la variable ConfigEnableContextFiltering en True.
  2. Establece el valor ConfigContextFilteringPropertyName en el nombre de propiedad del objeto de proceso 360 que debe coincidir con las etiquetas de acción.
  3. Añade etiquetas a las acciones implementadas en Orchestrator. Añade la etiqueta Common a las acciones que quieras que estén siempre disponibles independientemente del tipo de acción.
  4. Para otras acciones que deberían estar disponibles solo para tipos de solicitudes específicos, añade etiquetas según sea necesario. Las acciones se mostrarán cuando el valor de la etiqueta coincida con el valor de la propiedad configurada en el paso 2. Se pueden añadir varias etiquetas a una sola acción para enumerar la acción para varios tipos de solicitudes.
  5. Si utilizas el modo de parámetro de consulta, configura también las variables mencionadas en los pasos 1 y 2 en el flujo de trabajo MainPage_Load_Initiate_Request_QueryParam.xaml .

Limitaciones y soluciones

• El control de lista personalizada que se utiliza para mostrar la lista de acciones no puede expandirse en función del espacio disponible. Configura la altura de este control para que se adapte al tamaño de pantalla más utilizado.

  
• Cada fila de la lista personalizada tiene una altura fija. Si el nombre o la descripción de la acción es largo, es posible que se trunque. Utilice un nombre y una descripción más cortos para una mejor alineación.
• El flujo de trabajo de eventos externos no se puede probar utilizando la opción de depuración. Para probar, debes implementar e integrar la aplicación en un entorno de host.