Hämta namngivna intervall i en Excel-arbetsbok – Aspose.Cells Cloud API

Denna REST API returnerar information om namngivna intervall som definierats i kalkylblad.

Bakgrund – Ett namngivet intervall är en användardefinierad identifierare som pekar på en specifik cell eller cellgrupp i ett kalkylblad. Namngivna intervall förenklar formelskapande, förbättrar läsbarheten och möjliggör programmässig åtkomst till ofta använda områden i en arbetsbok.

Förutsättningar – Åtkomst till Aspose.Cells Cloud API kräver en giltig JWT-åtkomsttoken. Skaffa token genom att autentisera med ditt Aspose Cloud-klient-ID och klienthemlighet via OAuth 2.0-tokenändpunkten. Inkludera token i Authorization: Bearer <jwt token>-huvudet i varje begäran.

GetNamedRanges API

GET https://api.aspose.cloud/v3.0/cells/{name}/worksheets/ranges

Säkerhet och autentisering

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

Begärparametrar

Parameternamn	Typ	Plats	Beskrivning
name	string	Sökväg	Namnet på Excel-dokumentet.
folder	string	Frågesträng	Mappen som innehåller dokumentet.
storageName	string	Frågesträng	Lagringsnamnet där dokumentet är lagrat.

HTTP-statuskoder

Kod	Betydelse	Beskrivning
200	OK	Filter tillämpades framgångsrikt; svaret innehåller åtgärdens detaljer.
400	Felaktig begäran	Saknade eller ogiltiga parametrar (t.ex. filtyp som inte stöds).
401	Otillåten	Ogiltig eller saknad JWT-token.
413	För stor nyttolast	Den uppladdade filen överskrider storleksgränsen.
500	Internt serverfel	Oväntat serverfel.

OpenAPI-specifikationen definierar ett offentligt tillgängligt programmeringsgränssnitt som gör att du kan utföra REST-interaktioner direkt från en webbläsare.

Du kan använda kommandoradsverktyget cURL för att anropa Aspose.Cells-webbtjänster. Exemplet nedan visar hur du hämtar namngivna intervall med cURL.

Begäran

curl -v "https://api.aspose.cloud/v3.0/cells/test.xlsx/worksheets/ranges" \
  -X GET \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

Svar

{
  "Ranges": {
    "RangeList": [
      {
        "ColumnCount": 7,
        "ColumnWidth": 8.428571428571429,
        "FirstColumn": 1,
        "FirstRow": 9,
        "Name": "data",
        "RefersTo": "=Sheet1!$B$10:$H$10",
        "RowCount": 1,
        "RowHeight": 15,
        "Worksheet": "Sheet1"
      }
    ]
  },
  "Code": 200,
  "Status": "OK"
}

Svarsmodell

Fält	Typ	Beskrivning
`ColumnCount`	heltal	Antal kolumner i intervallet.
`ColumnWidth`	nummer	Bredd på varje kolumn (i punkter).
`FirstColumn`	heltal	Nollbaserat index för den första kolumnen i intervallet.
`FirstRow`	heltal	Nollbaserat index för den första raden i intervallet.
`Name`	sträng	Den användardefinierade namn på intervallet.
`RefersTo`	sträng	En formel som definierar cellreferensen (t.ex. `=Sheet1!$B$10:$H$10`).
`RowCount`	heltal	Antal rader i intervallet.
`RowHeight`	nummer	Höjd på varje rad (i punkter).
`Worksheet`	sträng	Namnet på kalkylbladet som innehåller intervallet.

Moln-SDK-familj

Att använda en SDK är det snabbaste sättet att integrera denna funktionalitet. SDK:er hanterar detaljer på lågnivå så att du kan fokusera på din affärslogik. Se GitHub-lagringsplatsen för en fullständig lista över Aspose.Cells Cloud SDK:er.

Följande kodexempel visar hur du anropar Aspose.Cells-webbtjänster med olika SDK:er:

Hämta celldata baserat på namngivet intervall