Flytta ett namngivet intervall med ett Excel-arbetsblad med Aspose.Cells Cloud API

Att flytta ett namngivet intervall är en vanlig uppgift när du behöver omorganisera data programmässigt. Detta avsnitt förklarar hur du flyttar ett definierat intervall till en ny position på samma arbetsblad med Aspose.Cells Cloud REST API.

Detta REST API flyttar ett angivet intervall till ett målintervall på ett Excel-arbetsblad.

REST API

POST https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/ranges/moveto

Autentisering

API:t kräver ett Bearer JWT-token som erhålls via Aspose Cloud OAuth-flödet. Inkludera token i Authorization-huvudet:

Authorization: Bearer <jwt token>

Token:t måste ha scope:et Cells.

Förutsättningar

Arbetsboken måste lagras i Aspose Cloud-lagring.
Angiv storageName och mappvägen (folder) om filen inte finns i rotkatalogen.
Använd den senaste Aspose.Cells Cloud SDK-versionen som stöder API-version v3.0.

Säkerhet och autentisering

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

Begärans parametrar

Namn	Typ	Plats	Beskrivning
name	string	path	Namn på arbetsboksfilen
sheetName	string	path	Namn på arbetsbladet
destRow	integer	query	Startradindex för målintervall (0-baserat)
destColumn	integer	query	Startkolumnindex för målintervall (0-baserat)
range	object	body	Definition av källintervall som ska flyttas
folder	string	query	Mappväg där arbetsboken lagras
storageName	string	query	Namn på Aspose Cloud-lagringen

Begäran kropp (Request Body)

Fält	Typ	Obligatoriskt	Beskrivning
ColumnCount	integer	Nej	Antal kolumner i källintervall
ColumnWidth	integer	Nej	Bredd på varje kolumn (i punkter)
FirstColumn	integer	Nej	0-baserat index för första kolumnen i källintervall
FirstRow	integer	Nej	0-baserat index för första raden i källintervall
Name	string	Nej	Namn på intervallet (om det är ett namngivet intervall)
RefersTo	string	Nej	A1-stilreferens som definierar intervallet
RowCount	integer	Nej	Antal rader i källintervall
RowHeight	integer	Nej	Höjd på varje rad (i punkter)
Worksheet	string	Nej	Arbetsblad som innehåller källintervall

Arbetsflöde

Ladda upp arbetsboken till Aspose Cloud-lagring (om den inte redan finns).
Generera en JWT-token med OAuth-endpointen.
Bygg JSON-payload som beskriver källintervall.
Anropa moveto-endpointen med nödvändiga path, query-parametrar och JSON-body.
Verifiera svaret; en lyckad anrop returnerar status 200 OK.

Exempel på begäran/svar

Begäran

curl -v "https://api.aspose.cloud/v3.0/cells/test.xlsx/worksheets/Sheet1/ranges/moveto?destRow=20&destColumn=20" \
-X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer <jwt token>" \
-d '{ 
  "ColumnCount": 7,
  "ColumnWidth": 19,
  "FirstColumn": 0,
  "FirstRow": 9,
  "Name": "MyRange",
  "RefersTo": "A10:G10",
  "RowCount": 1,
  "RowHeight": 15,
  "Worksheet": "Sheet1"
}'

Svar

{
  "Code": 200,
  "Status": "OK"
}

När ett fel inträffar innehåller svaret ett valfritt fält ErrorMessage som ger ytterligare information om felet.

HTTP-statuskoder

Kod	Betydelse	Beskrivning
200	OK	Filter applicerades framgångsrikt; svaret innehåller åtgärdens detaljer.
400	Bad Request	Saknade eller ogiltiga parametrar (t.ex. filtyp som inte stöds).
401	Unauthorized	Ogiltig eller saknad JWT-token.
413	Payload Too Large	Den uppladdade filen överskrider storleksgränsen.
500	Internal Server Error	Oväntat serverfel.

Svarschema

Fält	Typ	Beskrivning
Code	integer	HTTP-liknande statuskod returnerad av API:t (t.ex. 200)
Status	string	Textuell beskrivning av resultatet (t.ex. “OK”)
ErrorMessage	string (valfritt)	Mänsklig läsbara felinformation när anropet misslyckas

Moln SDK-familj

Att använda en SDK är det bästa sättet att påskynda utvecklingen. En SDK hanterar detaljer på lågnivå så att du kan fokusera på dina projektoppgifter. Se GitHub-förrådet för en komplett lista över Aspose.Cells Cloud SDK:er.

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