Controles avançados para menus suspensos

Os tutoriais nesta página demonstram o uso de listas suspensas com o UiPath Form Designer, dentro da atividade Create Form Task . A propriedade mais utilizada para obtenção dos resultados nos tutoriais é a FormData(Collection).

Criando menus suspensos dinâmicos

Use-os em fluxos de trabalho em que deseja enviar dados dinâmicos para preencher um controle suspenso dentro de uma ação de formulário.

Com esse método, uma variável do tipo List of Strings contém os valores da lista suspensa em vez de adicionar valores estáticos na guia Data no UiPath Form Designer.

No exemplo a seguir, criamos uma lista suspensa dinâmica de países, inicializamos uma variável com a lista de países e criamos uma variável adicional para capturar o país selecionado pelos usuários.

Para criar um menu suspenso dinâmico:

1. Na atividade Criar tarefa de formulário , clique nas reticências (...) à direita de FormData.

2. Adicione um argumento para o menu suspenso dinâmico da seguinte maneira:

   • Nome: countryList_dropdown
   • Direção: Em
   • Tipo: Lista de Strings (List<String>)
   • Valor: Pressione Ctrl + K e insira listOfCountries como o nome da variável.
     A variável listOfCountries contém os itens na lista suspensa.
     Nota: Array of Strings também é suportado, mas você deve adicionar manualmente o componente suspenso no Form Designer e adicionar o valor Field Key .

3. Se você deseja obter a seleção do usuário de volta ao fluxo de trabalho, adicione outro argumento para capturar o valor selecionado:

   • Nome: country (a chave de campo do componente suspenso)
   • Direção: Dentro/Fora ou Fora
   • Tipo: String
   • Valor: Pressione Ctrl + K e insira selectedCountry como o nome da variável.
4. Clique em OK para fechar os dados do formulário.
5. Abra o painel Variáveis e inicialize listOfCountries com o valor padrão new List(of string) from { "India", "Romania", "US" }.
   Dica: Você também pode optar por preencher listOfCountries por meio de outras atividades em vez de inicializá-lo.

Criando menus suspensos em cascata

Use-os em formulários baseados em tarefas quando desejar que a seleção em um menu suspenso (pai) preencha os valores no segundo menu suspenso (filho).

Para criar um menu suspenso em cascata:

1. Na atividade Criar tarefa de formulário , clique nas reticências (...) à direita de FormData.

2. Vincule o menu suspenso pai ao fluxo de trabalho.

   Para este exemplo, crie um argumento que passe a variável listOfCountries List<String> para o fluxo de trabalho como uma lista suspensa.
   Observação: a variável listOfCountries contém os itens na lista suspensa principal, ou seja, a lista de países.
   1. Nomeie o argumento CountryList_dropdown. O nome da propriedade Field Key para este argumento é CountryList.
   2. Defina a direção como em 2.3. Defina o tipo como System.Collections.Generic.List<System.String>
   3. Defina o Valor como a variável listOfCountries List<String>.

3. Vincule o menu suspenso filho ao fluxo de trabalho.

   Para este exemplo, crie um argumento que passe a variável stateDictionaryList Dictionary<String, List<String>> para o fluxo de trabalho como uma lista suspensa.
   Observação: a variável stateDictionaryList contém os itens na lista suspensa filha, ou seja, os estados de cada país.
4. Nomeie o argumento stateDictList_dropdown. O nome da propriedade Field Key para este argumento é stateDictList.
5. Defina a direção como em 3.3. Defina o tipo como System.Collections.Generic.Dictionary<System.String, System.Collections.Generic.List<System.String>
6. Defina o valor como a variável stateDictionaryList Dictionary<String, List<String>

