• Contents
  • Index

Altair® Monarch®

 

Exporting Data in Data Prep Studio

You can export individual or multiple tables after combining and transforming these.

Tables may be exported in Data Prep Studio via two ways:

  • Named Exports - These exports are set up using the Export window and saved with the workspace.  

  • Quick Exports - These exports are set up from the Prepare window via the table list context menu or by right-clicking on a table in the Export window. Quick exports are not saved with the workspace.

Setting up named exports

Steps:

  1. Select Export from the Data Prep Studio toolbar.

    The Export Window displays:

     

  2. Click the Add Export button located to the right of the table you wish to export and, from the options that display, select an export format.

    You can export tables to the following formats:

    • Microsoft Excel (.xls, .xlsx, .xlsm)

    • Microsoft Access (.mdb, .accdb)

    • CSV

    • JSON

    • Microsoft Power BI

    • IBM Cognos Analytics

    • SAS Transport File Format (XPORT) Version 5

    • Altair Knowledge Studio (.kdd)

    • Tableau TDE (.tde)

    • Tableau Server (.tde, .hyper)

    • Qlik (.qvx)

    • Altair Panopticon (.xls, .xlsx, .xlsm)

     

    NOTES:

    • The current version of Monarch Data Prep Studio no longer supports integration with Altair Knowledge Hub. Thus, when an export to Knowledge Hub is run from a workspace created in previous versions of DPS, the error message "Monarch Data Prep Studio no longer supports integration with Altair Knowledge Hub" displays.  

    • Data exported in Data Prep Studio to Excel files are exported as named ranges. Thus, when the table is opened, the worksheet name displayed corresponds to that of the named range.

    The table you selected displays in the Export Management panel and its properties display in the Export Properties panel.

     

  3. Rename the export if you wish by clicking on the Edit button located to the left of the Export name (in the figure above, "Join - Microsoft Excel") and then entering a new name into the field.

  4. Specify general export options as necessary. Your export options will vary depending on the export type. The table below describes these settings.

    Field

    For Export Type

    Description

    Export Name

    All

    Each export is assigned a name using the convention <Table Name> - <Export Format>. Click on the edit button of this field to change the name of your export if you wish.

    Export Type

    All

    This field is prepopulated with the value you selected from the Export type drop-down.

    Export As/Export Location

    • Microsoft Excel

    • Microsoft Access

    • CSV

    • JSON

    • SAS Transport File Format (XPORT) Version 5

    • Altair Knowledge Studio

    • Tableau TDE

    • Qlik

    • Altair Panopticon

    This setting describes where the export file will be saved and what its name will be. Enter the path and name of the export file.

    Table Name

    • Microsoft Excel

    • Microsoft Access

    • Microsoft Power BI

    • IBM Cognos Analytics

    • SAS Transport File Format (XPORT) Version 5

    • Altair Panopticon

    This setting specifies the table name data will be exported to. Enter the name of the table to which data will be exported.

    Show Tables

    • Microsoft Excel

    • Microsoft Access

    • Panopticon

    When exporting a table to a file that already exists, this setting allows you to see the destination file’s existing tables and columns and select the table to which the data should be appended or overwritten. When a table from the Show Tables dialog is selected and confirmed, the name of the selected table is inserted into the Table Name textbox and the current content of this box is overwritten.

    The tables displayed in the Show Tables dialog may be sorted by name by clicking on the sort icon in the header. The tables have an expander button that allows you to view a list of columns belonging to that table.

     

    Filter

    All

    This setting specifies what filter to apply to the table when it is exported.

    When All Filters is selected as a filter option, you will be asked to specify your desired Automatic Naming setting:

    • by Files: produces a file for each filter

    • by Tables: produces a table for each filter

     

    Sort

    All

    This setting specifies what sort to apply to the table when it is exported.

    When File Exists

    • Microsoft Excel

    • Microsoft Access

    • CSV

    • JSON

    • SAS Transport File Format (XPORT) Version 5

    • Altair Knowledge Studio

    • Tableau TDE

    • Tableau Server

    • Qlik

    • Altair Panopticon

    This setting specifies what Data Prep Studio should do if a file with the same name exists in the folder you specified in the Export As field. Select an action if the export file already exists:

    • Overwrite the file

    • Append records to the existing file

    • Skip the export operation

     

    NOTE: Exports to Microsoft Power BI and IBM Cognos Analytics do not support appends to existing tables.

    When Table Exists

    • Microsoft Excel

    • Microsoft Access

    • Microsoft Power BI

    • IBM Cognos Analytics

    • Altair Panopticon

    This setting specifies what Data Prep Studio should do if a table or sheet with the same name you specified exists in the file you indicated in the Export As field. Select an action if the export table already exists:

    • Overwrite the table.

    • Append records to the existing table

    • Skip the export operation.

    Include Column Headers

    • Microsoft Excel

    • CSV

    • Altair Panopticon

    Checking this setting instructs Data Prep Studio to include the column header in the export file. This header will become the first line in the export file.

    Delimiter

    • CSV

    This setting specifies data delimiter for CSV files. Select a delimiter from the drop-down. The delimiter will be used to separate column values.

    Text Qualifier

    • CSV

    This setting specifies a text qualifier for CSV files. Select a text qualifier  from the drop-down. The text qualifier tells you where text values begin and end. This is useful when you have text values that may contain the delimiter character you selected above.

    Encoding Type

    • CSV

     

    This setting specifies which encoding type to apply to the CSV file. At present, the encoding types Code Page, UTF-8, UTF-16LE, and UTF-16BE are accepted.

    Code Page

    • CSV

     

    When the encoding type selected is Code Page, this setting specifies which code page to apply to the CSV file.

    Export All / Limited Rows

    All

    This setting specifies whether your defined row limit should be respected when exporting tables. Tick the appropriate checkbox to instruct Data Prep Studio to export all rows or only those rows that fall within the limit you have set.

     

  5. If you wish to export other tables, set them up by repeating Steps 2 to 4.

  6. If you wish to limit the exports displayed in the Export Management panel to only those created from specific selected tables, tick the Only show exports from selected tables box located at the top of the table selector.

  7. In the Export Management panel, tick the boxes of the tables you wish to export and then click Export Checked when you are finished.

    If you wish to export all of the tables in the panel, click the Export All button instead. There is no need to select individual tables in this case.

If you wish to export a newly defined table, click Export at the bottom of the Export Properties panel after specifying export details.

Setting up quick exports

Steps:

  1. In the Prepare window, click on the drop-down arrow located to the right of a table you wish to export to display its context menu and then select Export Table from the options that display.

    Alternatively, you can select this table in the Export window, right-click on your mouse and then select Export Table.

     

    The Select an Export Type dialog displays.

     

  2. Choose a file type to which your table should be exported.

    Doing so displays an Export Properties dialog.

     

  3. Modify the properties of your export using the table provided above as a guide and then click OK when you are finished.

Tracking export results

The export results display in a panel located to the right of the Export window. Although hidden by default, this panel is automatically launched when an export operation is completed.

 

You can erase all export results from this panel by clicking on the Clear Export Results button located at the top right-hand corner of the panel.

Canceling export operations

You can cancel an export operation from the Export Results panel provided that the operation has not yet been completed.

 

Click the Cancel button provided to cancel a non-completed export operation.

Viewing export results

To view the exported file, click on the export link provided in the Export Results panel. A file browser pointing to the location of the exported file displays.

 

Notes: Appending to .qvx Files

  • The export columns are matched to the existing columns in the file based on the column name and the type of data

  • For numeric columns, the existing file’s decimal precision is used

  • If no columns were matched, the export aborts and informs the user in the export results.

  • If some, but not all, columns were matched the export result includes a line indicating how many columns were matched (i.e. "8 of the 10 export columns were matched and appended to the file.")

  • If all columns are matched successfully, no additional information is added to the export results.

Note: Exporting .qvx changes:

  • When creating the numeric columns for the file, the decimal precision is obtained from the column’s format.

    • If the information can be obtained from the column's format, the .qvx file’s column is set to the correct precision

    • Otherwise, no formatting is specified for the column. This tells QlikView/QlikSense to display the information as it thinks best.

 

Related links