Fonctions VB personnalisées

Fonction : Sérialisée (Serialize)

• Fonction : String Serialize(Object value)

• Description : renvoie une représentation sous forme de chaîne de l'objet spécifié.

• Exemple :

  Serialize(Queues.testQueue.arg1)

Fonction : Désérialiser (Deserialize)

• Fonction : T Deserialize<T>(string obj)

• Description : renvoie un objet de type T. Prend en tant qu'entrée une représentation de chaîne JSON valide d'un objet.

• Exemple :

  Deserialize(Of AppsFile)(textV)

  Où textV est une variable de type Text, contenant la chaîne sérialisée de l'objet.

Fonction : App.QueryParam

Pour les objets

• Fonction :

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

• Description:

  • Si le paramètre de requête est transmis dans l'URL, la fonction renvoie cette valeur désérialisée en fonction du type générique T.

  • Si la désérialisation échoue ou si le paramètre de requête n'est pas transmis dans l'URL, la fonction renvoie la valeur par défaut.

• Exemple :

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

Pour les chaînes

• Fonction :

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

• Description:

  • Si le paramètre de requête est transmis dans l'URL, la fonction renvoie cette valeur sous forme de chaîne.

  • Si le paramètre de requête n'est pas transmis dans l'URL, la fonction renvoie la valeur par défaut.

• Exemple :

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

Fonction : Ajouter un élément à la liste (Add item to list)

• Fonction : List<T> AddItemToList<T>(List<T> list, T value)

• Description : à partir d'une liste de type T, ajoute un élément à la liste et renvoie la liste mise à jour.

• Exemple :

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

Fonction : Mettre à jour l'élément de la liste à l'index (Update list item at index)

• Fonction :

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

• Description : à partir d'une liste de type T, met à jour l'élément à l'index spécifié et renvoie la liste mise à jour.

• Exemple :

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

Fonction : Supprimer un élément de la liste (Delete item from list)

• Fonction :

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

• Description : à partir d'une liste de type T, supprime l'élément à l'index spécifié et renvoie la liste mise à jour.

• Exemple :

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

Fonction : Récupérer (Fetch)

Cette fonction est utilisée par le Générateur de requêtes (Query Builder). Reportez-vous à la fonction Récupérer (Fetch) pour plus de détails sur cette fonction et comment l'utiliser en pratique.

Important :

La fonction Fetch() est asynchrone et ne prend pas en charge le chaînage.

Pour afficher un enregistrement d'entité dans un contrôle, liez la source de données de contrôle à l'entité à l'aide du Générateur de requêtes (Query Builder). Reportez-vous à Utilisation des fonctions Récupérer pour voir un exemple pratique.

• Fonction :

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

• Description : renvoie tous les enregistrements d'un objet d'entité, en fonction des paramètres mentionnés.

• Exemple :

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

Fonction : Récupérer un (Fetch one)

Cette fonction est utilisée par le générateur de requêtes et ne doit pas être confondue avec la fonction Récupérer (Fetch). Reportez-vous à la fonction Récupérer (Fetch) pour plus de détails sur les différences entre ces deux fonctions et comment les utiliser en pratique.

Important :

La fonction FetchOne() est asynchrone et ne prend pas en charge le chaînage.

Pour afficher les enregistrements d'entité dans un contrôle,, utilisez une variable d'application et la règle Définir la valeur .

Reportez-vous à Utilisation des fonctions Récupérer pour voir un exemple pratique.

• Fonction :

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

• Description : renvoie un seul enregistrement d'un objet d'entité, en fonction des paramètres mentionnés.

• Exemple :

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

Fonction : Créer un groupe de filtres

Cette fonction est utilisée par le Générateur de requêtes (Query Builder).

• Fonction :

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

• Description : à partir d'un tableau de filtres de requête et de groupes de filtres, génère un groupe de filtres.

• Exemple :

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

Fonction : Ajouter un filtre (Add filter)

Cette fonction est utilisée par le Générateur de requêtes (Query Builder).

• Fonction :

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

• Description : à partir d'un nom de colonne, d'un opérateur et d'une valeur, génère un filtre de requête.

• Exemple :

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

Fonction : Ajouter une option de tri (Add sort option)

Cette fonction est utilisée par le Générateur de requêtes (Query Builder).

• Fonction :

  SortOption addSortOption(string columnName, bool isDescending = false)

• Description : à partir d'un nom de colonne et d'une valeur de tri, génère et trie un filtre de requête.

• Exemple :

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

Fonction : Obtenir l'ensemble de choix (Get choice set)

Important :

• La GetChoiceSet()fonction est asynchrone et ne prend pas en charge le chaînage.

• L'entité hébergeant l'ensemble de choix doit être ajoutée à votre application.

• Fonction :

  ListSource<ChoiceSet> GetChoiceSet(string choiceSetName)

• Description : étant donné le nom d'un ensemble de choix de Data Service, renvoie toutes les valeurs de l'ensemble de choix.

• Exemple :

  GetChoiceSet("Gender")

Fonction : Valeur Obtenir l'ensemble de choix (Get choice set)

Important :

• La fonction GetChoiceSet() est asynchrone et ne prend pas en charge le chaînage.

• L'entité hébergeant l'ensemble de choix doit être ajoutée à votre application.

• Fonction :

  string GetChoiceSetValue(string choiceSetName, int numberId)

• Description : en fonction du nom d'un ensemble de choix de Data Service et de l'index d'une option d'ensemble de choix, renvoie l'option spécifiée.

• Exemple :

  GetChoiceSetValue("Gender", 0)

Fonction : Créer une table de données (Build data table)

• Fonction :

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

• Description : charge une table de données avec des colonnes et des lignes dans la règle Définir la valeur (Set Value) et renvoie la table de données mise à jour.

  Si le paramètre clear est vrai, il efface le contenu des colonnes et des lignes de la table de données.

• Exemple :

  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
  )

Fonction : Ajouter une ligne (Add row)

• Fonction : AddRow(DataRow row)

• Description : méthode d'extension TableDonnées (DataTable) qui ajoute la ligne spécifiée à une table de données et renvoie l'instance mise à jour.

• Exemple :

  dt.AddRow(row)

Fonction : Supprimer une ligne (Delete row)

• Fonction : DeleteRowAt(int index)

• Description : méthode d'extension TableDonnées (DataTable) qui supprime la ligne au niveau de l'index spécifié dans une table de données et renvoie l'instance mise à jour.

• Exemple :

  dt.DeleteRowAt(2)

Fonction : Mettre à jour la ligne (Update row at)

• Fonction : UpdateRowAt(int index, DataRow row)

• Description : méthode d'extension TableDonnées (DataTable) qui met à jour la ligne au niveau l'index spécifié avec les nouvelles données de ligne et renvoie la table de données mise à jour.

• Exemple :

  dt.UpdateRowAt(2, row)