Documentation de l’API Aspose.Cells Cloud d’extraction de texte

Extrait des sous-chaînes, des caractères ou des nombres d’une cellule de feuille de calcul vers une autre cellule, éliminant ainsi la nécessité d’utiliser des formules complexes telles que FIND, MIN, LEFT ou RIGHT.

API ExtractText

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

Sécurité et authentification

Les API Aspose.Cells Cloud sont sécurisées et nécessitent une authentification basée sur un jeton JWT.

-H "Authorization: Bearer {access_token}"

Paramètres de la requête de l’API extractText

Nom du paramètre Type Emplacement Description
Spreadsheet File FormData Télécharger le fichier de feuille de calcul.
extractTextType String Query Énumération indiquant le mode d’extraction. Valeurs autorisées : Before, After, BeforePosition, AfterPosition.
beforeText String Query Texte qui doit apparaître avant la sous-chaîne extraite. Utilisé lorsque extractTextType=Before.
afterText String Query Texte qui doit apparaître après la sous-chaîne extraite. Utilisé lorsque extractTextType=After.
beforePosition Integer Query Nombre de caractères à renvoyer depuis le côté gauche de la cellule. Utilisé lorsque extractTextType=BeforePosition.
afterPosition Integer Query Nombre de caractères à renvoyer depuis le côté droit de la cellule. Utilisé lorsque extractTextType=AfterPosition.
outPositionRange String Query La plage cible (par exemple, Sheet1!A1) dans laquelle le texte extrait sera écrit.
worksheet String Query Nom de la feuille de calcul contenant la cellule source.
range String Query La cellule ou la plage source (par exemple, A1).
outPath String Query (Facultatif) Chemin du dossier dans le stockage où le classeur résultant sera enregistré. Si omis, le résultat est retourné dans le corps de la réponse.
outStorageName String Query Nom du stockage à utiliser pour le fichier de sortie.
region String Query Paramètre de région de la feuille de calcul (par exemple, US, EU).
password String Query Mot de passe pour ouvrir un classeur protégé.

Exemple de requête 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"

Réponse

Lorsque la requête réussit, l’API renvoie une charge utile JSON contenant le texte extrait et l’adresse de la cellule dans laquelle il a été écrit :

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

Si le paramètre outPath est fourni, la réponse contient uniquement un message de statut ; le classeur est écrit à l’emplacement spécifié.

Exemple de réponse lorsque outPath est omis

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

Codes d’erreur

  • 200 OK – Extraction terminée avec succès.
  • 202 Accepted – Requête acceptée pour traitement asynchrone.
  • 400 Bad Request – URI d’API Aspose.Cells Cloud invalide ou paramètres requis manquants.
  • 401 Unauthorized – Jeton d’accès, ID client ou secret client invalide.
  • 404 Not Found – Le fichier de feuille de calcul spécifié ne peut pas être accessible.
  • 500 Server Error – Une erreur inattendue s’est produite lors du traitement du classeur.

Spécification OpenAPI

La Spécification OpenAPI définit une interface de programmation publiquement accessible et permet d’effectuer des interactions REST directement depuis un navigateur web.

Utiliser les SDK Aspose.Cells Cloud

L’utilisation d’un SDK constitue la meilleure façon d’accélérer le développement. Le SDK gère les détails sous-jacents, vous permettant ainsi de simplement implémenter l’extraction de texte pour les cellules avec un minimum de code. Veuillez consulter le dépôt GitHub pour obtenir la liste complète des SDK Aspose.Cells Cloud.

Les exemples de code suivants illustrent comment effectuer des appels aux services web Aspose.Cells à l’aide de divers SDK :