Controles avanzados para desplegables

Los tutoriales de esta página muestran el uso de listas desplegables con el Diseñador de formularios de UiPath, dentro de la actividad Crear tarea de formulario . La propiedad más utilizada para lograr los resultados en los tutoriales es FormData (Colección).

Crear menús desplegables dinámicos

Úselos en flujos de trabajo en los que desee enviar datos dinámicos para rellenar un control desplegable dentro de una acción de formulario.

Con este método, una variable del tipo Lista de cadenas contiene los valores de la lista desplegable en lugar de agregar valores estáticos en la pestaña Datos del Diseñador de formularios de UiPath.

En el siguiente ejemplo, creamos un menú desplegable dinámico de países, inicializamos una variable con la lista de países y creamos una variable adicional para capturar el país seleccionado por los usuarios.

Para crear un menú desplegable dinámico:

1. En la actividad Crear tarea de formulario , haz clic en los puntos suspensivos (...) a la derecha de DatosDelFormulario.

2. Añade un argumento para el menú desplegable dinámico de la siguiente manera:

   • Nombre: countryList_dropdown
   • Dirección: Entrada
   • Tipo: lista de cadenas (List<String>)
   • Valor: pulsa Ctrl + K e introduce listOfCountries como nombre de variable.
     La variable listOfCountries contiene los elementos en la lista desplegable.
     Nota: También se admite la matriz de cadenas, pero debes agregar manualmente el componente desplegable en el Diseñador de formularios y el valor de la clave del campo .

3. Si desea volver al flujo de trabajo la selección de usuario, añada otro argumento para capturar el valor seleccionado:

   • Nombre: country (la clave de campo del componente desplegable)
   • Dirección: Entrada / Salida o Salida
   • Tipo: cadena
   • Valor: pulsa Ctrl + K e introduce selectedCountry como nombre de variable.
4. Haz clic en Aceptar para cerrar los datos del formulario.
5. Abre el panel de Variables e inicializa listOfCountries con el valor predeterminado new List(of string) from { "India", "Romania", "US" }.
   Consejo: También puedes optar por rellenar listOfCountries a través de otras actividades en lugar de inicializarlo.

Crear menús desplegables en cascada

Úselos en formularios basados en tareas cuando desee que la selección en un menú desplegable (principal) complete los valores del segundo menú desplegable (secundario).

Para crear un menú desplegable en cascada:

1. En la actividad Crear tarea de formulario , haz clic en los puntos suspensivos (...) a la derecha de DatosDelFormulario.

2. Vincula el menú desplegable principal al flujo de trabajo.

   Para este ejemplo, crea un argumento que pase la variable listOfCountries List <String> al flujo de trabajo como una lista desplegable.
   Nota: La variable listOfCountries contiene los elementos de la lista desplegable principal, es decir, la lista de países.
   1. Nombre el argumento CountryList_dropdown. El nombre de propiedad de la clave del campo para este argumento es CountryList.
   2. Establecer la Dirección como Entrada 2.3. Establecer el tipo como System.Collections.Generic.List<System.String>
   3. Establece el Valor como la variable listOfCountries List <String>.

3. Vincula el menú desplegable secundario al flujo de trabajo.

   Para este ejemplo, crea un argumento que pase la variable stateDictionaryList Dictionary <String, List <String>> al flujo de trabajo como una lista desplegable.
   Nota: La variable stateDictionaryList contiene los elementos en la lista desplegable secundaria, es decir, los estados de cada país.
4. Nombre el argumento stateDictList_dropdown. El nombre de propiedad de la clave del campo para este argumento es stateDictList.
5. Establecer la Dirección como Entrada 3.3. Establecer el tipo como System.Collections.Generic.Dictionary<System.String, System.Collections.Generic.List<System.String>
6. Establecer el valor como la variable stateDictionaryList Dictionary <String, List <String>

7. Vincular el menú desplegable secundario al menú desplegable principal.

   Crea un argumento con el nombre del menú secundario y añade el sufijo _parent . Después, establece el Valor del argumento con el nombre del menú desplegable principal, así: ”ParentDropdownVariableName”.
   Para este ejemplo, crea un argumento llamado stateDictList_parent. El desplegable secundario es stateDictList y se le añade el sufijo _parent .

   1. Establezca la Dirección como Entrada.

   2. Establece el Tipo como String.
   3. Establece el Valor como ”CountryList”.
      Al rellenar la variable Diccionario stateDictList , ten en cuenta que la Clave de diccionario es un valor de la lista desplegable principal y su Valor correspondiente es una lista de opciones que se mostrarán en el formulario si el principal está configurado en la clave.
      Consejo:

      Puedes pasar los valores que se rellenarán previamente (por ejemplo, con campos de país y estado) en la colección DatosDeFormulario .

      Si vas a pasar valores secundarios, asegúrate de incluir también el valor principal para evitar un comportamiento inesperado.

