Genera report Excel con template Smart Marker – Guida all’API Aspose.Cells Cloud

Questa API REST crea una cartella di lavoro utilizzando un template Smart Marker.

API SmartMarker per cartella di lavoro

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

Sicurezza e autenticazione

Le API di Aspose.Cells Cloud sono sicure e richiedono l’autenticazione tramite token JWT.

Cos’è uno Smart Marker?

Uno Smart Marker è una sintassi segnaposto che associa i campi di dati in un file XML (o JSON) alle celle di un modello Excel. In fase di esecuzione, Aspose.Cells sostituisce i marker con i dati corrispondenti, consentendo di generare programmaticamente report completamente popolati.

Parametri della query

Nome parametro	Tipo	Descrizione
outPath	string	Percorso di destinazione in cui verrà salvata la cartella di lavoro generata.
folder	string	Cartella contenente la cartella di lavoro originale.
storageName	string	Nome del servizio di archiviazione da utilizzare.

Parametro del corpo della richiesta

Nome parametro	Tipo	Descrizione
xmlFile	file	File XML dei dati Smart Marker caricato con la richiesta.

Risposta

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

Note / Limitazioni:

L’API supporta file Excel di dimensioni massime di 50 MB.
I formati accettati sono solo .xlsx, .xlsm e .xlsb.
È applicato un limite di frequenza di 20 richieste al secondo per account.

Codici di stato HTTP

Codice	Significato	Descrizione
200	OK	Filtro applicato correttamente; la risposta contiene i dettagli dell’operazione.
400	Richiesta non valida	Parametri mancanti o non validi (es. tipo di file non supportato).
401	Non autorizzato	Token JWT non valido o mancante.
413	Payload troppo grande	Il file caricato supera il limite di dimensione.
500	Errore interno del server	Errore imprevisto del server.

Come utilizzare l’API SmartMarker per cartella di lavoro

Specifica dell’API SmartMarker per cartella di lavoro

La Specifica OpenAPI definisce un’interfaccia di programmazione pubblicamente accessibile e consente di effettuare direttamente interazioni REST da un browser web.

Utilizzare gli SDK di Aspose.Cells Cloud

Puoi utilizzare lo strumento a riga di comando cURL per accedere facilmente ai servizi web di Aspose.Cells. L’esempio seguente mostra come effettuare chiamate all’API Cloud tramite cURL.

Esempio rapido in una singola riga

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"

Richiesta

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"

Risposta

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

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

Gestione degli errori

Codice HTTP	Descrizione	Causa tipica
400	Richiesta non valida	File modello mancante, XML non corretto o parametri non validi.
401	Non autorizzato	Token di autenticazione non valido o mancante.
404	Non trovato	La cartella di lavoro o la posizione di archiviazione specificata non esiste.
500	Errore interno del server	Guasto imprevisto lato server.

Esempio di risposta di errore (400)

{
  "Code": 400,
  "Message": "Il file XML dei dati è mancante o non corretto."
}

Famiglia di SDK Cloud

Utilizzare un SDK rappresenta il modo più efficiente per velocizzare lo sviluppo. Un SDK gestisce i dettagli di basso livello, consentendoti di concentrarti sulle attività del tuo progetto. Consulta il repository GitHub per un elenco completo degli SDK di Aspose.Cells Cloud.

I seguenti esempi di codice mostrano come chiamare i servizi web di Aspose.Cells utilizzando vari SDK: