Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The Export Exports module allows accessing the data that is stored in Antavo’s database. Backoffice administrators can generate reports to get an overall view of the data of customers, coupons, or stores – among others – tailored to their current needs. When creating the export file, the module configuration interface provides options to add data fields and apply filters.

...

Find the configuration page by opening the Modules (blue star) menu and searching for the ‘Export’ ‘Exports’ module in the list. The page opens up to a list of previously created exports with the following information:

...

  • Name
    Name of the export.

  • Created at
    The date when the export was requested.

  • Created by
    The Backoffice user who created the export linked to their profile page.

  • Model
    This refers to the type of data that the export contains.

  • Target
    File transfer option selected when the export was created (FTP, FTP over SSL, or SFTP). If no target is defined, the export file is only accessible through the Backoffice.

  • Status

    Anchor
    status
    status

    The system works with the following statuses:

    • Pending – the setup of the export is saved, but the export process has not started yet

    • Processing – the export process is in progress

    • Finished – the export process has finished, and the export is ready for download

    • Failed – the export process has failed
      Please contact the Antavo Service Desk for further information if the issue persists.

    • Active - the export configured with repeated scheduling will trigger an export on the next scheduled time

    • Inactive - the export configured with repeated scheduling will not trigger an export on the next scheduled time

  • Filesize
    The size of the export file in bytes.

