Syntax

	excelSheet(content: $content, name: $sheetName, colWidths: $colWidths, rowHeights: $rowHeights)

Beschreibung

Erstellt ein Arbeitsblatt für eine Excel-Datei. Diese Funktion wird innerhalb von excelFile() verwendet, um einzelne Arbeitsblätter mit Namen und Inhalten zu definieren.

Ein Arbeitsblatt kann entweder im Matrix-Format (eine Liste von Listen, wobei jede innere Liste eine Zeile repräsentiert) oder im Zellen-Format (eine Liste von excelCell()) vorliegen.

Parameter

Name	Typ	Beschreibung	Pflicht	Default
content	Objekt	Der Inhalt des Arbeitsblatts. Dies kann eine Liste von Listen (Matrix-Format) oder eine Liste von excelCell() sein.	ja
name	Zeichenkette	Der Name des Arbeitsblatts, der in der Excel-Registerkarte angezeigt wird. Bei leerem String wird automatisch ein Name generiert.	nein	""
colWidths	Map	Map mit Spaltennummern als Schlüssel und Spaltenbreiten als Werte. Die Breiten werden in Zeichen angegeben (z.B. {"0": 15, "1": 20}).	nein	null
rowHeights	Map	Map mit Zeilennummern als Schlüssel und Zeilenhöhen als Werte. Die Höhen werden in Punkten angegeben (z.B. {"0": 25, "1": 30}).	nein	null

Rückgabewert

Typ: Map

Ein Map-Objekt, das die Arbeitsblatt-Informationen für die Verarbeitung durch excelFile() enthält.

Beispiele

Arbeitsblatt im Matrix-Format

	excelSheet(
    name: "Mitarbeiterdaten",
    content: [
      ["Name", "Position", "Gehalt", "Eintrittsdatum"],
      ["Max Mustermann", "Entwickler", 65000, "2023-01-15"],
      ["Anna Schmidt", "Designerin", 58000, "2023-03-20"],
      ["Tom Weber", "Manager", 75000, "2022-11-10"]
    ]
  )

Ausgabe: Arbeitsblatt mit tabellarischen Daten in einem einfachen Rasterformat.

Arbeitsblatt mit Zellformatierung und Formeln

	excelSheet(
    name: "Berechnungen",
    content: [
      // Titelzeile
      excelCell(row: 0, col: 0, content: "Budgetübersicht 2024",
                style: excelStyle(bold: true, fontSize: 14, background: "#4472C4", color: "white", colSpan: 3)),

      // Spaltenüberschriften
      excelCell(row: 2, col: 0, content: "Kategorie", style: excelStyle(bold: true, background: "#D9E1F2")),
      excelCell(row: 2, col: 1, content: "Geplant", style: excelStyle(bold: true, background: "#D9E1F2")),
      excelCell(row: 2, col: 2, content: "Tatsächlich", style: excelStyle(bold: true, background: "#D9E1F2")),

      // Datenzeilen
      excelCell(row: 3, col: 0, content: "Marketing"),
      excelCell(row: 3, col: 1, content: 50000, style: excelStyle(numberFormat: "$#,##0")),
      excelCell(row: 3, col: 2, content: 52000, style: excelStyle(numberFormat: "$#,##0")),

      excelCell(row: 4, col: 0, content: "Entwicklung"),
      excelCell(row: 4, col: 1, content: 80000, style: excelStyle(numberFormat: "$#,##0")),
      excelCell(row: 4, col: 2, content: 75000, style: excelStyle(numberFormat: "$#,##0", color: "red")),

      // Summenzeile
      excelCell(row: 5, col: 0, content: "Gesamt", style: excelStyle(bold: true, borderTop: "double")),
      excelCell(row: 5, col: 1, content: excelFormula("SUM(B4:B5)"), style: excelStyle(numberFormat: "$#,##0", bold: true)),
      excelCell(row: 5, col: 2, content: excelFormula("SUM(C4:C5)"), style: excelStyle(numberFormat: "$#,##0", bold: true))
    ]
)

Ausgabe: Arbeitsblatt mit formatierten Zellen, verschiedenen Datentypen und Excel-Formeln.

Arbeitsblatt mit benutzerdefinierten Spaltenbreiten und Zeilenhöhen

	excelSheet(
    name: "Produktliste",
    content: [
      ["Produktname", "Beschreibung", "Preis", "Lagerbestand"],
      ["Widget Pro", "Hochwertiges Widget", 299.99, 150],
      ["Widget Basic", "Einfaches Widget", 99.99, 300],
      ["Widget Premium", "Premium Widget mit allen Funktionen", 499.99, 75]
    ],
    colWidths: {
      "0": 25, 
      "1": 40, 
      "2": 12,
      "3": 15 
    },
    rowHeights: {
      "0": 30
    }
  )

Ausgabe: Arbeitsblatt mit angepassten Spaltenbreiten für bessere Lesbarkeit und erhöhter Header-Zeile.

Arbeitsblatt mit automatischer Namensgenerierung

	excelSheet([
      ["Daten", "Wert"],
      ["Temperatur", 23.5],
      ["Luftfeuchtigkeit", 65]
    ]
  )

Ausgabe: Arbeitsblatt mit automatisch generiertem Namen wie "Sheet 1", "Sheet 2", etc.

​