Table.PromoteHeaders

  • Článek

Syntaxe

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

O uživateli

Podporuje první řádek hodnot jako záhlaví nových sloupců (tj. názvy sloupců). Ve výchozím nastavení se na záhlaví upřednostní pouze textové nebo číselné hodnoty. Platné možnosti:

  • PromoteAllScalars: Pokud je nastavena hodnota true, budou všechny skalární hodnoty v prvním řádku povýšeny na hlavičky pomocí Culture, pokud je zadán (nebo aktuální národní prostředí dokumentu). Pro hodnoty, které nelze převést na text, se použije výchozí název sloupce.
  • Culture: Název jazykové verze určující jazykovou verzi dat.

Příklad 1

Zvýšení úrovně prvního řádku hodnot v tabulce

Využití

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

Výstup

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

Příklad 2

Zvyšte úroveň všech skalárů v prvním řádku tabulky na záhlaví.

Využití

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

Výstup

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