...

  • From
    The ‘From’ value is automatically populated from the ID of the field selected and cannot be modified.

  • To
    The name of the field in the column header of the export file.
    If no ‘To’ value is added, the export will add the field to the header with the same name as it is in Antavo.

  • Default
    This value will be added to data cells where the field value of the individual entity is empty.

  • Replace values
    You can decide to overwrite certain data values that are stored in the database with a new value in the export file (eg. replace all ‘female’ values in the Gender customer field with ‘ladies' or replace ‘14’ values in the Age customer field with ‘underage’).
    Use the ‘Value to replace’ and ‘New value’ fields to define which value should be replaced and the target value added to the export.
    To map more than one value, click the ‘Add new field’ button.

  • Aggregation
    This mandatory setting is available if the ‘Aggregation’ option has been enabled in the previous step.
    Please note that computed fields cannot be aggregated. If you’re unsure if the field is a computed field, check the editor interface of the field (Events, Customers) or consult the Antavo Service Desk.
    Use the dropdown field to select one of the available aggregation methods:

    • Group
      At least one field has to be marked as ‘group’, which defines the field that will serve as the base of aggregation. Please note the ‘group’ option cannot be selected for identifier fields (eg. if the customer ID is added, the data in the export will be aggregated per each individual customer).

    • Count
      Use this option to retrieve the number of individual entries in the report. This method counts the number of entries, not the fields.
      Please make sure you add only one field with ‘count’ aggregation option.

    • Sum
      Use this option to retrieve the accumulated number of all numeric values of the data fields.
      Please note that this aggregation type is not applicable to non-numeric fields.

    • Average
      Use this option to retrieve the average value calculated from all the values of the items in the report.
      Please note that this aggregation type is not applicable to non-numeric fields.

    • Min
      Use this option to retrieve the lowest value of all the attribute values in the report.
      The Min value of string-type fields is calculated based on alphabetical order. If there’s an empty field, it is always considered the Min aggregated value.

    • Max
      Use this option to retrieve the highest value of all the attributes value in the report.

...

    • The Max value of string-type fields is calculated based on alphabetical order.

File extensions

You can select between .csv and .psv file extensions.

...

  • On-date
    The export will start on a predefined date and time.
    It is possible to enter the date and time schedule manually, but you can also use the date and time selectors by clicking the (blue star) and (blue star) icons.

  • Repeated
    Select this option to set the data export to be triggered periodically. Each time the new export will be added to the list on the Exports page.

    • Daily
      Set the time of the day when the export should be created.

    • Weekly
      Select the day(s) of the week and set the time of the day.

    • Monthly
      Select the day(s) of the month and set the time of the day.
      You can use the ‘Last’ value to make sure the export is started on the last day of the month, regardless of the number of days in a given month.

Info

Scheduling of previously configured exports may be modifiable after being created, please find detailed information below.

Upload target

You have the option to download the export file from the Backoffice or to select a transfer option to get the file uploaded to a server directly.

...

Don’t forget to click ‘Create after setting each required field to start the export process. Also, you are automatically navigated to the View tab after clicking the ‘Create’ button when adding a new export.

Fields

HOL VAN The list of exportable fields varies for each data model. The following table provides the name of each field, along with its data type, possible values, whether it is mandatory, and a brief description.

...

Export

...

details

On the Export module page, you can find the list of previously created exports. By clicking the 'Details” button next to any export item, you can follow up with your exports and manage them under the subtabs of the page.

...

View

The View tab opens up first after clicking the ‘Details’ button on the export listing page.

Status

You can track the status of the export which is visible in the upper right corner. You can reach this page anytime from the Exports list by clicking the ‘Details’ button of the export.find the descriptions of statuses here.

...

Fields

The ‘Fields' section of the View tab displays the fields included in the export with the ‘From’, ‘To’, 'Default’ (if any) values of the fields.

...

Download

...

one-time export files

Note

File download is only available if you have selected the download option ('None') under the Upload target section of the configuration page

...

.

Non-scheduled and On-date scheduled export can be downloaded when the status of the export changes to ‘Finished’.
The ‘Download’hyperlink appears on the View tab under the summary of the export criteria. Click this link to download the compressed file to your device. You will

When the export process has finished, the user who created the export will also receive an automatic email as well with the link to download the export file.

...

Clone an export

Cloning allows repeating an existing export without having to create a new configuration from scratch. This feature is helpful for comparing the latest results with the data of a previous export to identify differences.

  • Navigate to the Exports page to open the list of exports

  • Click the ‘Details’ button of the export that you wish to clone

  • Click the 'CloneClick the ‘Clone' button in the upper right corner
    You’ll be directed to the export configuration page automatically.

  • Modify any setting of the export as necessary.

  • Click the ‘Create’ button to start the new export process

The new export will be created as a new item on the Exports list.

View file
nameInvalid file id - 1994c876-3a5b-4bce-94cf-da45eab2f292

Log

A Logs tab is automatically added to the Export page of exports created with ‘Repeated’ scheduling, which lists all the runnings of the configured export with the following information:

  • Created at
    The date when the export started running.

  • Status

    • Processing – the export process


    If necessary, you can modify any setting of the export before clicking ‘Create’
    • is in progress

    • Success – the export process has finished, and the export is ready for download or has been uploaded to a server

    • Failed – the export process has failed
      Please contact the Antavo Service Desk for further information if the issue persists.

  • Filesize
    The size of the export file in bytes.

  • Error
    The reason why the export process failed (if any).

...

Download repeated export

Note

File download is only available if you have selected the download option ('None') under the Upload target section of the configuration page.

Export files with repeated scheduling can be downloaded from the Log page when the status of the export changes to ‘success’. Use the ‘Download’ button that appears in each row to download the compressed file to your device.

Each time a scheduled export process has finished, the user who created the export will also receive an automatic email with the link to download the export file.

...

Change export schedule

The scheduling of previously created scheduled exports can be updated through the Export page by following these steps:

  • Navigate to the Exports module page

  • Click the ‘Details’ button in the corresponding row

  • Navigate to the Change Schedule tab

  • Modify scheduling settings as needed
    Switching between On-date and Repeated schedule types is not possible.

  • Click ‘Update’ to save your changes

...

Note

Please note that changing schedule settings is not applicable to On-date scheduled exports that have already run their courses.

Sorting and searching for exports

Use the search bar on the top of the Exports module page to search for specific files in your brand’s export history.

...