So benennen Sie Arbeitsblätter in Excel um – Ändern Sie Blattnamen
Benennen Sie Arbeitsblätter in Excel-Arbeitsmappen programmgesteuert mit der Aspose.Cells Cloud API um. Ändern Sie Blattnamen, aktualisieren Sie Registerkartenbezeichnungen dynamisch und automatisieren Sie die Organisation von Tabellenkalkulationen über RESTful API-Aufrufe. Nützlich für die Dokumentstandardisierung und Workflow-Automatisierung.
Arbeitsblattnamen in der Tabellenkalkulations-API umbenennen
Web-API
PUT https://api.aspose.cloud/v4.0/cells/spreadsheet/rename/worksheet?sourceName={sourceName}&targetName={targetName}&outPath={outPath}&outStorageName={outStorageName}®ion={region}&password={password}
cURL-Beispiel
curl -X PUT "https://api.aspose.cloud/v4.0/cells/spreadsheet/rename/worksheet?sourceName=Blatt1&targetName=Bericht_Q1" \
-H "Authorization: Bearer {access_token}" \
-F "spreadsheet=@meineArbeitsmappe.xlsx"
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-Arbeitsmappendatei (.xlsx, .xls usw.), die das umzubenennende Arbeitsblatt enthält. |
| sourceName | Zeichenkette | Abfrage | Erforderlich. Der aktuelle Name des Arbeitsblatts, das umbenannt werden soll. |
| targetName | Zeichenkette | Abfrage | Erforderlich. Der neue Name, der dem Arbeitsblatt zugewiesen werden soll. Muss den Excel-Benennungsregeln entsprechen (keine Zeichen :, \, ?, *, [, ]) und innerhalb der Arbeitsmappe eindeutig sein. |
| outPath | Zeichenkette | Abfrage | Optional. Der Zielordnerpfad im Cloud-Speicher, in dem die umbenannte Arbeitsmappe gespeichert wird. Wenn null oder weggelassen, speichert der Dienst die Datei im gleichen Ordner wie die Originaldatei (oder einem Standardpfad). |
| outStorageName | Zeichenkette | Abfrage | Optional. Der Name-Bezeichner Ihres konfigurierten Cloud-Speicherdienstes (z. B. ArchiveStorage). Wenn weggelassen, wird der Standardspeicher verwendet. |
| region | Zeichenkette | Abfrage | Optional. Die Gebietsschemaeinstellung (z. B. de-DE), die die Zeichenkodierung oder regionale Benennungskonventionen beeinflussen kann. |
| password | Zeichenkette | Abfrage | Optional. Das Entschlüsselungspasswort, das zum Öffnen und Bearbeiten einer passwortgeschützten Arbeitsmappe erforderlich ist. Weglassen, wenn die Datei nicht verschlüsselt ist. |
Hinweise: Arbeitsblattnamen sind auf 31 Zeichen begrenzt und dürfen keine der folgenden Zeichen enthalten: :, \, ?, *, [ oder ].
Antwort
Eine erfolgreiche Anforderung gibt ein JSON-Objekt mit Statusinformationen und einem Link zur umbenannten Datei zurück.
[
{
"Name": "ResponseFile",
"DataType": {
"Identifier": "File",
"Reference": "Stream"
}
}
]
HTTP-Statuscodes
| Code | Bedeutung | Beschreibung |
|---|---|---|
| 200 | OK | Filter erfolgreich angewendet; Antwort enthält Operationsdetails. |
| 400 | Ungültige Anforderung | Fehlende oder ungültige Parameter (z. B. nicht unterstützter Dateityp). |
| 401 | Nicht autorisiert | Ungültiges oder fehlendes JWT-Token. |
| 413 | Anforderungstext zu groß | Hochgeladene Datei überschreitet die Größenbegrenzung. |
| 500 | Interner Serverfehler | Unerwarteter Serverfehler. |
Wofür sollte die Funktion „Arbeitsblatt in Tabellenkalkulation umbenennen“ verwendet werden?
- Berichtsgenerierung und Markenstandardisierung – Bei der automatischen Erstellung von Kundenberichten werden generische Arbeitsblattnamen (z. B.
Blatt1) in kundenspezifische Namen (z. B.AcmeCorp_Q1_Zusammenfassung) umbenannt, um eine professionelle Übergabe sicherzustellen. - Standardisierung von Datenverarbeitungspipelines – In ETL-Workflows werden Arbeitsblätter mit unregelmäßigen Namen in standardisierte Namen wie
RohdatenoderBereinigte_Datenumbenannt, um Anforderungen nachgelagerter Analysen zu erfüllen. - Mehrsprachige Inhaltsbereitstellung – Basierend auf der Spracheinstellung des Nutzers werden Arbeitsblattnamen lokalisiert (z. B.
数据oderData), bevor die Datei bereitgestellt wird, um eine maßgeschneiderte Erfahrung zu bieten.
Warum sollten Sie die Funktion „Arbeitsblatt in Tabellenkalkulation umbenennen“ verwenden?
- Entwicklerfreundlich – Bietet SDKs für mehrere Sprachen mit umfassender Dokumentation, was die Integration im Vergleich zur Erstellung einer benutzerdefinierten Lösung vereinfacht.
- Geringerer Aufwand – Automatisiert das Umbenennen von Arbeitsblättern und reduziert manuelle Arbeit.
- Pay-per-Use-Modell – Berechnet nur für API-Aufrufe; entfällt daher auf Anfangslizenzkosten.
- Kein Serverbetrieb – Als Cloud-Dienst entfällt der Bedarf an Hosting und Wartung von Servern sowie an Softwareupdates.
- Unterstützung für Automatisierung – Ermöglicht die automatisierte Dokumentstandardisierung innerhalb von Workflows.
So verwenden Sie die Funktion „Arbeitsblatt in Tabellenkalkulation umbenennen“ mit SDKs
OpenAPI-Spezifikation
Die OpenAPI-Spezifikation beschreibt eine öffentlich zugängliche Programmierschnittstelle, die REST-Interaktionen direkt aus einem Webbrowser ermöglicht.
Sie können das cURL-Befehlszeilentool verwenden, um Aspose.Cells-Webdienste einfach aufzurufen. Das folgende Beispiel zeigt, wie Aufrufe an die Cloud-API mit cURL durchgeführt werden.
Verwenden von Aspose.Cells Cloud SDKs
Die Verwendung eines SDKs ist die schnellste Möglichkeit, die Entwicklung zu beschleunigen. Das SDK abstrahiert die zugrunde liegenden HTTP-Details, sodass Sie Arbeitsblätter mit minimalem Code umbenennen können. Eine vollständige Liste der Aspose.Cells Cloud SDKs finden Sie im GitHub-Repository.
Die folgenden Codebeispiele zeigen, wie Aspose.Cells-Webdienste mit verschiedenen SDKs aufgerufen werden: