Aller au contenu principal

Table.PromoteHeaders

Promeut la première ligne des valeurs comme les nouveaux en-têtes de colonnes (par exemple, les noms de colonnes).

Syntax​

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

Remarks​

Promeut la première ligne de valeurs comme les 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 elles sont 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.

Examples​

Example #1​

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

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

Result:

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

Example #2​

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

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

Result:

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

Category​

Table.Column operations