Aspose.Cells Cloud API – Unisci intervallo celle

Questa API REST consente di unire un intervallo di celle in una singola cella su un foglio di calcolo Excel.

Panoramica – L’unione di un intervallo combina le celle selezionate in una singola cella, preservando il valore della cella in alto a sinistra e scartando il resto. Utilizza questa operazione quando hai bisogno di creare un’intestazione che si estende su più colonne o righe, o quando desideri semplificare il layout di un foglio di calcolo.

API REST

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

Parametri della richiesta

Nome parametro	Tipo	Posizione	Descrizione
name	string	path	Nome del file del foglio di calcolo (workbook).
sheetName	string	path	Nome del foglio di calcolo (worksheet).
range	object	body	Oggetto Range che specifica le celle da unire.
folder	string	query	Cartella in cui è salvato il foglio di calcolo.
storageName	string	query	Nome dello storage.

Schema del corpo della richiesta

L’oggetto Range deve contenere i seguenti campi (tutti gli altri sono facoltativi):

Proprietà	Tipo	Obbligatorio	Descrizione
FirstRow	integer	Sì	Indice in base zero della prima riga nell’intervallo.
FirstColumn	integer	Sì	Indice in base zero della prima colonna nell’intervallo.
RowCount	integer	Sì	Numero di righe da includere nell’intervallo.
ColumnCount	integer	Sì	Numero di colonne da includere nell’intervallo.
Name	string	No	Nome facoltativo per l’intervallo.
RefersTo	string	No	Una formula a cui fa riferimento l’intervallo.
Worksheet	string	No	Nome del foglio di calcolo (se diverso dal parametro path).
RowHeight	number	No	Altezza delle righe nell’intervallo (in pixel).
ColumnWidth	number	No	Larghezza delle colonne nell’intervallo (in pixel).

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

Richiesta

curl -v "https://api.aspose.cloud/v3.0/cells/test.xlsx/worksheets/Sheet1/ranges/merge" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>" \
  -d '{
        "FirstRow": 9,
        "FirstColumn": 0,
        "RowCount": 1,
        "ColumnCount": 7
      }'

Risposta

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

Dettagli della risposta

Stato HTTP	Descrizione	JSON di esempio
200 OK	L’intervallo è stato unito correttamente.	`{ "Code": 200, "Status": "OK" }`
400 Bad Request	Parametri dell’intervallo non validi (es. indici fuori limite).	`{ "Code": 400, "Message": "Intervallo non valido." }`
401 Unauthorized	Token JWT mancante o non valido.	`{ "Code": 401, "Message": "Autenticazione non riuscita." }`
404 Not Found	Foglio di calcolo o foglio non trovato.	`{ "Code": 404, "Message": "Risorsa non trovata." }`
500 Internal Server Error	Errore imprevisto del server.	`{ "Code": 500, "Message": "Errore interno del server." }`

Famiglia di SDK Cloud

Utilizzare un SDK rappresenta il modo migliore 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: