Portail de support Workiva

La commande "Convert XLSX to CSV" de la transformation tabulaire a été supprimée en novembre 2023 et remplacée par la commande "Worksheet to CSV" du connecteur Microsoft Excel. Bien que l'ancienne commande puisse encore être utilisée, elle est moins stable et peut échouer lors de la manipulation de fichiers de grande taille.

L'article suivant vous montrera comment mettre à jour vos chaînes existantes pour utiliser la commande Worksheet to CSV.

Remarque : La commande "Convert XLSX to CSV" prend en charge un fichier d'une taille maximale de 120mb.

Avant de commencer

• Le connecteur Microsoft Excel doit être activé dans votre espace de travail. Ce connecteur de base est inclus dans votre abonnement et est disponible pour tous les utilisateurs. S'il n'a pas encore été ajouté, demandez à un administrateur de l'organisation de suivre les étapes énumérées dans cet article.

Mettez à jour votre chaîne

Pour mettre à jour les commandes de votre chaîne, vous devez déconnecter la commande "Convert XLSX to CSV" et insérer la commande "Worksheet to CSV" à sa place. Vous pouvez ensuite copier les entrées de l'ancien nœud et les coller dans le nouveau.

1. Connectez-vous à Chain Builder.
2. Allez dans l'onglet Chains device_hub, et cliquez sur Edit create à droite pour la chaîne que vous devez mettre à jour.
3. Localisez la commande Convert XLSX to CSV sur votre canevas de chaîne. Double-cliquez sur le premier lien reliant cette commande au reste de la chaîne.
   
4. Cliquez sur Delete pour supprimer le lien.
   
5. Répéter l'étape précédente de l'autre côté du nœud. La commande "Convert XLSX to CSV" doit être déconnectée du reste de la chaîne.
6. Faites glisser la commande Convert XLSX to CSV déconnectée sur le côté du canevas.
   
   

   Note: Une fois déconnectée, cette commande ne sera plus exécutée. Nous le conserverons toutefois sur le canevas, comme point de référence pour le nouveau commandement.

7. Dans le panneau Nœuds sur le côté gauche, recherchez la commande Worksheet to CSV. 
8. Faites-le glisser et déposez-le dans l'espace prévu à cet effet sur le canevas.
   
9. Reconnectez la chaîne en faisant glisser les liens vers la nouvelle commande Worksheet to CSV.
   
10. Survolez la commande Worksheet to CSV et cliquez sur Modifier create.
    
11. Saisissez les détails de votre feuille de calcul Excel; vous pouvez ouvrir la commande "Convert XLSX to CSV" orpheline sur votre canevas pour récupérer ces détails. La nouvelle et l'ancienne commande utilisent des champs presque identiques.
    

    Propriété	Détail
    Fichier du classeur	Saisissez le classeur XLS ou XLSX contenant la feuille à convertir en fichier tabulaire. Note : Ceci est équivalent au champ "Fichiers d'entrée" de la commande Convertir XLSX en CSV.
    Mot de passe	Si le fichier du classeur est un classeur XLSX protégé par un mot de passe, saisissez son mot de passe. Note: Ce champ n'est pas disponible dans la commande "Convert XLSX to CSV" ; avec cette mise à jour, vous avez maintenant la possibilité d'utiliser des classeurs sécurisés.
    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. Note: Ce champ n'est pas disponible dans la commande "Convertir XLSX en CSV" ; avec cette mise à jour, vous avez maintenant la possibilité d'extraire une formule (=SUM(A1:A23)) ou la valeur réelle (1234.56).
    Résultats en avant-première	Pour activer l'aperçu du fichier de sortie, cochez cette case.
    Mode streaming	Activez ce paramètre pour les fichiers de plus de 25 mégaoctets.  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.

12. Cliquez sur Enregistrer pour terminer.

Une fois sauvegardée, publiez et exécutez votre nouvelle chaîne. 

Comparaison des caractéristiques

Ces deux commandes sont pratiquement identiques dans leurs entrées et leurs fonctions, et nous recommandons vivement de copier les valeurs de la commande existante dans la nouvelle. Le tableau suivant indique les entrées équivalentes pour les deux commandes.

Veuillez noter que deux entrées supplémentaires sont incluses dans la commande "Worksheet to CSV" :

• Mot de passe: permet de fournir des cahiers d'exercices sécurisés.
• Cellules formatées: Permet d'extraire une formule (=SUM(A1:A23)) ou la valeur réelle (1234.56)

Dépannage

Si la commande Worksheet to CSV ne convertit aucune donnée :

• Vérifier le nom ou l'index de la feuille du classeur à partir de laquelle les données doivent être extraites.
• Assurez-vous que la plage de cellules de la feuille - en fonction des propriétés Start cell, End column, et End row - contient des données.