Exporting Data to an Excel File

The Export to Excel task exports datasets or other Rulex structures to a series of Excel sheets within an Excel file.


Prerequisites

Additional tabs

The following additional tabs are provided:


Procedure

  1. Drag and drop the Export to Excel task onto the stage.

  2. Connect a task, which contains the data you want to export, to the new task.

  3. Double click the Export to Excel task.

  4. Configure the task options as described in the table below in the Options and File Format tabs.

  5. Save and compute the task.

Export to Excel File options

Parameter Name

PO

Description

Data to be exported

reflist

Select what type data you want to export from the list of options.

Possible options are:

  • Association rules (produced by Hierarchical Basket Analysis and Similar Items Detector tasks)

  • Auto regressive models (produced by Auto Regressive task)

  • Clusters (produced by Label Clustering, Projection Clustering and Standard Clustering tasks)

  • Cluster Labels (produced by Label Clustering and Projection Clustering tasks)

  • Datasets (all import, data preparation and data pre-processing tasks)

  • Discretization cutoffs (produced by Discretize task)

  • Frequent itemsets (produced by Frequent Itemsets Mining task)

  • Frequent sequences (produced by Sequence Analysis task)

  • Results (produced by all data analysis tasks)

  • Rules (produced by LLM tasks (Classification, Regression & One-Class), along with Decision Tree and Regression Tree tasks)

  • Models (produced by Logistic, Linear, Neural Networks (Classification and Regression) and SVM (Classification and Regression).

  • PCA eigenvectors (produced by the Principal Component Analysis task)

  • Relevances (produced by classification and regression tasks).

Mode

mode

Select how you want to save the file, either by storing it in a location you will then specify, by sending the file as an e-mail or both ways.

If you select to send the file by e-mail, you  must then specify the e-mail address in the Recipients for export via email edit box.

Export URI

uri

Select whether the file will be saved locally (Local File System) or remotely (SharePoint, HDFS, AWS S3, FTP, Azure Storage). If you chose to save the file remotely you must also configure the Remote Connection parameters in the Remote Connections tab.

Directory

dirname

Enter or browse to the directory where the file will be saved.

File basename

basename

Enter a name for the name that will be given to the exported file.

If you are exporting to a Azure Storage repository you can either:

  • select just the container where you want to save the file as the Directory, and then specify the metadata file name of the blob in the File basename parameter. 
    In this case a blob with the same name as the file will be automatically created for the file.

  • select the container, and manually add the name of the blob, where you want to save the file as the Directory, and then specify the metadata file name of the blob in the File basename parameter. 
    In this case the file will be saved in the specified blob and container.

Sheet name

sheetname

The name of the sheet where the dataset will be exported. If left blank, the default name "Dataset" will be used for the sheet.

Append a sheet to the file, it it exists

apppendfile

If selected, a sheet will be appended to the file, if a file corresponding to  the specified basename already exists. 

Be aware that if you export another dataset, with the same file basename, the same sheet name and with this option selected you will overwrite the original sheet with the new exported sheet.

Add current date and time as prefix

timestampprefix

If selected, the date and timestamp will be added to the start of the file basename as a prefix

Add current date and time as suffix

timestampsuffix

If selected, the date and timestamp will be added to the end of the file basename as a suffix

Recipients for export via email (use comma as separator)

recipients

Specify the email addresses where the exported file will be sent, separated by commas.

This option will only be valid if you have selected Send via email or Both in the Mode option.

Export to Excel File - File Format options

Write attribute names

writenames

If selected, the attribute names will be included in the exported excel file.

Write attribute types

writetypes

If selected, the attribute types will be included in the exported excel file.

Write covering statistics

(only for Rules)

writecov

If selected covering statistics for rules will be added to the exported excel file.

Write error statistics (only for Rules)

writeerr

If selected error statistics for rules will be added to the exported excel file.

Write condition covering statistics (only for Rules)

writeccov

If selected covering statistics for conditions will be added to the exported excel file.

Write condition error statistics (only for Rules)

writecerr

If selected error statistics for conditions will be added to the exported excel file.

Rule format (only for Rules)

ruleformat

Select whether you want the rule data to be expressed as If-then rules or as a matrix (C-like).