Documentazione API Aspose.Cells Cloud per l'estrazione del testo

Estrae sottostringhe, caratteri o numeri da una cella di un foglio di calcolo in un’altra cella, eliminando la necessità di formule complesse come FIND, MIN, LEFT o RIGHT.

API ExtractText

PUT https://api.aspose.cloud/v4.0/cells/content/extract/text

Sicurezza e autenticazione

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

-H "Authorization: Bearer {access_token}"

I parametri della richiesta dell’API extractText sono:

Nome parametro Tipo Posizione Descrizione
Spreadsheet File FormData Carica il file del foglio di calcolo.
extractTextType String Query Enum che indica la modalità di estrazione. Valori ammessi: Before, After, BeforePosition, AfterPosition.
beforeText String Query Testo che deve comparire prima della sottostringa estratta. Utilizzato quando extractTextType=Before.
afterText String Query Testo che deve comparire dopo la sottostringa estratta. Utilizzato quando extractTextType=After.
beforePosition Integer Query Numero di caratteri da restituire dal lato sinistro della cella. Utilizzato quando extractTextType=BeforePosition.
afterPosition Integer Query Numero di caratteri da restituire dal lato destro della cella. Utilizzato quando extractTextType=AfterPosition.
outPositionRange String Query L’intervallo di destinazione (ad es. Sheet1!A1) in cui verrà scritto il testo estratto.
worksheet String Query Nome del foglio di calcolo contenente la cella di origine.
range String Query La cella o l’intervallo di origine (ad es. A1).
outPath String Query (Opzionale) Percorso della cartella nella memoria in cui verrà salvato il foglio di calcolo risultante. Se omesso, il risultato viene restituito nel corpo della risposta.
outStorageName String Query Nome della memoria da utilizzare per il file di output.
region String Query Impostazione della regione del foglio di calcolo (ad es. US, EU).
password String Query Password per aprire un foglio di calcolo protetto.

Esempio di richiesta cURL

curl -X PUT "https://api.aspose.cloud/v4.0/cells/content/extract/text?extractTextType=Before&beforeText=Total&outPositionRange=Sheet1!B1&worksheet=Sheet1&range=A1" \
     -H "Authorization: Bearer {access_token}" \
     -F "Spreadsheet=@Sample.xlsx"

Risposta

Quando la richiesta ha successo, l’API restituisce un payload JSON contenente il testo estratto e l’indirizzo della cella in cui è stato scritto:

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

Se il parametro outPath è fornito, la risposta contiene solo un messaggio di stato; il foglio di calcolo viene scritto nella posizione specificata.

Esempio di risposta quando outPath è omesso

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

Codici di errore

  • 200 OK – Estrazione completata con successo.
  • 202 Accepted – Richiesta accettata per l’elaborazione asincrona.
  • 400 Bad Request – URI API Aspose.Cells Cloud non valido o parametri obbligatori mancanti.
  • 401 Unauthorized – Token di accesso, client ID o client secret non validi.
  • 404 Not Found – Impossibile accedere al file del foglio di calcolo specificato.
  • 500 Server Error – Si è verificato un errore imprevisto durante l’elaborazione del foglio di calcolo.

Specifica OpenAPI

La Specifiche OpenAPI definiscono un’interfaccia di programmazione accessibile pubblicamente e consentono di effettuare interazioni REST direttamente da un browser web.

Utilizzare gli SDK di Aspose.Cells Cloud

L’utilizzo dell’SDK è il modo migliore per accelerare lo sviluppo. L’SDK gestisce i dettagli sottostanti, consentendo di implementare semplicemente l’Estrazione testo per le celle con un codice minimo. Consulta il repository GitHub per un elenco completo degli SDK di Aspose.Cells Cloud.

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