Zum Hauptinhalt springen

Table.PromoteHeaders

Stuft die erste Zeile mit Werten zu den neuen Spaltenüberschriften herauf (z. B. Spaltennamen).

Syntax​

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

Remarks​

Stuft die erste Zeile mit Werten zu den neuen Spaltenüberschriften (also Spaltennamen) herauf. Standardmäßig werden nur Text- oder Zahlenwerte zu Überschriften heraufgestuft. Gültige Optionen:

  • PromoteAllScalars: Bei Festlegung auf WAHR werden alle Skalarwerte in der ersten Zeile mithilfe von Culture zu Überschriften heraufgestuft, sofern angegeben (oder das aktuelle Gebietsschema für das Dokument). Für Werte, die nicht in Text konvertiert werden können, wird ein standardmäßiger Spaltenname verwendet.
  • Culture: Ein Kulturname, der die Kultur für die Daten angibt.

Examples​

Example #1​

Stuft die erste Zeile mit Werten in der Tabelle höher.

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​

Stuft alle Skalarwerte in der ersten Zeile der Tabelle zu Überschriften herauf.

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