Funções personalizadas do VB

Funções personalizadas do VB disponíveis no UiPath Apps, incluindo Serialize, Deserialize, App.QueryParam e auxiliares de manipulação de lista com exemplos de sintaxe e uso.

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)
  

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)
  

Onde textV é uma variável do tipo Text, contendo 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"))
  

Para as 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")
  

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")
  

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")
  

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)
  

Função: buscar

Essa função é usada pelo construtor de Consultas. Consulte A função Fetch para obter mais detalhes sobre essa função e como usá-la na prática.

Importante:

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

Para exibir um registro de entidade em um controle, associe a origem de dados do controle à entidade usando o construtor de Consultas.

Consulte Uso das funções Fetch para um exemplo prático.

• 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"})})
  

Função: buscar um

Essa função é usada pelo construtor de consultas e não deve ser confundida com a função Fetch. Consulte A função Fetch para obter detalhes sobre as diferenças entre essas duas funções e como usá-las na prática.

Importante:

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

Para exibir registros de entidade em um controle, use uma variável de aplicativo e a regra Definir valor .

Consulte Uso das funções Fetch para um exemplo prático.

• 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)
                  }
  )
  

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)
  

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)
  

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)))}
  

Função: obter conjunto de escolhas

Importante:

• A função GetChoiceSet() é 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")
  

Função: obter o 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)
  

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
  )
  

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)
  

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)
  

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)
  

Função: atualizar célula em (usando índice de coluna)

• Função: UpdateCellAt(int rowIndex, int columnIndex, object value)
• Descrição: método de extensão de TabelaDeDados que atualiza a célula da TabelaDeDados no índice de linha especificado e no índice de coluna especificado.
• Exemplo:

  dt.UpdateCellAt(0, 2, "Hi")
  

Função: atualizar célula em (usando nome da coluna)

• Função: UpdateCellAt(int rowIndex, string columnName, object value)
• Descrição: método de extensão de TabelaDeDados que atualiza a célula da TabelaDeDados no índice de linha e nome de coluna especificados.
• Exemplo:

  dt.UpdateCellAt(0, "Greetings", "Hi")