Outil Sortie de données
Utilisez l'outil Sortie de données pour écrire les résultats d'un workflow dans les types de fichiers ou les sources de données pris en charge.
Sélectionnez l'outil Sortie de données dans la palette et faites-le glisser vers le canevas du workflow.
Composants de l'outil
 |
Figure : Outil Sortie de données avec un ancrage.
L'outil Sortie de données comporte un seul ancrage.
Ancrage d'entrée : connectez l'ancrage d'entrée à votre workflow pour écrire vos résultats de workflow dans une source de données ou un type de fichier pris en charge.
Configuration de l'outil
Enregistrer dans des connexions basées sur des fichiers
Pour enregistrer les résultats de votre workflow dans une connexion basée sur un fichier :
Dans la fenêtre de configuration de l'outil, sélectionnez Sélectionner un emplacement de sortie pour ouvrir la fenêtre Sortie de données.
Sélectionnez une connexion aux données cloud dans Connexions ou sélectionnez-en une dans vos Jeux de données existants.
Entrez un nom de fichier. Vous pouvez également sélectionner l'icône {x} (Ajouter un paramètre) pour ajouter des paramètres à votre Nom de fichier. Pour plus d'informations, consultez la section Paramètres.
Sélectionnez le format du fichier :
CSV : valeur séparée par des virgules (.csv)
XLS :Microsoft Excel 1997-2003 (.xls)
XLSX : Microsoft Excel (.xlsx)
Ensuite, choisissez l'emplacement où vous souhaitez enregistrer votre sortie de données. Vous pouvez utiliser le chemin du fichier par défaut ou cocher la case Personnaliser l'emplacement pour choisir un autre emplacement. Si vous sélectionnez un emplacement personnalisé, vous pouvez ajouter des paramètres au chemin de fichier à l'aide de l'icône {x} (Ajouter un paramètre). Pour plus d'informations, consultez la section Paramètres.
Sélectionnez Suivant pour personnaliser vos Options de sortie.
Utilisez la liste déroulante Actions de sortie à chaque exécution pour sélectionner une action à exécuter si un fichier portant le même nom existe au moment de l'exécution de la tâche.
Pour les fichiers CSV :
Créer nouveau
Écraser
Pour les fichiers Excel :
Créer un nouveau classeur
Remplacer le classeur
Créer une nouvelle feuille
Remplacer la feuille existante
Ajouter à une feuille
Vous pouvez désormais écrire simultanément sur différentes feuilles dans un classeur Excel. Cela signifie que vous pouvez utiliser 2 outils de sortie ou plus pour écrire dans le même classeur sur des feuilles distinctes. Vous n'avez pas besoin de l'outil Bloquer jusqu'à la fin pour exécuter cette opération. L'écriture simultanée n'est possible que lorsque l'option Écraser une feuille existante est sélectionnée.
Si vous avez sélectionné un format de fichier CSV, sélectionnez un séparateur de colonne. Vos options sont Virgule, Tabulation, Barre verticale et Point-virgule.
Choisissez des options supplémentaires pour votre sortie :
Inclure les guillemets (fichiers CSV uniquement)
Nom de la feuille (formats XLS et XLSX uniquement)
Partitionnement de sortie (formats XLS et XLSX uniquement) : choisissez si vous souhaitez publier votre fichier en tant que fichier unique ou en tant que fichier avec plusieurs feuilles. Si cette option est sélectionnée, utilisez la liste déroulante Partitionner à partir de la colonne pour sélectionner la colonne à utiliser pour partitionner les feuilles en fonction des valeurs de la colonne.
Conserver la colonne Partition dans la sortie (formats XLS et XLSX uniquement) : décochez cette case pour exclure la colonne utilisée pour le partitionnement de la sortie finale. Par exemple, si vous divisez par trimestre, vous pouvez exclure la colonne « Trimestre » de la sortie.
Inclure les noms de colonne comme première ligne
Sélectionnez Confirmer pour enregistrer les détails de votre sortie de données. Vous pouvez ensuite vérifier votre sélection dans le panneau de configuration de l'outil Sortie de données et utiliser l'icône en forme de crayon pour apporter des modifications si nécessaire.
Sélectionnez Exécuter la tâche dans votre workflow et enregistrez votre fichier dans la connexion choisie.
Enregistrer dans des connexions basées sur SQL
Pour enregistrer les résultats de votre workflow dans une connexion SQL :
Dans la fenêtre de configuration de l'outil, sélectionnez Sélectionner un emplacement de sortie pour ouvrir la fenêtre Sortie de données.
Sélectionnez une connexion aux données cloud dans Connexions ou sélectionnez-en une dans vos Jeux de données existants.
Saisissez un Nom de table. Vous pouvez également sélectionner l'icône {x} (Ajouter un paramètre) pour ajouter des paramètres à votre Nom de table. Pour plus d'informations, consultez la section Paramètres.
Ensuite, sélectionnez un schéma dans lequel vous souhaitez enregistrer votre table, puis sélectionnez Suivant.
Utilisez la liste déroulante Actions de sortie à chaque exécution pour sélectionner une action à exécuter si une table portant le même nom existe au moment de l'exécution de la tâche.
Créer une nouvelle table : crée une nouvelle table.
Ajouter à une table : les données sont ajoutées à la fin de la table existante.
Tronquer la table existante : les données de table existantes sont supprimées et remplacées par de nouvelles données.
Supprimer la table existante : la table existante est supprimée et remplacée par la nouvelle table.
Fusionner avec la table existante : la sortie de données est fusionnée avec la table existante.
Sélectionnez Confirmer pour enregistrer les détails de votre sortie de données. Vous pouvez ensuite vérifier votre sélection dans le panneau de configuration de l'outil Sortie de données et utiliser l'icône en forme de crayon pour apporter des modifications si nécessaire.
Sélectionnez Exécuter la tâche dans votre workflow et enregistrez votre fichier dans la connexion choisie.
Télécharger fichier
Pour télécharger la sortie de données sur votre ordinateur, veuillez d'abord l'enregistrer au format Alteryx One. L'option la plus rapide consiste à enregistrer le fichier à un emplacement par défaut dans le Stockage de base. Vous pouvez également personnaliser l'emplacement dans le Stockage de base ou choisir un autre connecteur.
Après avoir exécuté le workflow, accédez à l'outil Sortie sur le canevas et sélectionnez Télécharger dans la section Tâche du panneau de droite.
Paramètres
Utilisez Paramètres pour appliquer des valeurs de chaîne ou d'horodatage dynamiques à votre sortie de données. Vous pouvez appliquer des paramètres au nom de fichier, au chemin du fichier ou au nom de la table, selon le type de connexion cloud.
Les paramètres de chaîne ont une valeur par défaut qui peut être remplacée pour chaque exécution de tâche, dans une planification ou un plan.
Les paramètres d'horodatage sont automatiquement renseignés avec un horodatage formaté au moment de l'exécution de la tâche.
Pour utiliser un paramètre dans le nom de fichier ou le nom de table…
Dans le champ Nom de fichier ou Nom de table, sélectionnez l'icône {x} (Ajouter un paramètre) pour ouvrir la fenêtre Paramètres.
Si vous avez précédemment créé un paramètre, sélectionnez-le dans la section Paramètres de l'espace de travail. Notez que les paramètres sont insérés à l'emplacement de votre curseur dans le champ Nom de fichier. Pour supprimer un paramètre de votre nom de fichier, sélectionnez le paramètre, puis Supprimer.
Si vous avez besoin de créer un nouveau paramètre, sélectionnez + Nouveau. Vous pouvez également sélectionner le lien Gérer les paramètres pour ouvrir la page Paramètres, où vous pouvez créer de nouveaux paramètres et modifier les paramètres existants.
Pour utiliser un paramètre dans le Chemin du fichier…
Cochez la case Personnaliser l'emplacement.
Sélectionnez l'icône de modification (crayon) en regard du Chemin du fichier.
Sélectionnez l'icône {x} (Ajouter un paramètre) pour ouvrir la fenêtre Paramètres.
Si vous avez précédemment créé un paramètre, sélectionnez-le dans la section Paramètres de l'espace de travail. Notez que les paramètres sont insérés à l'emplacement de votre curseur dans le champ Nom de fichier. Pour supprimer un paramètre de votre nom de fichier, sélectionnez le paramètre, puis Supprimer.
Si vous avez besoin de créer un nouveau paramètre, sélectionnez + Nouveau. Vous pouvez également sélectionner le lien Gérer les paramètres pour ouvrir la page Paramètres, où vous pouvez créer de nouveaux paramètres et modifier les paramètres existants.
Créer un paramètre de chaîne
Utilisez un paramètre de chaîne pour étiqueter dynamiquement votre sortie de données.
Pour créer un paramètre de type chaîne, sélectionnez + Nouveau dans la fenêtre Paramètres, puis sélectionnez Chaîne dans la liste déroulante Type.
Saisissez un Nom de paramètre. C'est ce qui s'affiche dans le champ Nom de fichier si vous utilisez le paramètre.
Saisissez une description. Elle doit être claire pour vous aider, vous et les autres utilisateurs, à l'avenir.
Saisissez une Valeur par défaut pour le paramètre. Cette valeur est utilisée si le paramètre n'est pas mis à jour dynamiquement.
Sélectionnez Créer pour créer le paramètre et l'ajouter au nom ou au chemin du fichier. Pour supprimer un paramètre, sélectionnez-le et sélectionnez Supprimer.
Créer un paramètre d'horodatage
Utilisez un paramètre d'horodatage pour remplir automatiquement un horodatage formaté au moment de l'exécution de la tâche.
Note
Contrairement aux paramètres de chaîne, les paramètres d'horodatage ne sont pas stockés sur la page Paramètres.
Pour créer un paramètre d'horodatage, sélectionnez + Nouveau dans la fenêtre Paramètres, puis sélectionnez Horodatage dans la liste déroulante Type.
Personnalisez le format d'horodatage selon vos besoins. Le format par défaut est aaaa-MM-jj. Sélectionnez le bouton + pour afficher vos options de personnalisation. L'Aperçu du format affiche la date actuelle dans le format sélectionné.
Définissez ensuite la Valeur d'horodatage. Choisissez parmi...
Exact au début de la tâche : génère la valeur exacte de l'horodatage au démarrage de la tâche.
Relative au début de la tâche : génère l'horodatage relatif à l'heure de début de la tâche. Par exemple, vous pouvez avoir besoin d'un horodatage 1 heure après l'heure de début de la tâche.
Occurrence : choisissez de générer un horodatage postérieur ou antérieur à l'heure de début de la tâche.
Valeur : choisissez une valeur numérique pour votre horodatage relatif.
Unité : choisissez une unité pour votre horodatage relatif. Vos options comprennent :
Minutes
Heures
Jours
Semaines
Mois
Trimestres
Années
Sélectionnez ensuite un Fuseau horaire pour votre paramètre d'horodatage.
Enfin, sélectionnez Créer pour créer le paramètre et insérez-le au niveau de la position de votre curseur.
Remplacer les paramètres
Lorsque vous exécutez votre workflow avec des paramètres de chaîne, celui-ci utilise la valeur par défaut indiquée lors de la création du paramètre. Cependant, vous avez la possibilité de remplacer cette valeur.
Pour remplacer la valeur par défaut des paramètres de chaîne…
Sélectionnez l'icône déroulante du bouton Exécuter la tâche.
Sélectionnez Paramètres pour ouvrir la fenêtre Remplacer les paramètres.
Entrez des valeurs de remplacement dans la colonne Valeur de remplacement pour tous les paramètres pour lesquels vous ne souhaitez pas utiliser la valeur par défaut.
Sélectionnez Enregistrer et exécuter la tâche pour exécuter votre workflow avec les valeurs de paramètre mises à jour.