Aggiungi una colonna vuota a un foglio di calcolo Excel tramite l'API Aspose.Cells Cloud

Questa API REST inserisce una o più colonne in un foglio di calcolo.

Prerequisiti
Prima di chiamare questo endpoint, assicurati di aver completato i seguenti passaggi:

  • Ottenere un token di accesso OAuth 2.0 valido e includerlo nell’intestazione Authorization.
  • Archiviare il workbook di destinazione nell’archivio selezionato (quello predefinito = “Default”) oppure specificare i parametri folder e storageName appropriati.
  • Verificare che il nome del foglio di calcolo fornito in sheetName esista nel workbook.

API PutInsertWorksheetColumns

PUT https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/cells/columns/{columnIndex}?totalColumns=1

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
name string path Nome del file workbook.
sheetName string path Nome del foglio di calcolo.
columnIndex integer path Indice in base zero della colonna da cui inizia l’inserimento.
totalColumns integer query Numero di colonne da inserire.
updateReference boolean query Se true, i riferimenti alle celle vengono aggiornati per riflettere l’inserimento.
folder string query Percorso della cartella contenente il workbook.
storageName string query Nome del servizio di archiviazione.

Note

  • Il valore columnIndex deve essere compreso tra 0 e il numero attuale di colonne nel foglio di calcolo. L’inserimento oltre l’intervallo esistente espanderà automaticamente il foglio.
  • L’inserimento di più colonne (totalColumns > 1) sposta le colonne esistenti verso destra.
  • L’opzione updateReference è impostata su false per impostazione predefinita; impostarla su true per aggiornare formule e intervalli denominati.

La specifiche OpenAPI 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 chiamare i servizi web Aspose.Cells. L’esempio seguente mostra una richiesta completa, inclusa l’autenticazione e il corretto parametro di percorso.

Codici di risposta

Codice Descrizione
200 Colonna/e inserita/e correttamente.
400 Richiesta non valida – parametri mancanti o non validi.
401 Non autorizzato – token non valido o mancante.
404 Workbook o foglio di calcolo non trovato.
500 Errore interno del server.

Esempi di risposte di errore

// 400 Bad Request – parametri mancanti o non validi
{
  "Code": 400,
  "Message": "Parametro non valido: totalColumns deve essere un intero positivo."
}

// 401 Unauthorized – token non valido o mancante
{
  "Code": 401,
  "Message": "Autenticazione non riuscita. Il token di accesso è mancante o non valido."
}

// 404 Not Found – workbook o foglio di calcolo non esistente
{
  "Code": 404,
  "Message": "Workbook 'test.xlsx' non trovato."
}

// 500 Internal Server Error
{
  "Code": 500,
  "Message": "Si è verificato un errore imprevisto sul server."
}

Famiglia di SDK Cloud

L’utilizzo di un SDK è il modo più rapido per sviluppare. Un SDK gestisce i dettagli a basso livello, consentendoti di concentrarti sulla logica del tuo progetto. Consulta il repository GitHub per un elenco completo degli SDK Aspose.Cells Cloud.

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

Copia di colonne in un foglio di lavoro Excel