apps
2023.10
false
Importante :
A tradução automática foi aplicada parcialmente neste conteúdo. A localização de um conteúdo recém-publicado pode levar de 1 a 2 semanas para ficar disponível.
UiPath logo, featuring letters U and I in white

Guia do usuário do Apps

Última atualização 26 de jun de 2025

Funções personalizadas do VB

Função: serializar

  • Função: String Serialize(Object value)
  • Descrição: retorna uma representação de string do objeto especificado.

  • Exemplo:

    Serialize(Queues.testQueue.arg1)Serialize(Queues.testQueue.arg1)

Função: desserializar

  • Função: T Deserialize<T>(string obj)
  • Descrição: retorna um objeto do tipo T. Aceita como entrada uma representação de string JSON válida de um objeto.

  • Exemplo:

    Deserialize(Of AppsFile)(textV)Deserialize(Of AppsFile)(textV)
    Onde textV é uma variável do tipo Text, que contém a string serializada do objeto.

Função: App.QueryParam

Para objetos

  • Função:

    T? App.QueryParam<T>((string param, T? defaultValue = default(T))

  • Descrição:

    • Se o parâmetro de consulta for passado no URL, a função retornará esse valor desserializado com base no tipo genérico T.

    • Se a desserialização falhar ou se o parâmetro de consulta não for passado no URL, a função retornará o valor padrão.

  • Exemplo:

    App.QueryParam(Of AppsFile)("file", new AppsFile("https://i0.wp.com/
    imagelinkmri.com/wp-content/uploads/2021/08/imagelink-04.png"))App.QueryParam(Of AppsFile)("file", new AppsFile("https://i0.wp.com/
    imagelinkmri.com/wp-content/uploads/2021/08/imagelink-04.png"))

Para strings

  • Função:

    string App.QueryParam(string param, string? defaultValue = "")

  • Descrição:

    • Se o parâmetro de consulta for passado no URL, a função retornará esse valor como string.

    • Se o parâmetro de consulta não for passado no URL, a função retornará o valor padrão.

  • Exemplo:

    App.QueryParam("stringVariable", "defaultText")App.QueryParam("stringVariable", "defaultText")

Função: adicionar item à lista

  • Função: List<T> AddItemToList<T>(List<T> list, T value)
  • Descrição: dada uma lista do tipo T, anexa um item à lista e retorna a lista atualizada.

  • Exemplo:

    AddItemToList(Of String)(stringList, "AddMe")AddItemToList(Of String)(stringList, "AddMe")

Função: atualizar item da lista no índice

  • Função:

    List<T> UpdateListItemAtIndex<T>(List<T> list, int index, T value)

  • Descrição: dada uma lista do tipo T, atualiza o item no índice especificado e retorna a lista atualizada.

  • Exemplo:

    UpdateListItemAtIndex(Of String)(stringList, MainPage.EditGrid.RowIndex,"UpdateValue")UpdateListItemAtIndex(Of String)(stringList, MainPage.EditGrid.RowIndex,"UpdateValue")

Função: excluir item da lista

  • Função:

    List<T> DeleteItemFromList<T>(List<T> list, int index)

  • Descrição: dada uma lista do tipo T, exclui o item no índice especificado e retorna a lista atualizada.

  • Exemplo:

    DeleteItemFromList(Of String)(stringList, MainPage.EditGrid.RowIndex)DeleteItemFromList(Of String)(stringList, MainPage.EditGrid.RowIndex)

Função: buscar

This function is used by the Query builder. Refer to The Fetch function for more details on this function, and how to use it in practice.

Importante:
A função Fetch() é assíncrona e não é compatível com encadeamento.

To display an entity record in a control, bind the control data source to the entity using the Query builder. Refer to Using the Fetch functions for a practical example.

  • Função:

    ListSource<T> Fetch<T>(FilterGroup group = null, PaginationProps paginationProps = null, SortOption[] sortOptions = null, string[] selectedFields = null, ExpansionFieldOption[] expansionFieldOptions = null )

  • Descrição: retorna todos os registros de um objeto entidade, de acordo com os parâmetros mencionados.

  • Exemplo:

    Fetch(of AlexEntity)(createFilterGroup(Nothing, New FilterGroup(){createFilterGroup(New QueryFilter(){addFilter(MainPage.EditGrid.SearchColumn, "contains", MainPage.EditGrid.SearchTerm)}, Nothing, 0)}, 0), New PaginationProps(MainPage.EditGrid.PageStart, MainPage.EditGrid.PageLimit), New SortOption(){addSortOption(MainPage.EditGrid.SortColumn, Not(Not(MainPage.EditGrid.isDescending)))}, Nothing, New ExpansionFieldOption(){addExpansionFieldOption("CreatedBy", New String(){"Id","Name"}), addExpansionFieldOption("UpdatedBy", New String(){"Id","Name"})})Fetch(of AlexEntity)(createFilterGroup(Nothing, New FilterGroup(){createFilterGroup(New QueryFilter(){addFilter(MainPage.EditGrid.SearchColumn, "contains", MainPage.EditGrid.SearchTerm)}, Nothing, 0)}, 0), New PaginationProps(MainPage.EditGrid.PageStart, MainPage.EditGrid.PageLimit), New SortOption(){addSortOption(MainPage.EditGrid.SortColumn, Not(Not(MainPage.EditGrid.isDescending)))}, Nothing, New ExpansionFieldOption(){addExpansionFieldOption("CreatedBy", New String(){"Id","Name"}), addExpansionFieldOption("UpdatedBy", New String(){"Id","Name"})})

Função: buscar um

This function is used by the query builder, and should not be confused with the Fetch function. Refer to The Fetch function for details on the differences between these two functions, and how to use them in practice.

Importante:
A função FetchOne() é assíncrona e não é compatível com encadeamento.

To display entity records in a control,, use an app variable and the Set Value rule.

Refer to Using the Fetch functions for a practical example.

  • Função:

    T FetchOne<T>(FilterGroup group = null, PaginationProps paginationProps = null, SortOption[] sortOptions = null, string[] selectedFields = null, ExpansionFieldOption[] expansionFieldOptions = null)

  • Descrição: retorna um único registro de um objeto entidade, conforme os parâmetros mencionados.

  • Exemplo:

    FetchOne(of Employee)(
            createFilterGroup(new QueryFilter(){addFilter(
                MainPage.EditGrid.SearchColumn,"contains",MainPage.EditGrid.SearchTerm)}),
                new PaginationProps(MainPage.EditGrid.PageStart, MainPage.EditGrid.PageLimit),
                new SortOption(){
                    addSortOption(
                        MainPage.EditGrid.SortColumn,MainPage.EditGrid.isDescending)
                    }
    )FetchOne(of Employee)(
            createFilterGroup(new QueryFilter(){addFilter(
                MainPage.EditGrid.SearchColumn,"contains",MainPage.EditGrid.SearchTerm)}),
                new PaginationProps(MainPage.EditGrid.PageStart, MainPage.EditGrid.PageLimit),
                new SortOption(){
                    addSortOption(
                        MainPage.EditGrid.SortColumn,MainPage.EditGrid.isDescending)
                    }
    )

Função: criar grupo de filtros

Essa função é usada pelo construtor de Consultas.

  • Função:

    FilterGroup createFilterGroup(QueryFilter[] queryFilters, FilterGroup[] groups = null, int isAnd = 0)

  • Descrição: dada uma matriz de filtros de consulta e grupos de filtros, gera um grupo de filtros.

  • Exemplo:

    createFilterGroup(Nothing, New FilterGroup(){createFilterGroup(New QueryFilter(){addFilter(MainPage.EditGrid.SearchColumn, "contains", MainPage.EditGrid.SearchTerm)}, Nothing, 0)}, 0)createFilterGroup(Nothing, New FilterGroup(){createFilterGroup(New QueryFilter(){addFilter(MainPage.EditGrid.SearchColumn, "contains", MainPage.EditGrid.SearchTerm)}, Nothing, 0)}, 0)

Função: adicionar filtro

Essa função é usada pelo construtor de Consultas.

  • Função:

    QueryFilter addFilter(string columnName, string colOperator, string value)

  • Descrição: dado um nome da coluna, operador e valor, gera um filtro de consulta.

  • Exemplo:

    addFilter(MainPage.EditGrid.SearchColumn, "contains", MainPage.EditGrid.SearchTerm)addFilter(MainPage.EditGrid.SearchColumn, "contains", MainPage.EditGrid.SearchTerm)

Função: adicionar opção de classificação

Essa função é usada pelo construtor de Consultas.

  • Função:

    SortOption addSortOption(string columnName, bool isDescending = false)

  • Descrição: dado um nome da coluna e um valor de classificação, gera e classifica um filtro de consulta.

  • Exemplo:

    addSortOption(MainPage.EditGrid.SortColumn, Not(Not(MainPage.EditGrid.isDescending)))}addSortOption(MainPage.EditGrid.SortColumn, Not(Not(MainPage.EditGrid.isDescending)))}

Função: obter conjunto de escolhas

Importante:
  • A GetChoiceSet()função é assíncrona e não é compatível com encadeamento.
  • A entidade que hospeda o conjunto de escolhas deve ser adicionada ao seu aplicativo.

  • Função:

    ListSource<ChoiceSet> GetChoiceSet(string choiceSetName)

  • Descrição: dado o nome de um conjunto de escolhas Data Service, retorna todos os valores do conjunto de escolhas.

  • Exemplo:

    GetChoiceSet("Gender")GetChoiceSet("Gender")

Função: obter valor do conjunto de escolhas

Importante:
  • A função GetChoiceSet() é assíncrona e não suporta encadeamento.
  • A entidade que hospeda o conjunto de escolhas deve ser adicionada ao seu aplicativo.

  • Função:

    string GetChoiceSetValue(string choiceSetName, int numberId)

  • Descrição: dado o nome de um conjunto de escolhas Data Service e o índice de uma opção de conjunto de escolhas, retorna a opção especificada.

  • Exemplo:

    GetChoiceSetValue("Gender", 0)GetChoiceSetValue("Gender", 0)

Função: criar tabela de dados

  • Função:

    DataTable BuildDataTable(DataTable dt, DataColumn[] columns, List<Object> rowData, bool clear=false)

  • Descrição: carrega uma tabela de dados com colunas e linhas na regra Definir valor e retorna a tabela de dados atualizada.

    Se o parâmetro clear for verdadeiro, ele limpa o conteúdo das colunas e as linhas da tabela de dados.
  • Exemplo:

    BuildDataTable(
        New DataTable("TestDT"), 
        New DataColumn(){ New DataColumn("Name"), New DataColumn("Age")},
        New List(Of Object) From { 
            AddDataRow(New Object(){"Baishali", "30"}), 
            AddDataRow(New Object(){"Viswa", "33"}) 
        },
        True
    )BuildDataTable(
        New DataTable("TestDT"), 
        New DataColumn(){ New DataColumn("Name"), New DataColumn("Age")},
        New List(Of Object) From { 
            AddDataRow(New Object(){"Baishali", "30"}), 
            AddDataRow(New Object(){"Viswa", "33"}) 
        },
        True
    )

Função: adicionar linha

  • Função: AddRow(DataRow row)
  • Descrição: método de extensão de TabelaDeDados que adiciona a linha especificada a uma tabela de dados e retorna a instância atualizada.

  • Exemplo:

    dt.AddRow(row)dt.AddRow(row)

Função: excluir linha

  • Função: DeleteRowAt(int index)
  • Descrição: método de extensão de TabelaDeDados que exclui a linha no índice especificado em uma tabela de dados e retorna a instância atualizada.

  • Exemplo:

    dt.DeleteRowAt(2)dt.DeleteRowAt(2)

Função: atualizar linha em

  • Função: UpdateRowAt(int index, DataRow row)
  • Descrição: método de extensão de TabelaDeDados que atualiza a linha no índice especificado com os novos dados de linha e retorna a tabela de dados atualizada.

  • Exemplo:

    dt.UpdateRowAt(2, row)dt.UpdateRowAt(2, row)

Esta página foi útil?

Obtenha a ajuda que você precisa
Aprendendo RPA - Cursos de automação
Fórum da comunidade da Uipath
Uipath Logo
Confiança e segurança
© 2005-2025 UiPath. Todos os direitos reservados.