Copia di un intervallo in un foglio di calcolo con opzioni di incolla – Aspose.Cells Cloud API

Questa API REST consente di copiare un intervallo in un foglio di calcolo di un file Excel. Per operazioni correlate, consulta la documentazione Ottieni intervallo e Aggiorna intervallo.

Prerequisiti: Per utilizzare questo endpoint è necessario disporre di un token OAuth 2.0 / JWT valido e assicurarsi che la versione dell’API corrisponda all’URL della richiesta.

API REST

POST https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/ranges

Parametri della richiesta

Nome del parametro	Tipo	Posizione	Descrizione
name	string	path	Il nome del file Excel (workbook).
sheetName	string	path	Il nome del foglio di calcolo (worksheet).
rangeOperate	string	body	L’operazione da eseguire: `copydata`, `copystyle`, `copyto` o `copyvalue`.
folder	string	query	La cartella contenente il file Excel.
storageName	string	query	Il nome del servizio di archiviazione.

Note: Il campo rangeOperate determina cosa viene copiato. Utilizzare copydata per copiare solo i valori delle celle, copystyle per lo stile/formattazione, copyto per sia dati che stile, e copyvalue per copiare i valori senza formule. L’API supporta intervalli fino a 1 milione di celle; intervalli più ampi potrebbero causare un timeout.

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

È possibile 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 con cURL.

Richiesta

curl -v "https://api.aspose.cloud/v3.0/cells/Book1.xlsx/worksheets/Sheet1/ranges" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>" \
  -d '{
        "Operate": "string",
        "Source": {
          "ColumnCount": 0,
          "ColumnWidth": 0,
          "FirstColumn": 0,
          "FirstRow": 0,
          "Name": "string",
          "RefersTo": "string",
          "RowCount": 0,
          "RowHeight": 0,
          "Worksheet": "string"
        },
        "Target": {
          "ColumnCount": 0,
          "ColumnWidth": 0,
          "FirstColumn": 0,
          "FirstRow": 0,
          "Name": "string",
          "RefersTo": "string",
          "RowCount": 0,
          "RowHeight": 0,
          "Worksheet": "string"
        },
        "PasteOptions": {
          "OnlyVisibleCells": true,
          "PasteType": "string",
          "SkipBlanks": true,
          "Transpose": true
        }
      }'

Risposta

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

Una risposta corretta restituisce lo stato 200 OK. In caso di errore, l’API potrebbe restituire payload come:

{
  "Code": 400,
  "Message": "Bad Request – parametri non validi."
}

oppure

{
  "Code": 401,
  "Message": "Unauthorized – token di autenticazione mancante o non valido."
}

Questi oggetti di errore includono un codice di stato HTTP e un messaggio descrittivo per aiutare a diagnosticare i problemi.

Puoi scaricare un file Excel di esempio per testare l’operazione di copia qui.

Famiglia di SDK Cloud

L’utilizzo di un SDK rappresenta il modo più rapido per accelerare 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: