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. Alle Zellen der ersten Zeile müssen Text- oder Zahlenwerte enthalten. Standardmäßig werden nur Text- oder Zahlenwerte zu Überschriften heraufgestuft. Gültige Optionen:

PromoteAllScalars: Bei Festlegung auf true werden alle Skalarwerte in der ersten Zeile mithilfe von Culture zu Überschriften heraufgestuft, sofern angegeben (andernfalls wird das Gebietsschema für das Dokument verwendet). 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