Importera bild till Excel-ark – Aspose.Cells Cloud API-guide
Att importera en bild till ett Excel-ark gör det möjligt att berika kalkylark med visuellt innehåll såsom logotyper, diagram eller scheman. Denna guide visar hur du använder Aspose.Cells Clouds ImportPicture-åtgärd, det nödvändiga förfrågningsformatet och hur du hanterar svar.
Förutsättningar: Du måste ha ett giltigt JWT-autentiseringstoken och en redan existerande arbetsbok lagrad i Aspose Cloud-lagring innan du utför importåtgärden.
PostImportData API
POST https://api.aspose.cloud/v3.0/cells/import
Säkerhet och autentisering
Aspose.Cells Cloud-API:n är säkra och kräver JWT-tokenbaserad autentisering.
Förfrågningsparametrar
Förfrågan är en HTTP POST med innehållstypen multipart/related (se RFC 2046 eller RFC 1341).
- Den första delen innehåller ett JSON-objekt med namnet ImportPictureOption som beskriver var och hur bilden ska placeras.
- Den andra delen innehåller bildfilen (eller dess Base64-kodade data).
ImportPictureOption – definition
{
"UpperLeftRow": 0,
"UpperLeftColumn": 0,
"LowerRightRow": 10,
"LowerRightColumn": 5,
"Filename": "logo.png",
"Data": "iVBORw0KGgoAAAANSUhEUgAA...",
"DestinationWorksheet": "Sheet1",
"IsInsert": true,
"ImportDataType": "Picture",
"Source": { "FileSource": "Storage" }
}
IsInsert är en boolesk parameter – true infogar en ny bild, false ersätter en befintlig.
Viktiga parametrar
ImportPictureOption
| Parameternamn | Typ | Beskrivning |
|---|---|---|
| UpperLeftRow | int | Radindex för övre vänstra hörnet där bilden ska placeras. |
| UpperLeftColumn | int | Kolumnindex för övre vänstra hörnet där bilden ska placeras. |
| LowerRightRow | int | Radindex för nedre högra hörnet som definierar bildens gränser. |
| LowerRightColumn | int | Kolumnindex för nedre högra hörnet som definierar bildens gränser. |
| Filename | string | Namn på bildfilen. |
| Data | string | Base64-kodad binärdata för bilden (valfritt om filen skickas som den andra delen). |
| DestinationWorksheet | string | Namn på arket där bilden ska infogas. |
| IsInsert | boolean | true för att infoga en ny bild; false för att ersätta en befintlig. |
| ImportDataType | string | Typ av data som importeras (t.ex. Picture, IntArray, DoubleArray, StringArray, TwoDimensionIntArray, TwoDimensionDoubleArray, TwoDimensionStringArray, BatchData, csvData). |
| Source | FileSource | Anger var datafilen finns när parametern BatchData är null. |
Svar
En framgångsrik förfrågan returnerar HTTP 200 med ett JSON-svar liknande detta:
{
"Code": 200,
"Status": "OK"
}
Möjliga statuskoder:
| Kod | Betydelse |
|---|---|
| 200 | Importen lyckades |
| 400 | Felaktig förfrågan – saknad eller ogiltig data |
| 401 | Obehörig – ogiltig eller saknad token |
| 500 | Internt serverfel |
Hur du använder PostImportData API med SDK:er
PostImportData API-specificering
OpenAPI-specificeringen definierar ett offentligt tillgängligt programmeringsgränssnitt och gör det möjligt att utföra REST-interaktioner direkt från en webbläsare.
Använd Aspose.Cells Cloud SDK:er
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 projektuppgifter. Se GitHub-lagringsplatsen för en komplett lista över Aspose.Cells Cloud SDK:er.
Följande kodexempel visar hur du anropar Aspose.Cells-webbtjänster med hjälp av olika SDK:er: