Byt/utväxla data mellan kolumner, rader och celler i Excel

Utväxla automatiskt data mellan valfria två kolumner, rader, intervall eller celler i Excel-filer med Aspose.Cells Cloud API. Swap Range API:t möjliggör exakt datautväxling med bevarande av all formatering, formler och cellreferenser. Det stöder komplex dataomorganisering, batchbearbetning och sömlös molnintegration för företagsarbetsflöden.

Swap Range API

Web API

PUT https://api.aspose.cloud/v4.0/cells/swap/range

Säkerhet och autentisering

Aspose.Cells Cloud API:er är säkra och kräver JWT-tokenbaserad autentisering.

-H "Authorization: Bearer {access_token}"

Begäranparametrar

Parameter Name Typ Plats Beskrivning
Spreadsheet Fil FormData Obligatorisk. Käll-Excel-arbetsboksfilen (.xlsx, .xls).
worksheet1 Sträng Fråga Obligatorisk. Namnet på det kalkylblad som innehåller det första dataområdet.
range1 Sträng Fråga Obligatorisk. Cellintervall (t.ex. A1:D10) i worksheet1 som ska bytas.
worksheet2 Sträng Fråga Obligatorisk. Namnet på det kalkylblad som innehåller det andra dataområdet (kan vara samma som worksheet1).
range2 Sträng Fråga Obligatorisk. Cellintervall (t.ex. F1:I10) i worksheet2 som ska bytas. Viktigt: range1 och range2 måste ha identiska dimensioner.
outPath Sträng Fråga Valfri. Mapp i molnlagring där den ändrade arbetsboken kommer att sparas.
outStorageName Sträng Fråga Obligatorisk. Namn på den konfigurerade molnlagringstjänsten (t.ex. MyCompanyStorage).
region Sträng Fråga Valfri. Lokal inställning (t.ex. sv-SE, en-US, ja-JP) som kan påverka formatering.
password Sträng Fråga Valfri. Lösenord för att dekryptera ett skyddat kalkylark. Utelämna om det inte är krypterat.

Exempel på begäran (cURL)

curl -X PUT "https://api.aspose.cloud/v4.0/cells/swap/range?worksheet1=Sheet1&range1=A1:D10&worksheet2=Sheet2&range2=F1:I10&outStorageName=MyCompanyStorage" \
     -H "Authorization: Bearer {access_token}" \
     -F "Spreadsheet=@/path/to/workbook.xlsx"

Svar

[
  {
    "Name": "ResponseFile",
    "DataType": {
      "Identifier": "File",
      "Reference": "Stream"
    }
  }
]

Anteckningar:

  • API:t returnerar den ändrade arbetsboken som en filström. Om outPath anges sparas filen även på den angivna platsen i molnlagringen.
  • Om intervallens dimensioner inte matchar får du ett 400 Bad Request-fel.

Felkoder

Kod Beskrivning
400 Bad Request Ogiltig begärans-URI eller icke matchande intervalldimensioner.
401 Unauthorized Ogiltig eller utgången åtkomsttoken; client-id eller hemlighet är felaktiga.
404 Not Found Den angivna kalkylarksfilen kan inte nås.
500 Server Error Ett internt fel uppstod vid bearbetning av arbetsboken.

Var bör vi använda Swap Range API?

  • Omräkning av finansiella modeller – Omorganisera datablock (t.ex. flytta Q3-prognosen till Q4) med bevarande av formler och villkorlig formatering.
  • Dataflöden och ETL-proceser – Byt ut rådataintervall mot rensade intervall i ett mellanlager-kalkylblad innan slutgiltig utdata skapas.
  • Felkorrigering och dataåterställning – Snabbt korrigera felplacerad data utan manuell kopiering och klistra in.

Varför använda Swap Range API?

  • Utvecklarvänligt – SDK:er finns för flera programmeringsspråk, vilket minskar utvecklingsarbetet jämfört med att bygga egna lösningar.
  • Sänker arbetskostnader – Automatiserar dataomfördelning, vilket minskar behovet av manuell sammanställning.
  • Betala per användning – Du betalar bara för de API-anrop som du faktiskt gör.
  • Ingen underhållsbehov – Inga servrar att hantera, ingen programvaruuppdatering och inga kompatibilitetsproblem.

Hur man använder Swap Range API med SDK:er

Swap Range API-specifikation

Swap Range API-specifikationen definierar ett offentligt tillgängligt programmeringsgränssnitt och låter dig utföra REST-interaktioner direkt från en webbläsare.

Använd Aspose.Cells Cloud SDK:er

Att använda en SDK är det snabbaste sättet att utveckla, eftersom den abstraher bort detaljer på låg nivå och gör att du kan byta intervall med kort kod. Se GitHub-arkivet för en komplett lista över Aspose.Cells Cloud SDK:er.

Följande kodexempel visar hur du gör anrop till Aspose.Cells webbtjänster med olika SDK:er:

UnpivotRange Ta bort dubbletter