Obtenir les règles de mise en forme conditionnelle

Cet API REST récupère les règles de mise en forme conditionnelle appliquées à une feuille de calcul.

Sécurité et authentification

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

API REST

GET https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/conditionalFormattings

Paramètres de la requête

Nom du paramètre	Type	Emplacement	Description
name	string	path	Le nom du fichier Excel.
sheetName	string	path	Le nom de la feuille de calcul.
folder	string	query	Le chemin du dossier dans lequel le fichier est stocké.
storageName	string	query	Le nom du service de stockage (facultatif).

Réponses d’erreur

Code HTTP	Raison	Corps d’exemple
400	Requête incorrecte – paramètres manquants ou non valides.	`{ "Code":"400", "Message":"Valeur de paramètre non valide." }`
401	Non autorisé – jeton JWT manquant ou non valide.	`{ "Code":"401", "Message":"Le jeton d’accès est manquant ou non valide." }`
404	Non trouvé – classeur ou feuille de calcul inexistante.	`{ "Code":"404", "Message":"Fichier introuvable." }`
500	Erreur interne du serveur – défaillance inattendue du serveur.	`{ "Code":"500", "Message":"Une erreur inattendue s’est produite." }`

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

Vous pouvez utiliser l’outil en ligne de commande cURL pour accéder facilement aux services web Aspose.Cells. L’exemple suivant montre comment effectuer un appel à l’API Cloud avec cURL.

Requête

curl -v "https://api.aspose.cloud/v3.0/cells/Book1.xlsx/worksheets/sheet1/conditionalFormattings" \
  -X GET \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <access_token>"

Réponse

{
  "Status": "OK",
  "ConditionalFormattings": {
    "Count": 1,
    "ConditionalFormattingList": [
      {
        "sqref": "A1:B10",
        "FormatConditions": [
          {
            "Priority": 1,
            "Type": "CellValue",
            "Operator": "GreaterThan",
            "Formula1": "100",
            "Style": {
              "Font": {
                "Color": { "A": 255, "R": 255, "G": 0, "B": 0 },
                "IsBold": true
              }
            }
          }
        ]
      }
    ]
  }
}

L’exemple ci-dessus ne présente que les champs les plus pertinents afin de garder la charge utile concise.

Paramètres de la réponse

Paramètre	Type	Description
Status	string	État du résultat de la requête (par exemple, OK).
ConditionalFormattings	object	Conteneur des données de mise en forme conditionnelle.
ConditionalFormattings.Count	integer	Nombre de règles de mise en forme conditionnelle renvoyées.
ConditionalFormattings.ConditionalFormattingList	array	Liste des objets de mise en forme conditionnelle.
ConditionalFormattingList[].sqref	string	Plage de cellules à laquelle la mise en forme s’applique (par exemple, A1:B10).
ConditionalFormattingList[].FormatConditions	array	Collection d’objets de condition de mise en forme pour la plage.
FormatConditions[].Priority	integer	Priorité d’évaluation de la condition.
FormatConditions[].Type	string	Type de condition (par exemple, CellValue).
FormatConditions[].Operator	string	Opérateur utilisé pour la condition (par exemple, GreaterThan).
FormatConditions[].Formula1	string	Première formule ou valeur de la condition.
FormatConditions[].Style	object	Style appliqué lorsque la condition est remplie.
Style.Font.Color	object	Définition de la couleur RGBA pour la police.
Style.Font.IsBold	boolean	Indique si la police est en gras.

Codes d’état HTTP

Code	Signification	Description
200	OK	Filtre appliqué avec succès ; la réponse contient les détails de l’opération.
400	Requête incorrecte	Paramètres manquants ou non valides (par exemple, type de fichier non pris en charge).
401	Non autorisé	Jeton JWT non valide ou manquant.
413	Charge utile trop grande	Le fichier téléchargé dépasse la limite de taille.
500	Erreur interne du serveur	Erreur serveur inattendue.

Famille de SDK Cloud

L’utilisation d’un SDK constitue la meilleure façon d’accélérer le développement. Un SDK gère les détails de bas niveau, afin que vous puissiez vous concentrer sur les tâches de votre projet. Veuillez consulter le dépôt GitHub pour obtenir la liste complète des SDK Aspose.Cells Cloud.

Les exemples de code suivants montrent comment appeler les services web Aspose.Cells à l’aide de divers SDK :

Obtenir le formatage conditionnel Ajouter une zone de cellules à la mise en forme conditionnelle