Pour gérer des classeurs Microsoft Excel® dans le cadre d'une chaîne, ajoutez une étape qui inclut une commande de connexion à Microsoft Excel.
Remarque : Le connecteur Microsoft Excel prend en charge les fichiers de classeurs Excel (XLSM) compatibles avec les macros, mais n'exécute pas les macros VBA (Virtual Basic for Applications) ni les macros basées sur des événements, telles que Workbook Open, BeforeSave ou SheetCalculate.
Pour activer ces commandes, un administrateur informatique crée d'abord un connecteur Microsoft Excel.
Créer un classeur à partir de fichiers
Pour créer ou mettre à jour un classeur Excel avec des feuilles basées sur des données provenant de fichiers de valeurs séparées par des délimiteurs, utilisez la commande Create Workbook from Files.
Veuillez noter que vous disposez de deux options de sortie en fonction de la configuration de votre connecteur :
- Si vous utilisez un GroundRunner, entrez un objet JSON (Javascript Object Notation).
- Si vous utilisez un CloudRunner, indiquez leurs sorties de commande ou leurs ressources dans la chaîne.
Propriétés
| Propriété |
Détail |
| Fichiers |
Spécifiez les fichiers à créer en tant que feuilles séparées dans le classeur :
- Pour les fichiers basés sur les sorties ou les ressources de la chaîne, cliquez sur Add pour chaque fichier, sélectionnez sa sortie ou sa ressource et saisissez le nom de sa feuille (jusqu'à 31 caractères).
Conseil : Pour récupérer un fichier à partir d'un emplacement réseau, utilisez le connecteur File Utilities 's Get file command plus tôt dans la chaîne.
- Pour spécifier les fichiers sous forme de JSON, sélectionnez Activer la variable, et saisissez le JSON ou sélectionnez l'objet JSON à partir de la sortie d'une commande précédente. Formulez le JSON comme suit :
[
{"file" : "fullPathToFile_1", "name" : "sheetName_1"},
{"file" : "fullPathToFile_2", "name" : "sheetName_2"}
] Note : Pour inclure le fichier de sortie d'une commande précédente dans le JSON, saisissez le chemin complet de son emplacement dans le dossier de traitement GroundRunner.
|
| Séparateur |
Sélectionnez le délimiteur utilisé dans les fichiers. |
| Nom du classeur |
Pour créer un nouveau classeur à partir des fichiers, saisissez un nom unique permettant de l'identifier. Note : La commande crée automatiquement une extension .xlsx si elle n'est pas fournie. |
| Classeur existant |
Pour ajouter les données des fichiers à un classeur existant plutôt qu'à un nouveau classeur, sélectionnez le fichier du classeur à mettre à jour. Toute feuille dont le nom a été saisi dans Files est écrasée. Important : Lorsque vous utilisez cette commande sur un fichier protégé, le classeur résultant ne sera pas protégé. Cela signifie que vous devez réintroduire manuellement le cryptage lorsque vous travaillez avec un fichier protégé. |
Sorties
| Sortie |
Type de sortie |
| Classeur XLSX |
Fichier |
Codes de sortie
| Code |
Type |
Détail |
| 0 |
Réussite |
Commande réussie |
| 1 |
Erreur |
Échec général |
Lister les feuilles
Pour créer une liste JSON de toutes les feuilles d'un classeur Excel, utilisez la commande List Sheets.
Propriétés
| Propriété |
Détail |
| Fichier du classeur |
Saisissez le classeur XLS ou XLSX dont vous souhaitez lister les feuilles. |
| Mot de passe |
Si le fichier de classeur est un classeur XLSX protégé par un mot de passe, saisissez son mot de passe. |
Sorties
| Sortie |
Type de sortie |
| Feuilles JSON |
Fichier |
Codes de sortie
| Code |
Type |
Détail |
| 0 |
Réussite |
Commande réussie |
| 1 |
Erreur |
Échec général |
Feuille de calcul vers CSV
Pour convertir les données de la feuille d'un classeur Excel en un fichier tabulaire, utilisez la commande Worksheet to CSV.
Note : La commande Worksheet to CSV extrait les dernières valeurs calculées dans la feuille de calcul ; aucune formule de calcul n'est exécutée pour mettre à jour les valeurs. Pour les feuilles de calcul dont les calculs automatiques sont désactivés, calculez et enregistrez manuellement les valeurs avant l'exécution de la chaîne afin d'en garantir l'exactitude.
Propriétés
| Propriété |
Détail |
| Fichier du classeur |
Saisissez le classeur XLS ou XLSX contenant la feuille à convertir en fichier tabulaire. |
| Mot de passe |
Si le fichier de classeur est un classeur XLSX protégé par un mot de passe, saisissez son mot de passe. |
| Séparateur |
Sélectionnez le délimiteur à utiliser dans le fichier de sortie. |
| Nom de la feuille |
Saisissez le nom de la feuille du classeur à convertir. Pour identifier la feuille par son index, ne rien indiquer. |
| Index des feuilles |
Entrez la position de l'index de la feuille dans le classeur à convertir, avec 1 pour la première feuille, et -1 pour la dernière. Pour identifier la feuille par son nom, ne rien indiquer. |
| Cellule de départ |
Saisissez la cellule dans la première ligne et la première colonne des données de la feuille à convertir. |
| Fin de la colonne |
En notation A1, entrez la lettre de la colonne - par exemple A, B ou C, sans le numéro de ligne - où se terminent les données à convertir. Note : La commande ignore toutes les données de la feuille après cette colonne. |
| Fin de rangée |
En notation A1, entrez le numéro de la ligne - par exemple 10, 200, 3000, sans la lettre de la colonne - où se terminent les données à convertir. Pour ignorer la ligne, entrez 0. Note : La commande ignore toutes les données de la colonne située après cette ligne. |
| Utiliser des valeurs de cellules formatées |
Pour convertir les valeurs d'affichage des cellules au lieu de leurs valeurs brutes, par exemple pour la gestion de la date et de l'heure, cochez cette case. |
| Résultats en avant-première |
Pour activer l'aperçu du fichier de sortie, cochez cette case. |
| Mode streaming |
Ne s'applique qu'aux fichiers XLSX volumineux. Recommandé pour les fichiers de plus de 20mb. Lit le fichier dans des fenêtres de données plus petites pour réduire l'utilisation de la mémoire. Certaines formules, en particulier celles qui font référence à des cellules plus éloignées dans le fichier, peuvent ne pas fonctionner correctement lorsque ce paramètre est activé en conjonction avec l'option des valeurs formatées. |
Sorties
| Sortie |
Type de sortie |
| Sortie CSV |
Fichier |
Codes de sortie
| Code |
Type |
Détail |
| 0 |
Réussite |
Commande réussie |
| 1 |
Erreur |
Échec général |