Come aggiungere fogli di lavoro a Excel – Inserire nuovi fogli in posizioni specifiche
Aggiungi programmaticamente fogli di lavoro ai file Excel con pieno controllo sul tipo e sulla posizione del foglio. Inserisci fogli di lavoro standard, fogli grafici o fogli macro in qualsiasi posizione all’interno del libro. Questa operazione RESTful consente la gestione e l’organizzazione automatizzate dei libri Excel.
Prerequisiti
- Un account Aspose.Cells Cloud attivo con un token di accesso JWT valido.
- Un nome di archiviazione cloud configurato (ad esempio
CompanyOneDrive) in cui verrà salvato il libro. - Il libro di destinazione deve essere accessibile nell’archiviazione specificata e, se protetto, deve essere fornita la password corretta.
| Tipo di foglio | Descrizione |
|---|---|
| VB | Modulo Visual Basic |
| Worksheet | Foglio di lavoro normale |
| Chart | Foglio grafico |
| BIFF4Macro | Foglio macro BIFF4 |
| InternationalMacro | Foglio macro internazionale |
| Other | Tipo di foglio personalizzato o meno comune non elencato sopra |
| Dialog | Foglio di dialogo |
Add Worksheet to Spreadsheet API
Web API
PUT https://api.aspose.cloud/v4.0/cells/spreadsheet/add/worksheet
Sicurezza e autenticazione
Le API Aspose.Cells Cloud sono sicure e richiedono l'autenticazione basata su token JWT.
Parametri della richiesta
| Nome parametro | Tipo | Posizione | Descrizione |
|---|---|---|---|
| Spreadsheet | File | FormData | Obbligatorio. Il libro Excel (.xlsx, .xls, ecc.) a cui verrà aggiunto un nuovo foglio di lavoro. |
| sheetType | String | Query | Opzionale. Il tipo di foglio da creare. I valori accettabili sono worksheet (valore predefinito), chartsheet, macrosheet, vbmodule e dialog. |
| position | Integer | Query | Opzionale. Indice in base zero in corrispondenza del quale inserire il nuovo foglio. 0 inserisce prima del primo foglio; 2 inserisce come terzo foglio. Tralasciare per aggiungere il foglio alla fine. |
| sheetName | String | Query | Opzionale. Nome del nuovo foglio di lavoro. Deve essere univoco all’interno del libro. Se omesso, viene generato un nome predefinito come “SheetX”. |
| outPath | String | Query | Opzionale. Directory di destinazione nell’archiviazione cloud in cui verrà salvato il libro modificato. Se null o omesso, il libro viene salvato nella stessa posizione del file di origine o in un percorso predefinito. |
| outStorageName | String | Query | Obbligatorio. Identificatore dell’archiviazione cloud configurata (ad esempio CompanyOneDrive) in cui deve essere scritto il file di output. |
| region | String | Query | Opzionale. Impostazione locale (ad esempio it-IT) che può influenzare la formattazione e le regole regionali nel nuovo foglio di lavoro. |
| password | String | Query | Opzionale. Password per decrittografare e modificare un libro protetto da password. Omettere se il file non è crittografato. |
Risposta
In caso di esito positivo, l’API restituisce HTTP 200 OK (o 201 Created quando viene generato un nuovo file) insieme al libro aggiornato.
{
"Name": "ResponseFile",
"DataType": {
"Identifier": "File",
"Reference": "Stream"
}
}
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 (ad esempio, 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. |
Dove dovremmo utilizzare l’API Add Worksheet to Spreadsheet?
- Generazione automatizzata di report – Creare e inserire dinamicamente fogli mensili (ad esempio
2024-05) durante la generazione di prospetti finanziari. - Inizializzazione batch di modelli – Aggiungere un foglio di analisi dedicato per ogni nuovo cliente o progetto durante la generazione in blocco di preventivi o proposte commerciali.
- Espansione dinamica di dashboard – Inserire nuovi fogli grafici in tempo reale man mano che diventano disponibili nuove dimensioni dei dati.
- Conformità e archiviazione per audit – Aggiungere automaticamente fogli di raccolta prove durante gli audit annuali, mantenendo isolati ciascun punto di ispezione.
- Per rimuovere un foglio, vedere l’operazione Elimina foglio di lavoro.
- Per spostare un foglio, vedere l’operazione Sposta foglio di lavoro.
Perché dovresti utilizzare l’API Add Worksheet to Spreadsheet?
- Facile da usare per sviluppatori – Aspose.Cells Cloud fornisce SDK per diversi linguaggi, riducendo lo sforzo di sviluppo e offrendo una documentazione approfondita.
- Riduzione dei costi di manodopera – Elimina la necessità di creare manualmente fogli di lavoro e svolgere compiti ripetitivi di copia-incolla.
- Pay-per-use – Si paga solo per le chiamate API effettivamente effettuate.
- Nessuna manutenzione – Nessun server da gestire, nessun aggiornamento software e nessun problema di compatibilità.
Come utilizzare l’API Add Worksheet to Spreadsheet con gli SDK
Specifica dell’API Add Worksheet to Spreadsheet
La Specifiche dell’API Add Worksheet to Spreadsheet definisce un’interfaccia di programmazione accessibile pubblicamente e consente di effettuare interazioni REST direttamente da un browser web.
Puoi utilizzare lo strumento a riga di comando cURL per accedere facilmente ai servizi web Aspose.Cells. L’esempio seguente mostra come effettuare chiamate all’API Cloud con cURL.
Utilizzare gli SDK Aspose.Cells Cloud
L’utilizzo di un SDK astrae i dettagli di basso livello, consentendo di aggiungere un foglio di lavoro con un codice minimo. Consulta l’elenco completo degli SDK nel repository GitHub.
Gli esempi di codice seguenti mostrano come chiamare il servizio con vari SDK: