Skip to main content

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

Output Data with Anchors.png

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 de sortie à 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

Télécharger fichier

Pour télécharger les résultats de votre workflow, sélectionnez Télécharger le fichier :

Pour télécharger les résultats de votre workflow, sélectionnez Télécharger le fichier :

To configure your file for download...

  1. Entrez un nom de fichier.

  2. Entrez un nom de fichier.

  3. Sélectionner votre format de fichier :

    • Valeurs séparées par des virgules (*.csv)

    • Microsoft Excel 1997-2003 (.xls)

    • Microsoft Excel (.xlsx)

  4. Next, choose where you want to save your output file. You can use the default File Path or select Customize Location to choose a different location.

  5. Si vous sélectionnez un format de fichier CSV, sélectionnez un délimiteur.

  6. Use the Output Actions on Every Run to select an action to perform if a file with the same name exists at the moment of the job run. If a file with the same name doesn't exist, a new file is created. Choose from...

    • Create New

    • Overwrite

  7. Si vous sélectionnez un format de fichier CSV, sélectionnez un délimiteur.

  8. Sélectionnez vos

    • Inclure les guillemets (fichiers CSV uniquement)

    • Sheet Name (XLS and XLSX formats only)

    • Partition Output (XLS and XLSX formats only): Choose if you want to publish your file as a single file or a file with multiple sheets.

    • Keep Partition Column in Output (XLS and XLSX formats only): Uncheck to exclude the column used for partitioning from the final output. For example, If dividing by quarter, you can exclude the "Quarter" column from output.

    • Inclure les en-têtes comme premières lignes

  9. Sélectionnez Enregistrer pour enregistrer les détails de votre téléchargement.

  10. Enregistrez et exécutez votre workflow. Le fichier de sortie apparaît dans la section Tâches récentes de la fenêtre de configuration de l'outil.

  11. Sélectionnez le fichier de sortie, puis sélectionnez Télécharger le fichier de sortie.

Parameters

You can use Parameters to apply dynamic values to certain parts of your file name.

  • Some parameter types (for example, String) have a default value that can be overwritten for each job execution, in a schedule or Plan.

  • Timestamp parameters are automatically populated with a formatted timestamp of the job execution.

To use a parameter in your File Name...

  1. In the File Name field, select the {x} (Add parameter) icon to open the Parameters window.

  2. If you previously created parameters that you want to use in your File Name, select them from the Workspace Parameters section. Note that the parameters are inserted at your cursor location in the File Name field. To remove a parameter from your file name, click the parameter and select Remove.

  3. If you need to create a new parameter to use in this file, select the + New button. You can also select the Manage Parameters link to launch the Parameters page where you can create new parameters and edit existing ones.

Create String Parameter
  1. To create a string parameter, select String from the Type dropdown.

  2. Enter a parameter Name. This is what shows in the file name field if you use the parameter.

  3. Enter a Description. This should be something clear that will help you and other users in the future.

  4. Enter a Default value for the parameter. This value is used if the parameter is not dynamically updated.

  5. Select Create to create the parameter and add it to the file name. To remove a parameter from your file name, click the parameter and select Remove.

Create Timestamp Parameter

You can create a Timestamp parameter to automatically populate the File Name with a formatted timestamp of the job execution.

Important

Unlike other parameters you create, Timestamp parameters are not stored in your Workspace.

  1. To create a Timestamp parameter, select Timestamp from the Type dropdown.

  2. Customize the Timestamp Format as needed. The default format is yyyy-MM-dd. Use the + button to view your customization options. The Format Preview displays today's date using your selected format.

  3. Next, set the Timestamp Value. Choose from...

    • Exact at Job Start: Outputs the exact timestamp value when the job starts.

    • Relative to Job Start: Output the timestamp relative to the Job Start time. For example, you might want a timestamp one hour after the Job Start time.

      • Occurrence: Choose to output a timestamp that is either After or Before the Job Start time.

      • Value: Choose a numerical value for your relative timestamp.

      • Unit: Choose a unit for your relative timestamp. Your options include Minutes, Hours, Days, Weeks, Months, Quarters, and Years.

  4. Next, select a Timezone for your timestamp parameter.

  5. Last, select Create to create the parameter and insert it into your file name at the cursor.

Override Parameters

When you run your workflow with parameters, the workflow uses the default value specified when the parameter was created. However, you have the option to override this value.

To override the default value for parameters...

  1. Select the dropdown icon that's part of the Run Job button.

  2. Select Parameters to open the Override Parameters window.

  3. Enter override values into the Value Override column for all parameters where you don't want to use the default.

  4. Select Save and Run Job to run your workflow with the updated parameter values.

Enregistrer dans Connexions

Pour écrire les résultats de votre workflow dans une source de données :

  1. Sélectionnez une connexion dans Connexions.

  2. If you intend to create a new table, enter a Table Name.

  3. If you intend to override an existing table with the one from your workflow, choose a schema to save your table to.

  4. Le chemin de la table indique où votre table sera écrite.

  5. Select Next to configure your Output Options.

  6. Sélectionnez vos actions de sortie à chaque exécution :

    • Créer nouveau

    • Ajouter

    • Tronquer

    • Supprimer

  7. Sélectionnez Enregistrer.

  8. Enregistrez et exécutez votre workflow. Le fichier de sortie apparaît dans la section Tâches récentes de la fenêtre de configuration de l'outil.

  9. Votre table est enregistrée dans la connexion que vous avez choisie.