Scambia/Interscambia dati tra colonne, righe e celle in Excel

Scambia automaticamente dati tra due qualsiasi colonne, righe, intervalli o celle nei file Excel utilizzando l’API Aspose.Cells Cloud. L’API Scambia intervallo consente di scambiare dati con precisione, preservando tutta la formattazione, le formule e i riferimenti alle celle. Supporta la riorganizzazione complessa dei dati, l’elaborazione in batch e l’integrazione fluida con il cloud per flussi di lavoro aziendali.

API Scambia intervallo

Web API

PUT https://api.aspose.cloud/v4.0/cells/swap/range

Sicurezza e autenticazione

Le API Aspose.Cells Cloud sono sicure e richiedono l'autenticazione basata su token JWT.

-H "Authorization: Bearer {access_token}"

Parametri della richiesta

Nome parametro Tipo Posizione Descrizione
Spreadsheet File FormData Obbligatorio. File del foglio di calcolo Excel di origine (.xlsx, .xls).
worksheet1 String Query Obbligatorio. Nome del foglio di calcolo contenente la prima area di dati.
range1 String Query Obbligatorio. Intervallo di celle (ad esempio, A1:D10) in worksheet1 da scambiare.
worksheet2 String Query Obbligatorio. Nome del foglio di calcolo contenente la seconda area di dati (può essere lo stesso di worksheet1).
range2 String Query Obbligatorio. Intervallo di celle (ad esempio, F1:I10) in worksheet2 da scambiare. Importante: range1 e range2 devono avere dimensioni identiche.
outPath String Query Facoltativo. Cartella nello storage cloud in cui verrà salvato il foglio di calcolo modificato.
outStorageName String Query Obbligatorio. Nome del servizio di storage cloud configurato (ad esempio, MyCompanyStorage).
region String Query Facoltativo. Impostazione delle impostazioni locali (ad esempio, en-US, ja-JP) che potrebbero influenzare la formattazione.
password String Query Facoltativo. Password per decrittografare un foglio di calcolo protetto. Omettere se non crittografato.

Esempio di richiesta (cURL)

curl -X PUT "https://api.aspose.cloud/v4.0/cells/swap/range?worksheet1=Sheet1&range1=A1:D10&worksheet2=Sheet2&range2=F1:I10&outStorageName=MyCompanyStorage" \
     -H "Authorization: Bearer {access_token}" \
     -F "Spreadsheet=@/path/to/workbook.xlsx"

Risposta

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

Note:

  • L’API restituisce il foglio di calcolo modificato come flusso di file. Se outPath è specificato, il file viene salvato anche nella posizione specificata nello storage cloud.
  • Intervalli con dimensioni non corrispondenti genereranno un errore 400 Bad Request.

Codici di errore

Codice Descrizione
400 Bad Request URI della richiesta non valido o dimensioni degli intervalli non corrispondenti.
401 Unauthorized Token di accesso non valido o scaduto; client-id o secret errati.
404 Not Found Il file del foglio di calcolo specificato non può essere accessibile.
500 Server Error Si è verificato un errore interno durante l’elaborazione del foglio di calcolo.

Dove dovremmo utilizzare l’API Scambia intervallo?

  • Ristrutturazione di modelli finanziari – Riorganizza blocchi di dati (ad esempio, sposta la previsione del Q3 nel Q4) preservando formule e formattazione condizionale.
  • Pipeline dei dati e processi ETL – Scambia intervalli di dati grezzi con intervalli puliti in un foglio di lavoro di staging prima della generazione finale.
  • Correzione errori e recupero dati – Correggi rapidamente dati spostati in modo errato senza copiare e incollare manualmente.

Perché utilizzare l’API Scambia intervallo?

  • Facile da usare per sviluppatori – Sono disponibili SDK per diversi linguaggi, riducendo lo sforzo di sviluppo rispetto alla creazione di soluzioni personalizzate.
  • Riduce i costi di manodopera – Automatizza il ridisposizionamento dei dati, riducendo la necessità di consolidamenti manuali.
  • Pagamento solo per l’uso – 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 Scambia intervallo con gli SDK

Specifica dell’API Scambia intervallo

La Specifiche dell’API Scambia intervallo definisce un’interfaccia di programmazione pubblicamente accessibile e consente di effettuare interazioni REST direttamente da un browser web.

Utilizzare gli SDK di Aspose.Cells Cloud

L’utilizzo di un SDK è il modo più rapido per sviluppare, poiché nasconde i dettagli di basso livello, consentendo di scambiare intervalli con codice conciso. Consulta il repository GitHub per un elenco completo degli SDK di Aspose.Cells Cloud.

Gli esempi di codice seguenti mostrano come effettuare chiamate ai servizi web Aspose.Cells utilizzando vari SDK:

UnpivotRange Rimuovi Duplicati