Table.PromoteHeaders

  • Artykuł

Składnia

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

Informacje

Promuje pierwszy wiersz wartości jako nowe nagłówki kolumn (tj. nazwy kolumn). Domyślnie tylko wartości tekstowe lub liczbowe są promowane do nagłówków. Prawidłowe opcje:

  • PromoteAllScalars: Jeśli ustawiono wartość true, wszystkie wartości skalarne w pierwszym wierszu są promowane do nagłówków przy użyciu parametru Culture, jeśli określono (lub bieżące ustawienia regionalne dokumentu). W przypadku wartości, których nie można przekonwertować na tekst, zostanie użyta domyślna nazwa kolumny.
  • Culture: nazwa kultury określająca kulturę danych.

Przykład 1

Podwyższ poziom pierwszego wiersza wartości w tabeli.

Użycie

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

Wyjście

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

Przykład 2

Podwyższ poziom wszystkich skalarnych w pierwszym wierszu tabeli do nagłówków.

Użycie

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

Wyjście

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