8. Asigna cada valor del menú desplegable principal a una variable de Lista de cadenas. Puedes rellenar la lista (diccionario) del menú desplegable principal de cualquier forma, pero para este ejemplo, usamos una actividad " Añadir al diccionario " para cada valor.

   • Diccionario: el diccionario del menú desplegable secundario, stateDictList.
   • Clave: un valor de la lista de cadenas para el menú desplegable principal, CountryList ; en este ejemplo, "US", "India"y "Romania".
   • Valor: presione Ctrl + K e introduzca un nombre para la variable Lista de cadenas que contiene los valores que se mostrarán en el menú desplegable secundario cuando se seleccione el valor clave en el elemento principal: usaStatesList, indianStatesListy romanianCountyList, respectivamente.
9. Asegúrese de colocar la actividad o actividades para el paso anterior antes de la actividad Crear tarea de formulario .
10. Haz clic en Aceptar para cerrar los datos del formulario.

11. Abra el panel Variables e inicialice la nueva variables de Lista de cadenas que creó con los siguientes valores predeterminados:

    • Para indianStatesList: new List(of string) from { "Odisha", "Rajasthan", "Karnataka" }
    • Para usaStatesList: new List(of string) from {"Florida", "Georgia", "Washington"}
    • para romanianCountyList: new List(of string) from {"Cluj", "Prahova", "Constanta"}.

Descargue estos ejemplos aquí

Crear menús desplegables en cascada en componentes Editar cuadrícula y Cuadrícula de datos

Para usar menús desplegables en cascada dentro de un componente Editar cuadrícula o Cuadrícula de datos :

1. Crea los campos desplegables siguiendo los pasos anteriores (usando el asistente FormData ).
2. Abre el Diseñador de formularios.

3. Si los campos desplegables no se crean dentro de su formulario, verifique que:

   • Los argumentos <dropdownKey> , <dropdownKey>_dropdowny <dropdownKey>_parent se agregaron correctamente en la colección FormData .

   • La casilla GenerarCamposDeEntrada está marcada.

4. Arrastre y suelte el componente Editar cuadrícula o Cuadrícula de datos .
5. Arrastre y suelte los menús desplegables creados en el Paso 1 en el componente Editar cuadrícula o Cuadrícula de datos .
6. Abra el menú de configuración del menú desplegable secundario (haga clic).

7. En la pestaña Lógica , observa la lógica avanzada preconfigurada.

   
   

   

   
   
8. Ve al campo Acciones > Definición de esquema .
9. Reemplaza [data.<parent_dropdown_key>] con [row.<parent_dropdown_key>] en la expresión del esquema.
   
   

   

   
   
   Nota: La palabra clave de fila indica al formulario que use el valor principal de la fila de la cuadrícula.
10. Guarda el formulario.

Establecer el número de resultados de búsqueda para menús desplegables

Los menús desplegables muestran como máximo cuatro resultados de búsqueda de forma predeterminada. Puede cambiar este límite estableciendo una propiedad en el diseño del formulario.

Para establecer el número de resultados de búsqueda de un menú desplegable:

1. En el Diseñador de formularios de UiPath, haz clic en Editar para abrir la configuración de la lista desplegable y luego selecciona la pestaña Datos .
2. En las opciones de Choices.js, añade { "searchResultLimit" : x }, donde x es el número máximo de resultados que quieres mostrar.

Mostrar todas las opciones dentro de los menús desplegables

Si las cadenas del menú desplegable tienen más de 50 caracteres, es posible que no se muestren.

Para mostrar todas las opciones que coinciden con su término de búsqueda:

1. Haz clic en Editar JSON para el componente de la lista desplegable que desee editar.

2. En el campo JSON del componente , añade las siguientes propiedades:

   ...
     "fuseOptions": {
       "distance": 800,
       },
     "threshold": 1,
     "useExactSearch": false,
   ...

Nota: La propiedad threshold dicta en qué punto el algoritmo detiene la operación de búsqueda para el término de búsqueda determinado. Por ejemplo, un threshold de 0 requiere una coincidencia exacta de letras y ubicación. Un threshold de 1 puede coincidir con cualquier cosa, incluso errores ortográficos. Ajuste el valor threshold según su caso práctico.