Funciones VB personalizadas

Función: serializar

• Función: String Serialize(Object value)

• Descripción: devuelve una representación de string del objeto especificado.

• Ejemplo:

  Serialize(Queues.testQueue.arg1)

Función: deserializar

• Función: T Deserialize<T>(string obj)

• Descripción: devuelve un objeto de tipo T. Toma como entrada una representación de cadena JSON válida de un objeto.

• Ejemplo:

  Deserialize(Of AppsFile)(textV)

  Donde textV es una variable de tipo Texto, que contiene la cadena serializada del objeto.

Función: App.QueryParam

Para objetos

• Función:

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

• Descripción:

  • Si el parámetro de consulta se pasa en la URL , la función devuelve ese valor deserializado en función del tipo genérico T.

  • Si la deserialización falla o si el parámetro de consulta no se pasa en la URL, la función devuelve el valor por defecto.

• Ejemplo:

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

Para strings

• Función:

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

• Descripción:

  • Si el parámetro de consulta se pasa en la URL, la función devuelve ese valor como string.

  • Si el parámetro de consulta no se pasa en la URL, la función devuelve el valor predeterminado.

• Ejemplo:

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

Función: añadir elemento a la lista

• Función: List<T> AddItemToList<T>(List<T> list, T value)

• Descripción: dada una lista de tipo T, añade un elemento a la lista y devuelve la lista actualizada.

• Ejemplo:

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

Función: actualizar el elemento de la lista en el índice

• Función:

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

• Descripción: dada una lista de tipo T, actualiza el elemento en el índice especificado y devuelve la lista actualizada.

• Ejemplo:

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

Función: eliminar elemento de la lista

• Función:

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

• Descripción: dada una lista de tipo T, elimina el elemento en el índice especificado y devuelve la lista actualizada.

• Ejemplo:

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

Función: obtener

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:

La función Fetch() es asíncrona y no admite el encadenamiento.

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.

• Función:

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

• Descripción: devuelve todos los registros de un objeto de entidad, según los parámetros mencionados.

• Ejemplo:

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

Función: obtener uno

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:

La función FetchOne() es asíncrona y no admite el encadenamiento.

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.

• Función:

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

• Descripción: devuelve un solo registro de un objeto de entidad, según los parámetros mencionados.

• Ejemplo:

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

Función: crear grupo de filtros

Esta función la utiliza el Creador de consultas.

• Función:

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

• Descripción: dada una matriz de filtros de consulta y grupos de filtros, genera un grupo de filtros.

• Ejemplo:

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

Función: añadir filtro

Esta función la utiliza el Creador de consultas.

• Función:

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

• Descripción: dado el nombre, el operador y el valor de una columna, genera un filtro de consulta.

• Ejemplo:

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

Función: añadir opción de ordenación

Esta función la utiliza el Creador de consultas.

• Función:

  SortOption addSortOption(string columnName, bool isDescending = false)

• Descripción: dado el nombre de columna y un valor de clasificación, genera y ordena un filtro de consulta.

• Ejemplo:

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

Función: obtener el conjunto de opciones

Importante:

• La GetChoiceSet()función es asíncrona y no admite el encadenamiento.

• La entidad que aloja el conjunto de opciones debe añadirse a tu aplicación.

• Función:

  ListSource<ChoiceSet> GetChoiceSet(string choiceSetName)

• Descripción: dado el nombre de un conjunto de opciones de Data Service, devuelve todos los valores del conjunto de opciones.

• Ejemplo:

  GetChoiceSet("Gender")

Función: obtener el valor del conjunto de opciones

Importante:

• La función GetChoiceSet() es asíncrona y no admite el encadenamiento.

• La entidad que aloja el conjunto de opciones debe añadirse a tu aplicación.

• Función:

  string GetChoiceSetValue(string choiceSetName, int numberId)

• Descripción: dado el nombre de un conjunto de opciones de Data Service y el índice de una opción de conjunto de opciones, devuelve la opción especificada.

• Ejemplo:

  GetChoiceSetValue("Gender", 0)

Función: crear tabla de datos

• Función:

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

• Descripción: carga una tabla de datos con columnas y filas en la regla Establecer valor y devuelve la tabla de datos actualizada.

  Si el parámetro clear es verdadero, borra el contenido de las columnas y las filas de la tabla de datos.

• Ejemplo:

  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
  )

Función: añadir fila

• Función: AddRow(DataRow row)

• Descripción: método de extensión de DataTable que añade la fila especificada a una tabla de datos y devuelve la instancia actualizada.

• Ejemplo:

  dt.AddRow(row)

Función: eliminar fila

• Función: DeleteRowAt(int index)

• Descripción: método de extensión de DataTable que elimina la fila en el índice especificado de una tabla de datos y devuelve la instancia actualizada.

• Ejemplo:

  dt.DeleteRowAt(2)

Función: actualizar la fila en

• Función: UpdateRowAt(int index, DataRow row)

• Descripción: método de extensión de DataTable que actualiza la fila en el índice especificado con los nuevos datos de la fila y devuelve la tabla de datos actualizada.

• Ejemplo:

  dt.UpdateRowAt(2, row)