7. Vincule o menu suspenso filho ao menu suspenso pai.

   Crie um argumento com o nome do menu suspenso filho e adicione o sufixo _parent . Em seguida, defina o valor do argumento para o nome do menu suspenso pai, assim: ”ParentDropdownVariableName”.
   Para este exemplo, crie um argumento denominado stateDictList_parent. O menu suspenso filho é stateDictList e você adiciona o sufixo _parent a ele.

   1. Defina a direção como In.

   2. Defina o Tipo como String.
   3. Defina o Valor como ”CountryList”.
      Ao preencher a variável de dicionário stateDictList , observe que a chave do dicionário é um valor da lista suspensa pai e seu valor correspondente é uma lista de opções a serem mostradas no formulário se o pai estiver definido para a chave.
      Dica:

      Você pode passar os valores a serem preenchidos previamente (por exemplo, com campos de país e estado) na coleção FormData .

      Se você estiver passando valores filho, certifique-se de incluir também o valor pai para evitar comportamento inesperado.

8. Mapeie cada valor do menu suspenso pai para uma variável List of Strings. Você pode preencher a lista (dicionário) para o menu suspenso pai de qualquer maneira, mas, para este exemplo, usamos uma atividade Adicionar ao dicionário para cada valor.

   • Dicionário: o dicionário do menu suspenso filho, stateDictList.
   • Chave: um valor da lista de strings para o menu suspenso pai, CountryList - neste exemplo, "US", "India"e "Romania".
   • Valor: Pressione Ctrl + K e insira um nome para a variável List of Strings que contém os valores a serem exibidos no menu suspenso filho quando o valor da chave é selecionado no pai - usaStatesList, indianStatesListe romanianCountyList, respectivamente.
9. Certifique-se de colocar a atividade ou atividades para a etapa acima antes da atividade Criar tarefa de formulário .
10. Clique em OK para fechar os dados do formulário.

11. Abra o painel Variáveis e inicialize a nova lista de variáveis String que você criou com os seguintes valores padrão:

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

Baixe esses exemplos aqui

Criando menus suspensos em cascata nos componentes Edit Grid e Data Grid

Para usar menus suspensos em cascata dentro de um componente Edit Grid ou Data Grid :

1. Crie os campos suspensos seguindo as etapas acima (usando o assistente FormData ).
2. Abra o Designer de formulário.

3. Se os campos suspensos não forem criados dentro do seu formulário, verifique se:

   • Os argumentos <dropdownKey> , <dropdownKey>_dropdowne <dropdownKey>_parent foram adicionados corretamente na coleção FormData .

   • A caixa GenerateInputFields está marcada.

4. Arraste e solte o componente Edit Grid ou Data Grid .
5. Arraste e solte os menus suspensos criados na Etapa 1 no componente Edit Grid ou Data Grid .
6. Abra o menu de configuração do menu suspenso filho (clique em ).

7. Na guia Lógica , observe a lógica avançada pré-configurada.

   
   

   

   
   
8. Navegue até o campo Actions > Schema Definition .
9. Substitua [data.<parent_dropdown_key>] por [row.<parent_dropdown_key>] na expressão do esquema.
   
   

   

   
   
   Observação: a palavra-chave row instrui o formulário a usar o valor pai da linha da grade.
10. Salve o formulário.

Definindo o número de resultados de pesquisa para menus suspensos

Os menus suspensos mostram no máximo quatro resultados de pesquisa por padrão. Você pode alterar esse limite definindo uma propriedade no design do formulário.

Para definir o número de resultados de pesquisa para um menu suspenso:

1. No UiPath Form Designer, clique em Editar para abrir as configurações da lista suspensa e selecione a guia Dados .
2. Em Choices.js options, adicione { "searchResultLimit" : x }, onde x é o número máximo de resultados que você deseja mostrar.

Exibindo todas as opções dentro de menus suspensos

Se as strings no menu suspenso tiverem mais de 50 caracteres, elas podem ser omitidas da exibição.

Para exibir todas as opções que correspondem ao seu termo de pesquisa:

1. Clique em Editar JSON para o componente Lista suspensa que você deseja editar.

2. No campo Component JSON , adicione as seguintes propriedades:

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

Observação: a propriedade threshold determina em que ponto o algoritmo interrompe a operação de pesquisa para o termo de pesquisa fornecido. Por exemplo, um threshold de 0 requer uma correspondência exata de letras e localização. Um threshold de 1 pode corresponder a qualquer coisa, até mesmo erros de ortografia. Ajuste o valor threshold com base em seu caso de uso.