Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Excel
Les actions Excel vous permettent de lire, de mettre à jour et de créer des fichiers Excel dans vos automatisations. Toutes les actions Excel prennent en charge les formats de fichier .xlsx et .xlsm. Les identificateurs de classeur conservent les références pour plusieurs opérations.
Note
Bien que les valeurs puissent être lues à partir de fichiers .xlsm, l'exécution de macros n'est pas prise en charge.
Créer un nouveau classeur
Crée un fichier Excel vierge. Produit un identifiant de classeur que vous pouvez utiliser pour mettre à jour la feuille de calcul lors des étapes suivantes.
Propriétés :
Identifiant du classeur (sortie) : nom de variable stockant la référence du classeur pour les actions futures (par défaut :)
workbook_id
Ouvrir un classeur existant
Charge un fichier Excel existant. Renvoie un identifiant de classeur que vous pouvez utiliser pour mettre à jour la feuille de calcul lors des étapes suivantes. Supporte uniquement les fichiers Excel (.xlsx).
Propriétés :
Fichier Excel (obligatoire) : le fichier .xlsx à ouvrir, généralement stocké dans une variable (par exemple,)
my_fileIdentifiant du classeur (sortie) : nom de la variable stockant la référence du classeur (par défaut :)
workbook_id
Exigences relatives aux fichiers :
Doit être un fichier Excel (.xlsx) valide
Le fichier doit être accessible en tant qu'objet de fichier multimédia
Enregistrer le classeur
Enregistre les mises à jour dans un fichier Excel. Permet de mettre à jour le nom et le type de fichier du classeur enregistré.
Propriétés :
Nom du fichier (obligatoire) : nom du fichier enregistré sans extension (par exemple, « Rapport mensuel »)
Type de fichier (liste déroulante) : format de sortie - supporte actuellement le format XLSX (par défaut : XLSX)
Fichier enregistré (sortie) : variable stockant l'objet du fichier enregistré (par défaut :
saved_file)
Lire la feuille
Obtient les données d'une série de cellules. L'action stocke la sortie dans une variable de table de données.
Propriétés :
Identifiant du classeur (obligatoire) : Le classeur à lire (par exemple,)
workbook_idNom de la feuille (obligatoire) : nom de la feuille de travail ou de l'onglet (par défaut : « Feuille1 »)
Plage de cellules (en option) : spécification de plage : prend en charge plusieurs formats :
Cellule de départ : « A2 » (lit toutes les données depuis le point d'ancrage)
Gamme exacte : « A1 : B10 »
Plage de colonnes : « A:B »
Plage de rangées : « 1:3 »
Vide : lit la feuille entière
Inclure les en-têtes (case à cocher) : traite la première ligne comme des en-têtes de colonne lorsque cette option est activée. Lorsque cette option est désactivée, utilise le nom par défaut (Colonne0, Colonne1, etc.) (valeur par défaut : TRUE)
Table de données (sortie) : variable stockant les données extraites (par défaut :
excel_table)
Manipulation des formules :
L'action calcule automatiquement les formules et stocke les résultats dans le tableau de données.
Lire la cellule
Extrait la valeur d'une cellule. Utilisé pour lire la valeur d'une cellule individuelle dans une feuille de calcul.
Propriétés :
Identifiant du classeur (obligatoire) : Le classeur à lire (par exemple,)
workbook_idNom de la feuille (obligatoire) : nom de la feuille de travail (par défaut : « Sheet1")
Référence de cellule (obligatoire) : emplacement de la cellule (par exemple, « A1 »)
Valeur de cellule (sortie) : variable stockant le contenu de la cellule (par défaut :
cell_value)
Écrire sur la feuille
Envoie un tableau de données dans une feuille. Utilisé pour écrire une série de lignes et de colonnes dans une feuille de calcul.
Propriétés :
Table de données (obligatoire) : La table de données à écrire (par exemple,
my_table)Identifiant du classeur (obligatoire) : classeur cible (par exemple,)
workbook_idNom de la feuille (obligatoire) : feuille de calcul cible (par défaut : « Sheet1")
Commencer par la cellule (facultatif) : position de départ pour le placement des données (par défaut : « A1 »)
Inclure les en-têtes (case à cocher) : écrit les en-têtes de colonne lorsque cette option est activée (valeur par défaut : TRUE)
Écrire dans une cellule
Envoie une valeur dans une cellule. Utilisé pour mettre à jour les cellules individuelles d'une feuille de calcul.
Propriétés :
Valeur à écrire (obligatoire) : contenu de la cellule (par exemple, « Order #12345 »)
Identifiant du classeur (obligatoire) : classeur cible (par exemple,)
workbook_idNom de la feuille (obligatoire) : feuille de calcul cible (par défaut : « Sheet1")
Référence de cellule (obligatoire) : emplacement de la cellule cible (par exemple, « A1 »)
Écrire une nouvelle ligne
Ajoute une ligne de données à la feuille. La nouvelle ligne est ajoutée à la fin des données existantes.
Propriétés :
Valeurs de ligne (obligatoire) : tableau de valeurs pour la nouvelle ligne, en commençant par la première colonne (par exemple, ["Q1 », « Sales », 100])
Identifiant du classeur (obligatoire) : classeur cible (par exemple,)
workbook_idNom de la feuille (obligatoire) : feuille de calcul cible (par défaut : « Sheet1")
Validation des données :
Doit fournir des valeurs sous forme de tableau
Les valeurs sont écrites séquentiellement à partir de la première colonne
Créer une nouvelle feuille
Ajoute une feuille de calcul vide. La nouvelle feuille est ajoutée à la fin du classeur.
Propriétés :
Identifiant du classeur (obligatoire) : classeur cible (par exemple,)
workbook_idNom de la feuille (obligatoire) : nom de la nouvelle feuille de travail (par exemple, « Données de vente »)
Feuille de copie
Crée une copie de la feuille de travail. La nouvelle feuille est créée dans le même classeur.
Propriétés :
Identifiant du classeur (obligatoire) : classeur cible (par exemple,)
workbook_idNom de la feuille à copier (obligatoire) : nom de la feuille de calcul source (par exemple, « Feuille originale »)
Nom de la nouvelle feuille (obligatoire) : nom de la feuille dupliquée (par exemple, « Feuille originale (copie) »)
Renommer la feuille
Met à jour le nom d'une feuille de calcul existante.
Propriétés :
Identifiant du classeur (obligatoire) : classeur cible (par exemple,)
workbook_idNom de la feuille actuelle (obligatoire) : nom de la feuille de calcul existante (par exemple, « Sheet1 »)
Nom de feuille mis à jour (obligatoire) : nouveau nom de la feuille de travail (par exemple, « Q1 Data »)
Supprimer la feuille
Supprime une feuille d'un classeur. Impossible de supprimer la dernière feuille restante d'un classeur.
Propriétés :
Identifiant du classeur (obligatoire) : classeur cible (par exemple,)
workbook_idNom de la feuille à supprimer (obligatoire) : feuille de travail à supprimer (par exemple, « Feuille 1 »)
Contraintes :
Impossible de supprimer la dernière feuille restante d'un classeur
Définir la couleur de la cellule
Actualise la couleur d'arrière-plan des cellules. Utilisé pour mettre en évidence une plage spécifique de cellules.
Propriétés :
Couleur de la cellule (obligatoire) : format de code hexadécimal RGB (par exemple, « FF0000 » pour le rouge)
Identifiant du classeur (obligatoire) : classeur cible (par exemple,)
workbook_idNom de la feuille (obligatoire) : feuille de travail cible (par exemple, « Feuille 1 »)
Plage de cellules (obligatoire) : plage de formatage - prend en charge :
Cellule unique : « A1 »
Gamme exacte : « A1 : B10 »
Plage de colonnes : « A:B »
Plage de rangées : « 1:3 »
Obtenir la couleur des cellules
Lit la couleur d'arrière-plan de la cellule. Affiche la couleur au format de code hexadécimal RGB (par exemple, « FF0000 » pour le rouge).
Propriétés :
Identifiant du classeur (obligatoire) : classeur source (par exemple,)
workbook_idNom de la feuille (obligatoire) : feuille de travail source (par exemple, « Sheet1 »)
Référence de cellule (obligatoire) : cellule à lire (par exemple, « A1 »)
Couleur de la cellule (sortie) : variable stockant le code hexadécimal RGB (par défaut :
cell_color)
Masquer les lignes
Masque les lignes dans la feuille. Les données restent intactes mais ne sont pas visibles.
Propriétés :
Identifiant du classeur (obligatoire) : classeur cible (par exemple,)
workbook_idNom de la feuille (obligatoire) : feuille de travail cible (par exemple, « Feuille 1 »)
Ligne de départ (obligatoire) : premier numéro de ligne à masquer (la numérotation Excel commence à 1)
Ligne de fin (facultatif) : numéro de la dernière ligne à masquer. Si elle est vide, seule la ligne de départ est masquée
Numérotation des lignes :
Les numéros de ligne Excel commencent à 1 (et non à 0)
Doit fournir des valeurs entières
Afficher les lignes
Rend visibles les lignes masquées. Utilisé pour afficher les lignes précédemment masquées.
Propriétés :
Identifiant du classeur (obligatoire) : classeur cible (par exemple,)
workbook_idNom de la feuille (obligatoire) : feuille de travail cible (par exemple, « Feuille 1 »)
Ligne de départ (obligatoire) : premier numéro de ligne à afficher (la numérotation Excel commence à 1)
Ligne de fin (facultatif) : dernier numéro de ligne à afficher. S'il est vide, seule la ligne de départ est visible
Bonnes pratiques et limites
Gestion des identifiants des classeurs
Stockez les identifiants de classeur dans des variables descriptives (par exemple,,
sales_workbook)report_fileRéutiliser le même identifiant pour plusieurs actions sur le même classeur
Créez ou ouvrez toujours un classeur avant d'effectuer des opérations sur les données
Spécifications de la gamme
Utilisez des plages exactes (« A1 : B10 ») pour des opérations de données précises
Utilisez des plages de colonnes (« A:B ») lorsque vous travaillez avec des colonnes entières
Utiliser des plages de lignes (« 1:3 ») pour les opérations d'en-tête ou de résumé
Laissez la plage vide pour traiter des feuilles entières
Optimisation des performances
Lisez des plages entières lorsque cela est possible plutôt que des cellules individuelles
Opérations d'écriture par lots utilisant des tables de données plutôt que des écritures de cellules individuelles
Enregistrer les classeurs uniquement lorsque toutes les modifications sont terminées
Limitation
La compatibilité des fichiers est limitée au format Excel (.xlsx) moderne uniquement ; les anciens fichiers Excel (.xls) ne sont pas pris en charge.
