Table.PromoteHeaders

Syntaxe

Table.PromoteHeaders(table as table, optional options as nullable record) as table

À propos

Promeut la première ligne de valeurs en tant que nouveaux en-têtes de colonnes (par exemple, les noms de colonnes). Par défaut, seules les valeurs de texte ou de nombre sont promues en en-têtes. Options valides :

• PromoteAllScalars : si la valeur est définie sur true, toutes les valeurs scalaires de la première ligne sont promues en en-têtes à l’aide de la Culture, si elle est spécifiée (ou les paramètres régionaux actuels du document). Pour les valeurs qui ne peuvent pas être converties en texte, un nom de colonne par défaut est utilisé.
• Culture : nom de culture spécifiant la culture pour les données.

Exemple 1

Promeut la première ligne des valeurs dans la table.

Utilisation

Table.PromoteHeaders(
    Table.FromRecords({
        [Column1 = "CustomerID", Column2 = "Name", Column3 = #date(1980, 1, 1)],
        [Column1 = 1, Column2 = "Bob", Column3 = #date(1980, 1, 1)]
    })
)

Sortie

Table.FromRecords({[CustomerID = 1, Name = "Bob", Column3 = #date(1980, 1, 1)]})

Exemple 2

Promeut toutes les valeurs scalaires de la première ligne de la table en en-têtes.

Utilisation

Table.PromoteHeaders(
    Table.FromRecords({
        [Rank = 1, Name = "Name", Date = #date(1980, 1, 1)],
        [Rank = 1, Name = "Bob", Date = #date(1980, 1, 1)]}
    ),
    [PromoteAllScalars = true, Culture = "en-US"]
)

Sortie

Table.FromRecords({[1 = 1, Name = "Bob", #"1/1/1980" = #date(1980, 1, 1)]})