apps
2024.10
true
Important :
Veuillez noter que ce contenu a été localisé en partie à l’aide de la traduction automatique. La localisation du contenu nouvellement publié peut prendre 1 à 2 semaines avant d’être disponible.
UiPath logo, featuring letters U and I in white

Guide de l'utilisateur d'Apps

Automation CloudAutomation Cloud Public SectorAutomation Suite
Dernière mise à jour 18 déc. 2024

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)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)Deserialize(Of AppsFile)(textV)
    textV est une variable de type Texte (Tex) 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"))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")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")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")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)DeleteItemFromList(Of String)(stringList, MainPage.EditGrid.RowIndex)

Fonction : Récupérer (Fetch)

Reportez-vous à la fonction Récupérer (Fetch) pour plus de détails sur cette fonction et comment l'utiliser en 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"})})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"})})
    Remarque :
    La fonction Fetch() est utilisée par le Générateur de requêtes et est asynchrone.

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

À ne pas confondre avec la fonction Récupérer (Fetch). Reportez-vous à la fonction Récupérer (Fetch) pour en savoir plus sur les différences entre ces deux fonctions et découvrir comment les utiliser en 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)
                    }
    )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)
                    }
    )
    Remarque :
    La fonction FetchOne() est utilisée par le Générateur de requêtes et est asynchrone.

Fonction : Créer un groupe de filtres

  • 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)createFilterGroup(Nothing, New FilterGroup(){createFilterGroup(New QueryFilter(){addFilter(MainPage.EditGrid.SearchColumn, "contains", MainPage.EditGrid.SearchTerm)}, Nothing, 0)}, 0)
Remarque :
La fonction createFilterGroup() est utilisée par le Générateur de requêtes.

Fonction : Ajouter un filtre (Add filter)

  • 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)addFilter(MainPage.EditGrid.SearchColumn, "contains", MainPage.EditGrid.SearchTerm)
Remarque :
La fonction addFilter() est utilisée par le Générateur de requêtes.

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

  • 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)))}addSortOption(MainPage.EditGrid.SortColumn, Not(Not(MainPage.EditGrid.isDescending)))}
Remarque :
La fonction addSortOption() est utilisée par le Générateur de requêtes.

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

  • 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")GetChoiceSet("Gender")
Remarque :

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

La fonction GetChoiceSet() est asynchrone.

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

  • 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)GetChoiceSetValue("Gender", 0)
Remarque :

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

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
    )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)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)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)dt.UpdateRowAt(2, row)

Function: Update cell at (using column index)

  • Function: UpdateCellAt(int rowIndex, int columnIndex, object value)
  • Description: DataTable extension method that updates the cell of the datatable at the specified row index and column index.

  • Exemple :

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

Function: Update cell at (using column name)

  • Function: UpdateCellAt(int rowIndex, string columnName, object value)
  • Description: DataTable extension method that updates the cell of the datatable at the specified row index and column name.

  • Exemple :

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

Cette page vous a-t-elle été utile ?

Obtenez l'aide dont vous avez besoin
Formation RPA - Cours d'automatisation
Forum de la communauté UiPath
Uipath Logo White
Confiance et sécurité
© 2005-2024 UiPath Tous droits réservés.