So fügen Sie Arbeitsblätter zu Excel hinzu – Einfügen neuer Blätter an spezifischen Positionen
Fügen Sie programmgesteuert Arbeitsblätter zu Excel-Dateien hinzu und behalten Sie volle Kontrolle über den Blatttyp und die Position. Fügen Sie Standardarbeitsblätter, Diagrammblätter oder Makroblätter an beliebigen Positionen in der Arbeitsmappe ein. Dieser REST-basierte Vorgang ermöglicht die automatisierte Verwaltung und Organisation von Excel-Arbeitsmappen.
Voraussetzungen
- Ein aktiver Aspose.Cells Cloud-Account mit einem gültigen JWT-Zugriffstoken.
- Ein konfigurierter Cloud-Speichername (z. B.
CompanyOneDrive), in dem die Arbeitsmappe gespeichert werden soll. - Die Zielarbeitsmappe muss im angegebenen Speicher zugänglich sein; bei passwortgeschützten Dateien ist das korrekte Passwort anzugeben.
| Blatttyp | Beschreibung |
|---|---|
| VB | Visual-Basic-Modul |
| Worksheet | Normales Arbeitsblatt |
| Chart | Diagrammblatt |
| BIFF4Macro | BIFF4-Makroblatt |
| InternationalMacro | Internationales Makroblatt |
| Other | Benutzerdefiniertes oder seltenerer Blatttyp (nicht oben aufgeführt) |
| Dialog | Dialogarbeitsblatt |
API zum Hinzufügen eines Arbeitsblatts zu einem Tabellendokument
Web-API
PUT https://api.aspose.cloud/v4.0/cells/spreadsheet/add/worksheet
Sicherheit und Authentifizierung
Die Aspose.Cells Cloud APIs sind sicher und erfordern eine JWT-Token-basierte Authentifizierung.
Anforderungsparameter
| Parametername | Typ | Speicherort | Beschreibung |
|---|---|---|---|
| Spreadsheet | Datei | FormData | Erforderlich. Die Excel-Arbeitsmappe (.xlsx, .xls usw.), zu der ein neues Arbeitsblatt hinzugefügt werden soll. |
| sheetType | String | Query | Optional. Der Typ des zu erstellenden Blatts. Zulässige Werte sind worksheet (Standard), chartsheet, macrosheet, vbmodule und dialog. |
| position | Integer | Query | Optional. Nullbasierter Index, an dem das neue Blatt eingefügt werden soll. 0 fügt es vor dem ersten Blatt ein; 2 fügt es als drittes Blatt ein. Weglassen, um das Blatt am Ende anzuhängen. |
| sheetName | String | Query | Optional. Name für das neue Arbeitsblatt. Muss innerhalb der Arbeitsmappe eindeutig sein. Bei Weglassen wird ein Standardname wie „SheetX“ generiert. |
| outPath | String | Query | Optional. Zielverzeichnis im Cloud-Speicher, in dem die bearbeitete Arbeitsmappe gespeichert wird. Bei null oder Weglassen wird die Arbeitsmappe am gleichen Speicherort wie die Quelldatei oder in einem Standardpfad gespeichert. |
| outStorageName | String | Query | Erforderlich. Bezeichner des konfigurierten Cloud-Speichers (z. B. CompanyOneDrive), in den die Ausgabedatei geschrieben werden soll. |
| region | String | Query | Optional. Gebietsschema-Einstellung (z. B. de-DE), die das Formatieren und regionale Regeln im neuen Arbeitsblatt beeinflussen kann. |
| password | String | Query | Optional. Passwort zur Entschlüsselung und Bearbeitung einer passwortgeschützten Arbeitsmappe. Weglassen, falls die Datei nicht verschlüsselt ist. |
Antwort
Bei Erfolg gibt die API HTTP 200 OK (oder 201 Created, falls eine neue Datei erzeugt wird) mit der aktualisierten Arbeitsmappe zurück.
{
"Name": "ResponseFile",
"DataType": {
"Identifier": "File",
"Reference": "Stream"
}
}
HTTP-Statuscodes
| Code | Bedeutung | Beschreibung |
|---|---|---|
| 200 | OK | Filter erfolgreich angewendet; Antwort enthält Details zum Vorgang. |
| 400 | Bad Request | Fehlende oder ungültige Parameter (z. B. nicht unterstützter Dateityp). |
| 401 | Unauthorized | Ungültiges oder fehlendes JWT-Token. |
| 413 | Payload Too Large | Die hochgeladene Datei überschreitet das Größenlimit. |
| 500 | Internal Server Error | Unerwarteter Serverfehler. |
Wofür sollte die API zum Hinzufügen eines Arbeitsblatts zu einem Tabellendokument verwendet werden?
- Automatisierte Berichterstellung – Erstellen und Einfügen monatlicher Arbeitsblätter (z. B.
2024‑05) dynamisch bei der Erstellung von Finanzberichten. - Stapelweise Vorlageninitialisierung – Hinzufügen eines dedizierten Analysearbeitsblatts für jeden neuen Kunden oder jedes neue Projekt bei der Massenerstellung von Verkaufsangeboten oder Vorschlägen.
- Dynamische Dashboard-Erweiterung – Einfügen neuer Diagrammblätter in Echtzeit, sobald neue Datenmerkmale verfügbar sind.
- Compliance und Audit-Archivierung – Automatisches Hinzufügen von Nachweissammlungsblättern während jährlicher Audits, um jeden Prüfpunkt isoliert zu halten.
- Zum Entfernen eines Blatts siehe den Vorgang Arbeitsblatt löschen.
- Zum Verschieben eines Blatts siehe den Vorgang Arbeitsblatt verschieben.
Warum sollte man die API zum Hinzufügen eines Arbeitsblatts zu einem Tabellendokument verwenden?
- Entwicklerfreundlich – Aspose.Cells Cloud stellt SDKs für mehrere Sprachen zur Verfügung, reduziert den Entwicklungsaufwand und bietet umfangreiche Dokumentation.
- Reduzierte Arbeitskosten – Entfällt das manuelle Erstellen von Arbeitsblättern und wiederholtes Kopieren-Einfügen.
- Pay-per-Use – Sie zahlen nur für die tatsächlich durchgeführten API-Aufrufe.
- Kein Wartungsaufwand – Keine Server zu verwalten, keine Software-Updates und keine Kompatibilitätsprobleme.
Wie verwendet man die API zum Hinzufügen eines Arbeitsblatts zu einem Tabellendokument mit SDKs
Spezifikation der API zum Hinzufügen eines Arbeitsblatts zu einem Tabellendokument
Die Spezifikation der API zum Hinzufügen eines Arbeitsblatts zu einem Tabellendokument definiert eine öffentlich zugängliche Programmierschnittstelle und ermöglicht REST-Interaktionen direkt aus einem Webbrowser.
Sie können das cURL-Befehlszeilentool nutzen, um einfach auf Aspose.Cells-Webdienste zuzugreifen. Das folgende Beispiel zeigt, wie Sie mit cURL Aufrufe an die Cloud-API durchführen.
Verwendung der Aspose.Cells Cloud SDKs
Die Verwendung eines SDKs abstrahiert die niederwertigen Details und ermöglicht das Hinzufügen eines Arbeitsblatts mit minimalem Codeaufwand. Die vollständige Liste der SDKs finden Sie im GitHub-Repository.
Die folgenden Codebeispiele zeigen, wie der Dienst mit verschiedenen SDKs aufgerufen wird: