Documentation –

Developer-Guide: Skapa en tom Excel-arbetsbok

Mon, 01 Jan 0001 00:00:00 +0000

Denna REST API skapar en tom arbetsbok.

PutWorkbookCreate API

PUT https://api.aspose.cloud/v3.0/cells/{name}

Säkerhet och autentisering

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

Frågeparametrar

Parameternamn	Typ	Beskrivning
templateFile	string	Sökväg till en mallarbetsbok som ska användas som bas (valfritt).
dataFile	string	Sökväg till en datafil för att fylla i arbetsboken (valfritt).
isWriteOver	boolean	`true` för att skriva över en befintlig fil; `false` annars.
folder	string	Målmapp för den skapade arbetsboken (valfritt).
storageName	string	Namn på den lagringstjänst som ska användas.

Begäranhållningsparameter

Parameternamn	Typ	Beskrivning
data	file	Binärt innehåll i den arbetsboksfil som ska skapas.

Svar

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

HTTP-statuskoder

Kod	Betydelse	När den returneras
200 OK	Arbetsboken skapades lyckades	Normalt flöde
201 Created	Arbetsboken skapades (alternativt svar)	När API:et returnerar en “created”-status
400 Bad Request	Ogiltiga parametrar	Klientsidigt fel
401 Unauthorized	Saknas eller ogiltig token	Autentiseringsfel
409 Conflict	Filen finns och `isWriteOver=false`	Konflikt med befintlig fil

Hur du använder PutWorkbookCreate API med SDK:er

PutWorkbookCreate API-specificering

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

Du kan använda kommandoradsverktyget cURL för att komma åt Aspose.Cells-webbtjänster. Inkludera Authorization-huvudet med en giltig OAuth2/JWT-åtkomsttoken. För en tom arbetsbok är begäranhållningen valfri; om du behöver ladda upp en fil lägger du till --data-binary @empty.xlsx enligt nedan.

Begäran

# Skapa en tom arbetsbok med namnet newworkbook.xlsx
curl -X PUT "https://api.aspose.cloud/v3.0/cells/newworkbook.xlsx?isWriteOver=false" \
     -H "accept: application/json" \
     -H "Authorization: Bearer <access_token>" \
     --data-binary @empty.xlsx   # Uteslut denna rad för en helt tom arbetsbok

Svar

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

Använd Aspose.Cells Cloud SDK:er

Att använda en SDK är det bästa sättet att påskynda utvecklingen. En SDK abstraher bort detaljer på låg nivå så att du kan fokusera på dina projektuppgifter. Kontrollera GitHub-förrådet för en komplett lista över Aspose.Cells Cloud SDK:er.

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

C#

Java

PHP

Ruby

Node.js

Python

Perl

Go

Developer-Guide: Så här skapar du en Excel-arbetsbok med en mallfil

Mon, 01 Jan 0001 00:00:00 +0000

Så här skapar du en Excel-arbetsbok med en mallfil

Skapa en ny Excel-arbetsbok genom att använda en befintlig mallfil och valfritt en datafil som innehåller värden för Smart‑Marker. Åtgärden utförs via slutpunkten PUT /cells/{name} i Aspose.Cells Cloud.

Förutsättningar

Krav	Beskrivning
Aspose.Cells Cloud-konto	Registrera dig på https://dashboard.aspose.cloud/ och skaffa ett Client Id / Client Secret.
JWT-åtkomsttoken	Generera en JWT-token enligt beskrivningen i autentiseringsguide.
Mallfil	Ladda upp Excel-mallfilen (t.ex. `Calendar.xlsx`) till valfri lagring med API:t Upload File eller via användargränssnittet.
Datafil (valfritt)	En JSON- eller XML-fil som innehåller värden för Smart‑Marker (t.ex. `Sample_Data.xml`).
Stödd lagring	Standardlagring (`Default`) eller en anpassad lagring som konfigurerats i ditt Aspose-konto.

Autentisering

Alla förfrågningar till Aspose.Cells Cloud kräver en Bearer JWT-token som skickas i Authorization-headern:

Authorization: Bearer {access_token}

Token måste ha skapats på förhand och är standard giltig i en timme.

Förfrågan

HTTP-förfrågan

PUT https://api.aspose.cloud/v3.0/cells/{name}

Komponent	Värde
Metod	`PUT`
Sökväg	`/cells/{name}` – `name` är önskat namn på den nyskapade arbetsboken (inklusive filändelse, t.ex. `newworkbook.xlsx`).
Content‑Type	`multipart/form-data` (vid skickande av datafil i meddelandekroppen).
Accept	`application/json`

Sökvägsparameter

Namn	Typ	Obligatoriskt	Beskrivning
`name`	sträng	Ja	Namnet på den arbetsbok som ska skapas (t.ex. `newworkbook.xlsx`).

Frågeparametrar

Parameter	Typ	Obligatoriskt	Standard	Beskrivning
`templateFile`	sträng	Nej	—	Namnet på mallfilen som finns i molnet.
`dataFile`	sträng	Nej	—	Namnet på datafil (XML eller JSON) som finns i molnet.
`isWriteOver`	boolean	Nej	`false`	Skriv över målfilen om den redan finns. Skicka `true` eller `false` utan citationstecken.
`folder`	sträng	Nej	—	Mapp Sökväg där mallen (och valfri datafil) finns.
`storageName`	sträng	Nej	—	Namn på lagringstjänsten som innehåller filerna.
`checkExcelRestriction`	boolean	Nej	`true`	Validera arbetsboken mot Excel-begränsningar före skapande.

Meddelandekropp (valfritt)

När data för Smart‑Marker-platshållare skickas direkt i förfrågan inkluderas den som en multipart-fildel med namnet data.

Delnamn	Typ	Beskrivning
`data`	fil	XML- eller JSON-fil som innehåller värden för Smart‑Marker.

Exempel på cURL med meddelandekropp

curl -X PUT "https://api.aspose.cloud/v3.0/cells/newworkbook.xlsx?templateFile=Calendar.xlsx&isWriteOver=true" \
     -H "accept: application/json" \
     -H "Authorization: Bearer {access_token}" \
     -H "x-aspose-client: Containerize.Swagger" \
     -F "data=@Sample_Data.xml"

Om frågeparametern dataFile används istället för multipart-meddelandekroppen utelämnas flaggan -F.

Svar

Ett lyckat anrop returnerar 200 OK (eller 201 Created när en ny fil genereras) med en JSON-struktur som beskriver den skapade arbetsboken.

{
    "Code": 200,
    "Status": "OK",
    "File": {
        "Name": "newworkbook.xlsx",
        "Size": 18234,
        "Path": "output/newworkbook.xlsx",
        "Url": "https://api.aspose.cloud/v3.0/storage/file/output/newworkbook.xlsx"
    }
}

Datatyper för svar

Egenskap	Typ	Beskrivning
`Code`	heltal	HTTP-liknande statuskod returnerad av API:et.
`Status`	sträng	Textuell beskrivning av statusen.
`File`	objekt	Detaljerad information om den genererade arbetsboken.
`File.Name`	sträng	Filnamn för den skapade arbetsboken.
`File.Size`	heltal	Storlek i byte.
`File.Path`	sträng	Relativ sökväg i lagringen.
`File.Url`	sträng	Direkt nedladdnings-URL (kräver samma JWT-token).

HTTP-statuskoder

Kod	Betydelse	Beskrivning
200	OK	Filter tillämpades 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	Inte auktoriserad	Ogiltig eller saknad JWT-token.
413	Meddelandekroppen är för stor	Den uppladdade filen överskrider storleksgränsen.
500	Internt serverfel	Oväntat serverfel.

SDK-exempel

Följande kodfragment visar hur du anropar PutWorkbookCreate med de officiella Aspose.Cells Cloud SDK:erna.

using Aspose.Cells.Cloud.SDK.Api;
using Aspose.Cells.Cloud.SDK.Model;
using System.IO;

var apiInstance = new WorkbookApi();
var name = "newworkbook.xlsx"; // string | Det nya dokumentets namn.
var templateFile = "Calendar.xlsx"; // string | Mallfilens namn.
var dataFile = "Sample_Data.xml"; // string | Datafilens namn (valfritt).
var isWriteOver = true; // bool? | Skriv över om den redan finns.
var folder = "templates"; // string | Mapp där filerna finns.
var storageName = "MyStorage"; // string | Lagringsnamn.

using (var dataStream = File.OpenRead("Sample_Data.xml"))
{
    var response = apiInstance.PutWorkbookCreate(
        name,
        templateFile: templateFile,
        dataFile: dataFile,
        isWriteOver: isWriteOver,
        folder: folder,
        storageName: storageName,
        data: dataStream);
    Console.WriteLine(response);
}

Java

import com.aspose.cloud.cells.api.WorkbookApi;
import com.aspose.cloud.cells.model.*;

import java.io.File;
import java.io.FileInputStream;

WorkbookApi api = new WorkbookApi();
String name = "newworkbook.xlsx";
String templateFile = "Calendar.xlsx";
String dataFile = "Sample_Data.xml";
Boolean isWriteOver = true;
String folder = "templates";
String storageName = "MyStorage";

FileInputStream dataStream = new FileInputStream(new File("Sample_Data.xml"));
CellsCloudResponse response = api.putWorkbookCreate(
        name,
        templateFile,
        dataFile,
        isWriteOver,
        folder,
        storageName,
        dataStream);
System.out.println(response);

PHP

<?php
require_once('vendor/autoload.php');

use Aspose\Cells\Cloud\Api\WorkbookApi;
use Aspose\Cells\Cloud\Configuration;

$config = new Configuration();
$config->setAccessToken('{access_token}');
$config->setHost('https://api.aspose.cloud');

$apiInstance = new WorkbookApi(null, $config);
$name = "newworkbook.xlsx";
$templateFile = "Calendar.xlsx";
$dataFile = "Sample_Data.xml";
$isWriteOver = true;
$folder = "templates";
$storageName = "MyStorage";

$data = fopen("Sample_Data.xml", "r");
$result = $apiInstance->putWorkbookCreate($name, $templateFile, $dataFile, $isWriteOver, $folder, $storageName, $data);
print_r($result);
?>

Ruby

require 'aspose_cells_cloud'

api = AsposeCellsCloud::WorkbookApi.new
api.config.access_token = '{access_token}'

name = 'newworkbook.xlsx'
template_file = 'Calendar.xlsx'
data_file = 'Sample_Data.xml'
is_write_over = true
folder = 'templates'
storage_name = 'MyStorage'

File.open('Sample_Data.xml', 'rb') do |data|
  response = api.put_workbook_create(name,
                                     template_file: template_file,
                                     data_file: data_file,
                                     is_write_over: is_write_over,
                                     folder: folder,
                                     storage_name: storage_name,
                                     data: data)
  puts response
end

Node.js

const { WorkbookApi, Configuration } = require('asposecellscloud');
const fs = require('fs');

let config = new Configuration();
config.accessToken = '{access_token}';
config.basePath = 'https://api.aspose.cloud';

let apiInstance = new WorkbookApi(config);

let name = 'newworkbook.xlsx';
let templateFile = 'Calendar.xlsx';
let dataFile = 'Sample_Data.xml';
let isWriteOver = true;
let folder = 'templates';
let storageName = 'MyStorage';

let data = fs.createReadStream('Sample_Data.xml');

apiInstance.putWorkbookCreate(name, templateFile, dataFile, isWriteOver, folder, storageName, data)
    .then(response => console.log(response))
    .catch(err => console.error(err));

Python

import asposecellscloud
from asposecellscloud.apis import WorkbookApi
from asposecellscloud.models import CellsCloudResponse

config = asposecellscloud.Configuration()
config.access_token = '{access_token}'
config.host = 'https://api.aspose.cloud'

api_instance = WorkbookApi(asposecellscloud.ApiClient(config))

name = 'newworkbook.xlsx'
template_file = 'Calendar.xlsx'
data_file = 'Sample_Data.xml'
is_write_over = True
folder = 'templates'
storage_name = 'MyStorage'

with open('Sample_Data.xml', 'rb') as data:
    response = api_instance.put_workbook_create(
        name,
        template_file=template_file,
        data_file=data_file,
        is_write_over=is_write_over,
        folder=folder,
        storage_name=storage_name,
        data=data)
    print(response)

Perl

use AsposeCellsCloud::Api::WorkbookApi;
use AsposeCellsCloud::Configuration;

my $config = AsposeCellsCloud::Configuration->new();
$config->{access_token} = '{access_token}';
$config->{host} = 'https://api.aspose.cloud';

my $api_instance = AsposeCellsCloud::Api::WorkbookApi->new($config);

my $name = 'newworkbook.xlsx';
my $template_file = 'Calendar.xlsx';
my $data_file = 'Sample_Data.xml';
my $is_write_over = 1;
my $folder = 'templates';
my $storage_name = 'MyStorage';

open my $fh, '<:raw', 'Sample_Data.xml' or die $!;
my $response = $api_instance->put_workbook_create(
    name => $name,
    template_file => $template_file,
    data_file => $data_file,
    is_write_over => $is_write_over,
    folder => $folder,
    storage_name => $storage_name,
    data => $fh);
print $response;
close $fh;

package main

import (
    "fmt"
    "os"

    asposecellscloud "github.com/aspose-cells-cloud/aspose-cells-cloud-go/v3"
    "github.com/aspose-cells-cloud/aspose-cells-cloud-go/v3/api"
)

func main() {
    cfg := asposecellscloud.NewConfiguration()
    cfg.AccessToken = "{access_token}"
    cfg.Host = "https://api.aspose.cloud"

    apiInstance := api.NewWorkbookApi(cfg)

    name := "newworkbook.xlsx"
    templateFile := "Calendar.xlsx"
    dataFile := "Sample_Data.xml"
    isWriteOver := true
    folder := "templates"
    storageName := "MyStorage"

    data, _ := os.Open("Sample_Data.xml")
    defer data.Close()

    result, _, err := apiInstance.PutWorkbookCreate(name, &templateFile, &dataFile, &isWriteOver, &folder, &storageName, data)
    if err != nil {
        fmt.Println("Error:", err)
    } else {
        fmt.Printf("Response: %+v\n", result)
    }
}

Felhantering

Statuskod	Situation	Rekommenderad åtgärd
400	Obligatoriska parametrar saknas eller ogiltig filtyp.	Kontrollera frågeparametrar, se till att mall- och datafiler finns och är av stödda typer (`.xlsx`, `.xml`, `.json`).
401	JWT-token saknas, har gått ut eller är felaktig.	Generera en ny åtkomsttoken med ditt Client Id/Secret.
413	Den uppladdade filen överskrider gränsen för tjänstens storlek (standard 50 MB).	Minska filens storlek eller dela upp arbetsboken i mindre delar.
500	Oväntat serverfel.	Försök igen efter en kort fördröjning; om problemet kvarstår, kontakta Aspose-supporten med värdet från `Request‑Id`-headern.

Se även

PutWorkbookSave – Spara en befintlig arbetsbok i ett angivet format.
GetWorkbook – Hämta information om arbetsboken eller ladda ner filen.
Upload File API – Ladda upp mall- eller datafiler till molnlagring.

Developer-Guide: Sammanställning av data för skapande av en Excel-rapport

Mon, 01 Jan 0001 00:00:00 +0000

Detta REST API sammanställer data till en Excel-fil.

REST API

POST https://api.aspose.cloud/v3.0/cells/assembly

Säkerhet och autentisering

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

Begärans parametrar

Parameter namn	Typ	Plats	Beskrivning
file	fil	formData (multipart body)	Kalkylarkfilen som ska laddas upp.
DataSource	sträng	frågesträng	Identifierare för datakällan som tillhandahåller data för sammanställningen.
format	sträng	frågesträng	Önskat utdataformat (t.ex. `xlsx`, `pdf`).

Svar

{
    "Status" : "OK",
    "Code" : 200,
    "Filename" : "[fil2 namn]",
    "Filesize" : [filstorlek],
    "FileContent" : "[Base64-sträng]"
}

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	Inte auktoriserad	Ogiltig eller saknad JWT-token.
413	För stor nytolast	Den uppladdade filen överskrider storleksgränsen.
500	Internt serverfel	Oväntat serverfel.

Hur du använder PostAssemble API med SDK:er

PostAssemble API-specifikation

OpenAPI-specifikationen definierar ett offentligt tillgängligt programmeringsgränssnitt och låter dig utföra 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.

Begäran

curl -v "https://api.aspose.cloud/v3.0/cells/assembly?DataSource=ds&format=pdf" \
  -X POST \
  -H "Content-Type: multipart/form-data" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>" \
  -F 'template=@template.xlsx' \
  -F 'data=@data.json'

Svar

{
  "Files": [
    {
      "Filename": "report1",
      "FileSize": 274022,
      "FileContent": "-----Base64-sträng--------"
    },
    {
      "Filename": "report2",
      "FileSize": 274022,
      "FileContent": "-----Base64-sträng--------"
    }
  ]
}

Använd Aspose.Cells Cloud SDK:er

Att använda ett SDK är det snabbaste sättet att utveckla mot API:et. Ett SDK abstraher bort detaljer på lågnivånivå och låter dig fokusera på din affärslogik. Kolla in GitHub-förrådet 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:

Developer-Guide: Skapa Excel-rapporter med Smart Marker-mallar

Mon, 01 Jan 0001 00:00:00 +0000

Denna REST API skapar en arbetsbok med hjälp av en Smart Marker-mall.

Workbook SmartMarker API

POST https://api.aspose.cloud/v3.0/cells/{name}/smartmarker

Säkerhet och autentisering

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

Vad är en Smart Marker?

En Smart Marker är en platsmarkör-syntax som kopplar datafält i en XML- (eller JSON-) fil till celler i en Excel-mall. Vid körning ersätter Aspose.Cells markörerna med motsvarande data, vilket gör att du kan generera helt ifyllda rapporter programmerat.

Frågeparametrar

Parameternamn	Typ	Beskrivning
outPath	string	Målsökväg dit den genererade arbetsboken kommer att sparas.
folder	string	Mapp som innehåller den ursprungliga arbetsboken.
storageName	string	Namn på den lagringstjänst som ska användas.

Parametrar för begärandetext

Parameternamn	Typ	Beskrivning
xmlFile	fil	Smart Marker-XML-datafilen som laddats upp med begäran.

Svar

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

Anteckningar / Begränsningar:

API:et stöder Excel-filer upp till 50 MB i storlek.
Endast formatet .xlsx, .xlsm och .xlsb accepteras.
En hastighetsbegränsning på 20 begäranden per sekund per konto tillämpas.

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	Auktoriseringsfel	Ogiltig eller saknad JWT-token.
413	Payload för stor	Den uppladdade filen överskrider storleksgränsen.
500	Internt serverfel	Oväntat serverfel.

Hur man använder Workbook SmartMarker API

Workbook SmartMarker API-specifikation

OpenAPI-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

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 Cloud API med cURL.

Snabb rad-exempel

curl -X POST "https://api.aspose.cloud/v3.0/cells/{name}/smartmarker?outPath={outPath}" -H "Authorization: Bearer {access_token}" -F "xmlFile=@Sample_SmartMarker_Data.xml"

Begäran

curl -X POST "https://api.aspose.cloud/v3.0/cells/newworkbook_14.xlsx/smartmarker?outPath=GeneratedReport.xlsx" \
    -H "accept: multipart/form-data" \
    -H "x-aspose-client: Containerize.Swagger" \
    -F "xmlFile=@Sample_SmartMarker_Data.xml"

Svar

HTTP/1.1 200 OK
Content-Type: application/json

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

Felhantering

HTTP-status	Beskrivning	Vanlig orsak
400	Felaktig begäran	Saknad mall, felaktig XML eller ogiltiga parametrar.
401	Auktoriseringsfel	Ogiltig eller saknad autentiseringstoken.
404	Hittades inte	Angiven arbetsbok eller lagringsplats finns inte.
500	Internt serverfel	Oväntat serverfel.

Exempel på felaktigt svar (400)

{
  "Code": 400,
  "Message": "XML-datafilen saknas eller är felaktig."
}

Cloud SDK-familj

Att använda ett SDK är det bästa sättet att påskynda utvecklingen. Ett SDK hanterar detaljer på låg nivå så att du kan fokusera på dina projektuppgifter. Kolla in GitHub-lagret 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:

Documentation –

Developer-Guide: Skapa en tom Excel-arbetsbok

PutWorkbookCreate API

Säkerhet och autentisering

Frågeparametrar

Begäranhållningsparameter

Svar

Hur du använder PutWorkbookCreate API med SDK:er

PutWorkbookCreate API-specificering

Använd Aspose.Cells Cloud SDK:er

C# Java PHP Ruby Node.js Python Perl Go

Developer-Guide: Så här skapar du en Excel-arbetsbok med en mallfil

Så här skapar du en Excel-arbetsbok med en mallfil

Förutsättningar

Autentisering

Förfrågan

HTTP-förfrågan

Sökvägsparameter

Frågeparametrar

Meddelandekropp (valfritt)

Exempel på cURL med meddelandekropp

Svar

Datatyper för svar

SDK-exempel

Felhantering

Se även

Developer-Guide: Sammanställning av data för skapande av en Excel-rapport

REST API

Säkerhet och autentisering

Begärans parametrar

Svar

Hur du använder PostAssemble API med SDK:er

PostAssemble API-specifikation

Använd Aspose.Cells Cloud SDK:er

Developer-Guide: Skapa Excel-rapporter med Smart Marker-mallar

Workbook SmartMarker API

Säkerhet och autentisering

Vad är en Smart Marker?

Frågeparametrar

Parametrar för begärandetext

Svar

Hur man använder Workbook SmartMarker API

Workbook SmartMarker API-specifikation

Använd Aspose.Cells Cloud SDK:er

Felhantering

Cloud SDK-familj

C#

Java

PHP

Ruby

Node.js

Python

Perl

Go