Hur man byter namn på kalkylblad i Excel – ändra kalkylbladsnamn
Byt namn på kalkylblad i Excel-arbetsböcker programmatiskt med Aspose.Cells Cloud API. Ändra kalkylbladsnamn, uppdatera fliketiketter dynamiskt och automatisera kalkylarksorganisering via RESTful API-anrop. Användbar för dokumentstandardisering och arbetsflödesautomatisering.
Byt namn på kalkylbladsnamn i Spreadsheet API
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-exempel
curl -X PUT "https://api.aspose.cloud/v4.0/cells/spreadsheet/rename/worksheet?sourceName=Sheet1&targetName=Report_Q1" \
-H "Authorization: Bearer {access_token}" \
-F "spreadsheet=@myWorkbook.xlsx"
Säkerhet och autentisering
Aspose.Cells Cloud API:er är säkra och kräver JWT-tokenbaserad autentisering.
Begärparametrar
| Parameternamn | Typ | Plats | Beskrivning |
|---|---|---|---|
| Spreadsheet | Fil | FormData | Obligatoriskt. Excel-arbetsboksfilen (.xlsx, .xls etc.) som innehåller kalkylbladet som ska byta namn. |
| sourceName | Sträng | Fråga | Obligatoriskt. Det nuvarande namnet på det kalkylblad du vill byta namn på. |
| targetName | Sträng | Fråga | Obligatoriskt. Det nya namn som ska tilldelas kalkylbladet. Måste följa Excel-namngivningsregler (inga :, \, ?, *, [, ]) och vara unikt inom arbetsboken. |
| outPath | Sträng | Fråga | Valfritt. Målmappens sökväg i molnlagring där den döpta om arbetsboken kommer att sparas. Om null eller utelämnad sparar tjänsten filen i samma mapp som källarbetsboken (eller en standard sökväg). |
| outStorageName | Sträng | Fråga | Valfritt. Namnidentifieraren för din konfigurerade molnlagringstjänst (t.ex. ArchiveStorage). Om utelämnad används standardlagringen. |
| region | Sträng | Fråga | Valfritt. Det lokala inställningsvärdet (t.ex. sv-SE) som kan påverka teckenkodning eller regionala namngivningskonventioner. |
| password | Sträng | Fråga | Valfritt. Lösenordet som krävs för att dekryptera och redigera en lösenordsskyddad arbetsbok. Utelämna om filen inte är krypterad. |
Anteckningar: Kalkylbladsnamn är begränsade till 31 tecken och får inte innehålla tecknen :, \, ?, *, [, eller ].
Svar
Ett lyckat anrop returnerar ett JSON-objekt med statusinformation och en länk till den omdöpta filen.
[
{
"Name": "ResponseFile",
"DataType": {
"Identifier": "File",
"Reference": "Stream"
}
}
]
HTTP-statuskoder
| Kod | Betydelse | Beskrivning |
|---|---|---|
| 200 | OK | Filter applicerades framgångsrikt; svaret innehåller åtgärdens detaljer. |
| 400 | Felaktig förfrågan | Saknade eller ogiltiga parametrar (t.ex. filtyp som inte stöds). |
| 401 | Oautentiserad | Ogiltig eller saknad JWT-token. |
| 413 | För stor nyttolast | Den uppladdade filen överskrider storleksgränsen. |
| 500 | Internt serverfel | Oväntat serverfel. |
Var bör vi använda Rename Worksheet in Spreadsheet API?
- Rapportgenerering och varumärkesstandardisering – När kundrapporter genereras automatiskt kan generiska kalkylbladsnamn (t.ex.
Sheet1) bytas ut mot kundspecifika namn (t.ex.AcmeCorp_Q1_Summary) för att säkerställa ett professionellt utförande. - Standardisering av dataprocesseringspipeline – I ETL-arbetsflöden kan kalkylblad som exporteras med oregelbundna namn döpas om till standardiserade namn som
Raw_DataellerCleaned_Dataför att uppfylla kraven för efterföljande analys. - Multispråkigt innehållsleverans – Beroende på användarens språkpreferens kan kalkylbladsnamn översättas (t.ex.
数据ellerData) innan filen levereras, vilket ger en anpassad upplevelse.
Varför bör du använda Rename Worksheet in Spreadsheet API?
- Utvecklarvänligt – Ger SDK:er för flera språk med omfattande dokumentation, vilket förenklar integrationen jämfört med att bygga en egen lösning.
- Minskat arbetsinsats – Automatiserar kalkylbladsomdöpning och minskar manuellt arbete.
- Betala-per-användning-modell – Fakturerar endast för API-anrop, vilket eliminierar licenskostnader i förväg.
- Ingen serverunderhåll – Som en molntjänst behövs ingen servervärd eller programvaruuppdateringar.
- Stöd för automatisering – Underlättar för automatiserad dokumentstandardisering i arbetsflöden.
Hur man använder Rename Worksheet in Spreadsheet API med SDK:er
OpenAPI-specifikation
OpenAPI-specifikationen beskriver ett offentligt tillgängligt programmeringsgränssnitt, vilket möjliggör REST-interaktioner direkt från en webbläsare.
Du kan använda kommandoradsverktyget cURL för enkelt att komma åt Aspose.Cells-webbtjänster. Följande exempel visar hur man gör anrop till moln-API:et med cURL.
Använd Aspose.Cells Cloud SDK:er
Att använda ett SDK är det snabbaste sättet att påskynda utvecklingen. SDK:et abstraher underliggande HTTP-detaljer, så att du kan byta namn på kalkylblad med minimal kod. Se GitHub-repositoriet för en komplett lista över Aspose.Cells Cloud SDK:er.
Följande kodexempel visar hur man anropar Aspose.Cells-webbtjänster med olika SDK:er: