Version

    Data sources and targets

    Introduction

    Wrangler employs the concept of data sources and data targets to specify the origin and destination of the data in the transformation process. You can find the menus for the data source and data target management in the left-side panel. Before you can start working on your data transformations, it is essential to incorporate your data sources into My Sources. Detailed instructions on how to do this and what the supported source types are can be found in the Data sources section below.

    When you create a new Wrangler job, a CSV data target is automatically generated. However, you can always create or add your own data target in My Targets and then update your job to utilize it. Additional information about data targets can be found in the Data targets section below.

    sources targets

    Data sources

    In CloverDX Wrangler, you can extract data from specific locations known as data sources. These sources can either be file-based, like an uploaded CSV or Excel file, or custom, which are provided by data source connectors accessible from the Data Catalog. Data source connectors retrieve data directly from their configured sources, such as a database or a third-party interface (e.g., Salesforce, HubSpot, or Xero). Data source connectors can be created in CloverDX Designer and are managed by your IT team.

    Data sources that you used in your jobs are all visible in the My Sources screen. Typically, you’ll create the data sources when you start working on a new job, but you can work with sources independently and manage them via the My Sources page.

    My Sources

    My Sources page allows you to view and manage all data sources that you’ve used in your Wrangler workspace. It will show you all your sources - whether they are files you uploaded to Wrangler or data sources created from the Data Catalog.

    My Sources page is accessible directly from Wrangler’s main menu.

    my sources
    Figure 7. A preview of a data source alongside a list of configured sources

    My Sources screen is split into two halves - the left half provides an overview of all the sources you’ve already created while the right half allows you to view details and manage the source you select.

    The list of sources provides basic information for each source:

    • Name is the name of your source.

    • Type to help you determine the type of source. A source can be file-based (CSV or Excel files uploaded to your workspace) or connector-based (created from connectors in your Data Catalog).

    Additional actions are available after clicking on the three-dot menu for each item:

    • Use in a new job opens a wizard to create a new job with the selected data source.

    • Delete removes the selected source. Note that deleting the source will invalidate the jobs that are using it.

    • View in Data Catalog (for data source connectors only) opens the connector page in the Data Catalog .

    When you select a source in the table, the right half of the screen will show you additional details about that source including data preview. It will also allow you to edit its configuration.

    To edit the configuration, click on the Edit button in the Configuration section. This will open a dialog that will allow you to change the parameters of your data source.

    The exact layout of this dialog depends on the source type: you will either get the CSV data source settings dialog or the dialog to configure the data source connector provided by a library similar to one in Add to My Sources wizard.

    Adding data sources to My Sources

    There are several ways to add data sources to My Sources:

    • CSV or Excel files can be uploaded:

      • Directly in My Sources by uploading a CSV or Excel file via the drop area at the top

      • Uploading a CSV or Excel file via the drop area when creating a new job via Create a new job action on the My Jobs page

    • Data source connectors can be added from the Data Catalog:

      • Click the Add to My Sources or Use in a new job buttons

      • Click the Add to My sources or Use in a new job buttons when exploring connector details

    When adding data source connectors, the Add to My sources wizard opens to allow you to configure settings for your data source. The dialog will look different for each data source since it shows the parameters for that specific data source. If a data source settings is updated, a warning will be displayed to remind you to reload preview data to reflect the changes in the data preview.

    add to my sources wizard
    Figure 8. Connector configuration dialog in the Add to My sources wizard
    Updating data source in an existing job

    To update the data source in an existing job, click on the Source button in the overview diagram of your job at the top of the transformation editor screen or click on the cogwheel icon icon which appears when you hover over the Source step.

    You will be redirected to a page listing all your sources added to your My Sources page. Select a new source by performing one of the following:

    1. Double-click on the desired data source.

    2. Select the Use in a new job option from the three-dot menu for the desired data source.

    3. Click on the desired data source in the list and click on the Select button in the right upper corner.

    my sources update source

    After performing one of these steps, you will be asked to confirm the data source change.

    When you change the data source of a job, the data source which was previously used by the job is not changed or deleted. To remove it, select this source and delete it via the three-dot menu.
    Data source connectors

    Wrangler allows you to use custom data source connectors that are created, managed, and maintained by your CloverDX Server administrators. These connectors can read data from various sources, including databases or other external systems, like Hubspot. Connectors published by your company are available in the Data Catalog.

    Adding connectors to My Sources

    If you have sufficient permissions, you can add published data source connectors from the Data Catalog to My Sources and use it as a data source in your job.

    If you cannot find the data source connector you need, contact your CloverDX Server administrator to either grant you access or create a new connector for you. Administrators can consult our Server documentation for more information on how to install and configure data source connectors.

    When adding data source connectors the Add to My Sources wizard opens, where you can configure settings for your data source. The dialog will look different for each data source since it will show the parameters for that specific data source. If a data source setting is updated, a warning is displayed to remind you to Reload preview data to reflect the changes in the data preview.

    add to my sources wizard
    Figure 9. Connector configuration dialog in the Add to My Sources wizard

    If you specify a different connector name when adding a connector from the Data Catalog, you can find the original connector name in the connector detail.

    source connector original name
    CSV data sources

    The CSV data source allows you to read data from CSV files uploaded to your Wrangler workspace.

    When you want to create a new CSV data source, you can do so either from My Sources or directly from the Create a new job screen. In both cases, you can simply upload a file by dragging & dropping it or by selecting the file on your computer.

    upload csv and create new job

    Once a file is uploaded, the CSV connector scans your data and automatically determines the data structure. The algorithm looks at a data sample at the beginning of the file to determine the columns and their data types.

    You can see the preview of your data to verify that the automatically determined file structure matches your expectations. You can read more about data types available in Wrangler in the Data types section.

    my sources csv file preview
    Configuring CSV data source

    If the automatically determined structure of the uploaded file does not match your expectations, you can configure the connector parameters via the Edit action:

    my sources csv file edit settings

    The following options are available in the configuration dialog:

    • Encoding: pick data encoding for your file. Encoding determines how characters are stored in text files and picking incorrect encoding can result in incorrectly read data (for example, some accented letters may show incorrectly). The most common encodings are UTF-8 (universal encoding that can handle any characters), windows-1252 (US English encoding commonly used for files created on Windows), or ISO-8859-1 (US ASCII encoding).

    • Delimiter: allows you to select column delimiter. A column delimiter is a single character that serves as a separator between columns in the file. The most common delimiters are comma (",") and tab. You can also type your delimiter if none of the default delimiters work for you. Setting a correct delimiter ensures that all columns are read from the file as expected.

    • Quoting: determines whether values in your source file are enclosed in quotes or not. You can select from three options - double quotes, single quotes, or N/A (no quotes).

    • First line is a header: tell the CSV connector that it should interpret the first line of the data as a header and read the names of columns from it. If this is unchecked, columns in your data set will have sequentially generated names like field1, field2, and so on.

    Where are my CSV files?

    The files you upload to Wrangler are stored in your workspace. Only you (and your IT administrator) have access to those files. Other Wrangler users cannot see or manipulate the files in your workspace.

    If you have access to CloverDX Server Console, you can find these files via Sandboxes module by browsing to your Wrangler workspace and then into the data-in folder.

    Limitations of the CSV data source

    CSV data source can handle most common data layouts but it does have some limitations. It can handle the following:

    • Files of any size. There is no limit to the total number of rows in your file. Note that by default only the first 1000 rows are shown in the preview. To ensure the whole file is processed, run the job once you are finished building the transformation.

    • Files with any number of columns. While there is no technical limitation to how many columns can your files have, Wrangler implements a soft limit set to 1000 columns by default to help you prevent cases where your browser may not be able to handle displaying too large of a sample. You can change this limit by contacting your CloverDX Server administrators and asking them to increase the value of Wrangler.MAX_NUMBER_OF_COLUMNS property.

    • Files with varying numbers of columns on different rows. Your files do not have to have the same number of columns on each row. However, this feature works correctly only when the header or one of the sample rows is the longest row in the file. For example, the connector will work fine if your header contains 20 columns but some of the rows in your file contain fewer than 20 columns. By default, the connector will read the first 512 kB of your data or the first 1000 rows whichever comes first to determine how many columns your data has. You can work with your CloverDX Server administrators to increase these limits by setting CSVAnalyzer.BYTES_TO_ANALYZE and CSVAnalyzer.LINES_TO_ANALYZE settings (see more here).

    The connector does not support:

    • Files in which the longest row (a row with the largest number of columns) does not appear within the analyzed sample. For example, if you have a file that has a header with 20 columns and much later in the file (after the first 1000 rows) you have a record with more than 20 columns. See above for more details about increasing sampling limits.

    • It does not support files with multiple different types of column delimiters. If you have such a file, you will need to pick one of the delimiters and then split the columns using the other delimiter in your Wrangler job using the Calculate formula step.

    Excel data sources

    The Excel data source allows you to read data from Excel .xlsx or .xls files uploaded to your Wrangler workspace.

    When you want to create a new Excel data source, you can do so either from My Sources or directly from the Create a new job screen. In both cases, you can simply upload a file by dragging & dropping it or by selecting the file on your computer.

    upload excel and create new job

    Once a file is uploaded, the Excel connector will scan data from the first sheet and automatically determine the data structure. The algorithm looks at a sample of data at the beginning of the file to determine the columns and their data types. You can read more about data types available in Wrangler in the Data types section.

    It is possible to read data from one sheet only. If you want to read data from a different sheet than the first sheet, see the configuration section below for more information.

    my sources excel file edit settings
    Configuring Excel data source

    If you want to read data from a different sheet or want to change the data start point, click on the Edit button in the Configuration section to edit the data source configuration.

    my sources excel file configuration
    Figure 10. Configuring Excel data source

    The following options are available in the Configuration dialog:

    • Sheet name: defaults to the first sheet name found in the loaded Excel file. If you want to read data from a different sheet, select it from the list or type it in. You can also use sheet numbers - note that the numbering starts with 0 (i.e., the first sheet number is 0, the second sheet number is 1, etc.).

    • Coordinates of the first data cell: defaults to A1; i.e., the typical first position in Excel files. To change it, type in the desired start cell (e.g., C1).

    • First line is a header: selected by default. When selected, the data in the first row are used as column names. When unchecked, the header names default to column positions (ColumnA, ColumnB, etc.).

    Where are my Excel files?

    The files you upload to Wrangler are stored in your workspace. Only you (and your IT administrator) have access to those files. Other Wrangler users cannot see or manipulate the files in your workspace.

    Limitations of the Excel data source
    • Files of any size. There is no limit to the total number of rows in your file. Note that by default only the first 1000 rows are shown in the preview. To ensure the whole file is processed, run the job once you are finished building the transformation.

    • Files with any number of columns. While there is no technical limitation to how many columns can your files have, Wrangler implements a soft limit set to 1000 columns by default to help you prevent cases where your browser may not be able to handle displaying too large of a sample. You can change this limit by contacting your CloverDX Server administrators and asking them to increase the value of Wrangler.MAX_NUMBER_OF_COLUMNS property.

    • Files with varying numbers of columns on different rows. Your files do not have to have the same number of columns on each row. However, this feature works correctly only when the header or one of the sample rows is the longest row in the file. For example, the connector will work fine if your header contains 20 columns but some of the rows in your file contain fewer than 20 columns. By default, the connector will read the first 1000 rows to determine how many columns your data has. You can work with your CloverDX Server administrators to increase these limits by setting CSVAnalyzer.BYTES_TO_ANALYZE and CSVAnalyzer.LINES_TO_ANALYZE settings (see more here).

    Data targets

    A data target in Wrangler is the destination where your resulting data will be written. A data target can be either a file (CSV or Excel) or you can use data target connectors from your Data Catalog to directly write the data to any external system such as Salesforce, Snowflake, database or any API. Data target connectors are designed, managed, and maintained by your CloverDX Server administrators and IT team.

    When a new job is created, Wrangler automatically generates a CSV target file and assigns it a name based on the job name. However, you can always change the target to a different one (different file or even a completely different target type). To use a different target, you first need to add the data target to My Targets.

    My Targets

    My Targets page allows you to view and manage all data targets that you’ve used in your Wrangler workspace. It will show you all your targets - whether they are files or data targets created from the Data Catalog.

    My Targets page is accessible directly from Wrangler’s main menu.

    my targets
    Figure 11. A preview of a data target alongside a list of configured targets

    The table showing all targets provides basic information for each target:

    • Name is the name of your target.

    • Type to help you determine the type of target. target can be file-based (CSV or Excel) or connector-based (created from data target connectors in the Data Catalog).

    • Actions directly in the table or in three dots menu shown on hover for each item:

      • Use target (white arrow in blue circle) to create a new job from given target,

      • Delete (in the three dots menu) to delete the target. Note that deleting the target will invalidate the jobs that are using that target.

      • View in Data Catalog (in the three dots menu for non-file targets) to open a Data Catalog page with details for the given target.

    When you select a target in the table, the right half of the screen will show you additional details about that target, as well as allow you to edit its configuration.

    To edit the configuration, click on the Edit button in the Configuration section. This will open a dialog that will allow you to change the parameters of your data target. The exact layout of this dialog will depend on the target type:

    Adding data targets to My Targets

    There are several ways to add data targets to My Targets:

    • CSV files or Excel files can be uploaded:

      • Directly in My Targets by uploading a CSV or Excel file after clicking on Create file target

      • When a new job is created, a CSV file target is automatically generated

    • Data target connectors can be added from the Data Catalog:

      • Click the Add to My Targets or Use in a new job buttons

      • Click the Add to My Targets or Use in a new job buttons when exploring connector details

    Updating data target in existing job

    To update the data target in an existing job, click on the Target button in the overview diagram of your job at the top of the transformation editor screen or click on the cogwheel icon icon which appears when you hover over the Target step.

    job diagram
    Figure 12. Job diagram showing main parts of your Wrangler job

    You will be redirected to a page listing all your targets added to your My Targets page. Select a new target by performing one of the following:

    1. Double-click on the new data target.

    2. Select a new target in the list, or hover over it and click on the blue button.

    3. Select a new target in the list and click on the Select ⟶ button.

    After performing one of these steps, you will be asked to confirm the data target change.

    my targets update target
    Target mapping

    Certain data target connectors may require specific data formats, including required columns with defined data types. This is to ensure data integrity and compatibility with the target system. For example, when writing data to a CRM system like Salesforce, person’s name might be required.

    Such data targets will require mapping - a transformation from your data layout to the data layout required by the target. Mapping is always done at the end of the job and is clearly shown in the step list.

    If your selected data target requires mapping, a Mapping step appears above the Target step. The Mapping step allows you to assign columns from your transformations or constant values to columns in the target. The Mapping step displays the number of currently mapped vs. mappable fields, including a note about how many fields are required.

    target mapping required
    Figure 13. Data target with mapping that requires at least 3 columns to be mapped.
    Mapping editor

    To set or edit the mapping, click on the Mapping step (or on the little pencil next to the step). The view will switch to the Mapping mode which will display preview of your data as well as the Mapping editor.

    target mapping detail
    Figure 14. Mapping editor

    In the Mapping editor you can link your dataset preview columns to specific data target connector columns or define constant values to be used. The target columns are listed on the right side, and the mapping is performed on the left side in the Preview column section. You can easily tell which columns are required: required columns are highlighted to distinguish them from optional columns.

    Only columns or constants with compatible data types can be successfully mapped. In some cases, the data types may be automatically adjusted to match the target format. It is recommended to use the Data target preview to ensure the adjustments are as expected. See Data type compatibility for more information.

    Your mapping changes are saved automatically - you will see a little status notification about this at the top of the mapping editor.

    You can use the Search mapping feature in the mapping editor to display just the columns that contain your search term in their name. The search returns results from both the Preview and Target columns.

    You can also use advanced search by clicking on the funnel icon on the right side to filter based on the mapping status (Required, Optional, Unmapped, Mapped, With error). The text under the Search mapping field will keep you informed about how many columns out of the total number of columns are currently displayed.

    target mapping search
    Figure 15. Searching in the Mapping editor.

    The Mapping editor keeps track of all the mapped, unmapped, required, and optional fields, as well as the number of errors. It also automatically adjusts the numbers when you make a change. The Mapping step displays the overview as well.

    target mapping step
    Figure 16. Step with mapping details showing a mapping with a single "type mismatch" error.
    Mapping of columns

    To map a column, use one the following options:

    1. Drag and drop a column header from the data preview onto the left Preview column placeholder in the mapping editor. It is possible to map one column from the data preview to multiple target columns.

    2. You can use the Automap feature. This functionality offers automated column mapping based on name and data type similarity. It attempts to match source data preview columns with their corresponding target system columns, matching source columns to target columns based on column names and data types.

      Note that automapping is applied to visible columns only. If you used the Search option above the data preview or if you filtered columns in the Mapping editor, only the columns visible in both parts of the screen will be considered during automapping.

    3. Use the Edit (pencil) button that appears when you hover over a preview column to open the Mapping window. Select the desired column from the list and save your changes.

    You can freely combine these three options for maximum effectivity.

    Ensure the data type of the preview column matches the target column’s data type. For more information, see Data type compatibility.
    target mapping
    Figure 17. Mapping target columns
    Mapping of constants

    If you want to assign a constant value to a target column, perform the following steps:

    1. Hover over the desired preview column.

    2. Click on the pencil icon (Edit) to open the Mapping window.

    3. Switch to the Value tab.

    4. In the text field, enter your desired constant value.

    Ensure the format matches the target column’s data type. A hint about the required data type will be displayed in the field itself. For more information, see Data type compatibility.
    target mapping constant
    Figure 18. Mapping constants
    Data type compatibility

    For successful mapping, ensure two key points:

    1. When mapping columns, the source and target columns need to share the same data type (e.g., integer to integer, string to string). In some cases, Wrangler can automatically convert data types during mapping to enhance flexibility:

      • Integer to String: Integers are automatically converted to strings during mapping.

      • Date to String: Dates are automatically converted to strings during mapping.

      • Decimal to String: Decimals are automatically converted to strings during mapping.

      • Boolean to String: Booleans are automatically converted to strings during mapping.

      • Integer to Decimal: Integers are automatically converted to decimals during mapping.

    2. When assigning constant values to target columns, enter them in the format required by the target’s data type. A hint about the expected format will be displayed within the Mapping editor.

    The target column data type is indicated by an icon next to the column name, and you can also see it in the tooltip which appears when you hover over it. For further details on data types, refer to Data types in Wrangler.

    If the data types do not match, the mapping is considered invalid. If your job includes invalid mapping, the job run will fail. It is recommended to use the Data target preview to check if the mapping is valid and to preview your data before running the job.

    target mapping data types error
    Figure 19. Example of mapping with mismatched data types: Phone number is invalid because the target column is an integer while the mapped column is a string.
    Mapping indicators in data preview

    When a column is mapped, an icon appears above its column name in the Ttransformations editor to indicate that the column is linked to a target column. If the mapping is successful, you will see a blue "link" icon target mapping success icon. If the mapping of this column is invalid (e.g., the data types do not match), you will see an error icon target mapping error icon.

    When you click on any of these icons, the Mapping editor opens.

    target mapping column indicators
    Figure 20. Mapped columns: the Date of birth and Email are ok while the Phone number mapping is invalid as indicated by the red error icon above the header.
    Unmapping columns

    To unmap a column, hover over the desired column in the Preview column section, and click on the X button, or, to quickly unmap all columns, use the Unmap button in the Mapping editor.

    target mapping unmapping
    Figure 21. Unmapping columns
    Data target preview

    Click on the target step to preview your data. This is particularly helpful when using a data target connector as your target. The preview will show you the mapped data with the target column labels, allowing you to verify data integrity and identify any mapping errors before writing the data permanently.

    target mapping all
    Figure 22. Mapping
    target preview
    Figure 23. Target preview

    If your mapping is invalid, the preview will be unavailable.

    target preview invalid
    Downloading and viewing output files

    When files are written by Wrangler, they are stored in your workspace. You can download your files from Wrangler user interface from the My Jobs screen by clicking on the Download result button:

    my jobs downloading outputs
    Figure 24. My Jobs screen showing information about three job runs.
    Reject file format

    Wrangler offers an option to produce a reject file: a file which stores information about rows which contained errors. Reject files can be written in two different formats - a CSV file (for CSV data target) or XLSX file (for Excel data target). In both cases, the information in the file is the same and the only difference is the file format itself. The file provides information about why each row was rejected, including the data in the rejected row at the end of the transformation. For more information see Errors and output.

    reject file example
    Figure 25. Example reject file in Microsoft Excel format

    The reject file contains one row for each rejected row. Since there can be multiple errors in each row, all errors for given row are collected in the single reject file row.

    Besides the error details, the reject file also contains the data that was rejected. The data is all stored as string columns to ensure that invalid values can be written to the reject file as well.

    The reject file contains the following columns:

    • Error message (column A in Excel): full error message describing the errors in current row. If more than one error is present in a row, error messages are concatenated together. This means that the value can be quite long for rows with many errors.

    • Error column (column B): name of the column in which an error occurred. If there are multiple errors in current row, multiple column names are provided as semicolon-separated list.

    • Step (column C): description of a step in which an error that caused the row to be rejected occurred. If multiple errors are present in current row, multiple steps are listed here as semicolon-separated list. Each step is written as Step N: step type where N is the number of the step in the step list (first step is 1) and step type is the "generic" name of the step. Example: Step 15: Validate with formula is 15th step in the job and it is a Validate with formula step.

    • Source row number (column D): row number as it was read from the data source (regardless of the source type). The rows are numbered sequentially starting with 1 when they arrive from the data source. Sorting, filtering or removing rows does not change the Source row number value. This means that at the end of the transformation, the sequence of row numbers may be out of order or have gaps in it depending on transformation steps. The Source row number is useful to tie the data to what came from the source system and can help identify the rows in the source if data fix is required.

    • Data columns (columns starting with E): all columns after Source row number are data columns. Data is in the same layout as in the last step of the transformation. The only difference is that all columns are converted to string before they are written to the reject file. This is to ensure that even invalid values (e.g. with wrong format) can be output to the reject file.

    Data target connectors

    Wrangler allows you to use data target connectors that are created, managed, and maintained by your CloverDX Server administrators. These connectors can be found in the Data Catalog, from where you can choose to add them to My Targets and use them in your jobs.

    For steps on how to add an existing data target connector from the Data catalog to My Targets, refer here.

    These target connectors do not generate an output file; instead, they write data directly to a configured external target within the connector, such as a database or a third-party interface. Depending on the connector’s design, certain target connectors may require mapping your transformed data into the target structure. For further details, refer to the target mapping section.

    If you cannot find the data target connector you need, contact your CloverDX Server administrator to either grant you access or create a new connector for you. Administrators can consult our Server documentation for more information on how to install and configure data source connectors.

    If you specify a different connector name when adding a connector from the Data Catalog, you can find the original connector name in the connector detail.

    target connector original name
    CSV data targets

    CSV data target allows you to write your data into CSV files that are stored in your Wrangler workspace. To change your data target settings, click on the Target button in the overview diagram of your job at the top of the transformation editor screen or click on the cogwheel icon icon which appears when you hover over the Target step.

    job diagram
    Figure 26. Job diagram showing main parts of your Wrangler job
    target csv edit button
    Figure 27. Target step

    A page listing all the targets added to your My Targets will appear. Your currently used target will be automatically selected and its details displayed on the right side. To change the configuration of your CSV file, click on the Edit button next to Configuration.

    To select a different target, select the desired target from the list, click on the Select ⟶ button, and confirm your changes.

    data target edit
    CSV data target configuration

    The following settings are available for CSV data targets:

    csv data target configuration
    Figure 28. CSV data target configuration dialog
    • Target name: name of the output file. Default value is the name of your Wrangler job.

    • Encoding: encoding for the output file. The default (recommended) value is UTF-8, which is a universal encoding that will allow you to save data in any language while making it readable in many other apps. Other common encodings include windows-1252 (US English encoding commonly used for files created on Windows) or ISO-8859-1 (US ASCII encoding). Selecting the wrong encoding here can produce a file in which some characters are not stored correctly.

    • Field delimiter: a single character to use as a separator between columns in the output file. You can either select one of the provided options or type your own character. The most common delimiter is either a comma or a tab.

    • Record delimiter: configures character(s) that are used to separate rows in the output file. The default value is a "Windows new line" which means that each row appears on a separate line in the output file. Select the option based on your target platform - if you are targeting Windows users, use the Windows CRLF option, for Linux or Mac users pick the Linux LF option. You can also type your own delimiter if needed.

    • Quoting: allows you to configure whether values in your file are surrounded by quotes or not. If you enable quotes, the data may look like this (assuming two columns: Name and Age):

      "Name","Age"
      "Alice","22"
      "Bob","23"

      Quoting is needed when your data can contain your delimiter character - e.g., if your delimiter is a comma and your data can contain commas as well. When configuring quoting you can pick which character to use - whether double quotes or single quotes. Double quotes (the default value) are more common and recommended if quoting is needed.

    • Column headers: allows you to configure whether to write a file header or not. If enabled, the file header will be written as the first row of the output and will contain labels of all columns in your data. We recommend enabling the header as that will allow data recipients to know what is in the data.

    • Write mode: determines how your data should be output.

      • Overwrite file content if any: any existing file content is deleted and replaced by the output from the latest job run.

      • Append to file: any existing file content is kept and data from the latest job run is added to the end of the file.

        • The append function is disabled if the number of columns or column data types change and no longer match the existing layout or data types in the target file. In such a case, you will either need to change the target settings and switch to the Overwrite option, or change the target file to a new empty file.

          file append error
          Figure 29. Error when job data layout does not match data layout in target file
    • Error handling: determines what to do with rows that contain errors in any of their cells. Two options are provided:

      • Write rows with errors to reject file (default value): if selected, all rows that contain errors are written to a reject file. The reject file allows you to see the rejected rows as well as information about errors that caused those rows to be rejected (read more here). You can then see the number of rows that were rejected on My Jobs page when job execution ends:

        my jobs rows rejected
      • Fail the job on the first error: when an error is encountered when writing the file, the job is stopped and the error will be reported on My Jobs page:

        my jobs job failed on output
    CSV data target limitations

    CSV target will allow you to work with any size of data - unlimited number of rows or columns.

    Excel data targets

    Excel data target allows you to write your data into Microsoft Excel files in the XLSX format. The target produces a file with one sheet and a header. Formatting of data in the output file will follow the formatting configured for columns in your Wrangler job.

    excel target output
    Figure 30. Sample Excel file create with CloverDX Wrangler
    Excel data target configuration

    Following settings are available for the Excel target:

    excel data target configuration
    Figure 31. Excel data target configuration dialog
    • Target name: name of the output file. The default value is the name of your Wrangler job.

    • Sheet name: name of the sheet to create in the output file. Note that Excel limits the length of the sheet name to 31 characters.

    • Write mode: determines how your data should be output.

      • Overwrite file content if any: any existing file content is deleted and replaced by the output from the latest job run.

      • Append to file: any existing file content is kept and data from the latest job run is added to the end of the file.

        • The append function is disabled if the number of columns or column data types change and no longer match the existing layout or data types in the target file. In such a case, you will either need to change the target settings and switch to the Overwrite option, or change the target file to a new empty file.

          file append error
          Figure 32. Error when job data layout does not match data layout in target file
    • Error handling: determines what to do with rows that contain errors in any of their cells. Two options are provided:

      • Write rows with errors to reject file (default value): if selected, all rows that contain errors are written to a reject file. Reject file allows you to see the rejected rows as well as information about errors that caused those rows to be rejected (read more here). You can then see number of rows that were rejected on My Jobs page when job execution ends:

        my jobs rows rejected
      • Fail the job on the first error: when an error is encountered when writing the file, the job is stopped and the error will be reported on My Jobs page:

        my jobs job failed on output
    Formatting of Excel files

    The formatting of data in Excel output files depends on the formats configured on columns in your data set. Wrangler will set the corresponding Excel format depending on the display format for each column.

    When saving to an Excel file, Wrangler will save the complete value even if the formatting restricts the display of data. This is especially important for numbers which may be stored with higher precision than what is displayed in Wrangler preview.

    For example, consider a value like 3.1415926535 written in Wrangler with decimal format set to #.### (i.e. three decimal places):

    excel target formatting wrangler data

    The column $formatted_constant was created as a duplicate of $constant_value column and then configured to show just three decimal places. The same is then replicated in Excel output in which complete value is stored and the formatting only applies during data display:

    excel target formatting sheet data

    Note that the formats may not always be the same since Excel formatting and Wrangler formatting have slightly different capabilities.

    Excel data target limitations

    Note that some restrictions apply when working with Excel files. Some of the restrictions below are limitations of the Excel file format itself while others are technical limitations of the Excel data target in Wrangler.

    • You cannot write more than 1048576 rows into an Excel file. This is a limitation of the Excel file format. If you need to work with more data, you will need to use CSV data target.

    • You cannot have more than 16384 columns in the output. This is a limitation of Excel file format. Note that this is much higher than the default soft-limit for Wrangler columns - 1000 columns - so you are unlikely to reach this.

    • You can only create a single sheet in the output file using Wrangler.