Checking catalogue export statuses

Open the menu Data » Catalogue export status to check the status of catalogue exports of the last 4 weeks.

This page is new and we always want to improve. Couldn’t find what you are looking for or do you think something could be explained better? Then let us know by using the feedback function at the bottom of this page. The more details you provide, the easier it is for us to improve this page.

1. Getting to know the status overview

You are in the menu Data » Catalogue export status. When you open the menu, a list of all exports is shown. This list is updated automatically every 20 seconds.

Table 1. Columns of the overview

Column

Explanation

Export ID

The ID of the export

Type

What type of export is it?

  • Preview = The export creates a preview of the first five records of the catalogue.

  • Direct = The export is processed immediately.

  • Async = The export is split into jobs. These jobs are enqueued.

  • Live = The export was started as a live download. The file is downloaded to your computer automatically.

  • Dev cache = A cached version of the catalogue is exported. The cache is updated every 20 minutes.
    Tip: Exports of the type Dev cache are not shown in the overview list automatically. However, you can filter by this type to show these exports.

Catalogue name

The name of the catalogue

Template

The template

Condition

  • Started = The export has started.

  • In queue = The export has been enqueued.

  • Processed = The export has been processed.

  • Finalized = The export has been finalized.

  • Completed = The export has been completed.

Progress

Shows the progress of the export. If the export is still running, the number of jobs already processed is shown.
Important: Exports of the types Direct and Debug are carried out immediately. No progress bar is shown for these exports.

What is a job?

When exports of the type Async are started, the data to be exported is split into packages. Each package contains 500 lines. The last package may contain fewer lines. Each of these packages is a job. Each of these jobs is enqueued.

Example: An export contains 2,300 lines. The export is split into 5 jobs: 4 jobs with 500 lines each and one job with 300 lines. The progress bar shows how many of these 5 jobs have already been exported.

Error

How many error occurred during the export?
Tip: Click on the export to see details.

Successful jobs

How many jobs of the export were completed successfully?

What is a job?

When exports of the type Async are started, the data to be exported is split into packages. Each package contains 500 lines. The last package may contain fewer lines. Each of these packages is a job. Each of these jobs is enqueued.

Example: An export contains 2,300 lines. The export is split into 5 jobs: 4 jobs with 500 lines each and one job with 300 lines. The progress bar shows how many of these 5 jobs have already been exported.

Initiator

How was the export started?

  • User = The export was started by a user. Point your mouse at the name of the user to also show the user ID.

  • Cron = The export was automatically started by a cron. Point your mouse at the word "cron" to show which cron started the export.

    • 20 = Export runs every 20 minutes.

    • 60 = Export runs once per hour.

    • 1440 = Export runs once daily.

  • Debug = The export has started for debugging purposes.

What is a cron?

A cron is used to run processes based on a schedule. These are run in individual cron jobs.

So cron jobs are recurring tasks (jobs) that start automatically in set intervals. These intervals are usually specified in minutes. So for example, a "cron 60" runs every 60 minutes.

Example: Item data is exported to a market once per day. To do that, a "cron 1440" is used. Each export is its own cron job.

Fun fact: Cron stands for "Command Run On Notice". However, the term also alludes to Chronos, the Greek god of time.

Why you need to know what a cron is? Well, actually you don’t need to know that at all. All you do is activate the data exchange in PlentyONE. The rest happens automatically. Awesome, right?

Start time

When was the export started?

State last changed

When did the state of the export last change?

2. Filtering the list of exports

By default, all exports except those of the type Dev cache are shown. You can reduce the number of exports shown by using filters.

  • search = Starts a new search.

  • tune = Shows the filters.

Which filters are available?

Export ID

Reduces the list to the export with this ID.

Type

Reduces the list to exports of this type.

  • Preview = The export creates a preview of the first five records of the catalogue.

  • Direct = The export is processed immediately.

  • Async = The export is split into jobs. These jobs are enqueued.

  • Live = The export was started as a live download. The file is downloaded to your computer automatically.

  • Dev cache = A cached version of the catalogue is exported. The cache is updated every 20 minutes.
    Tip: Exports of the type Dev cache are not shown in the overview list automatically. However, you can filter by this type to show these exports.

Catalogue ID

Reduces the list to the catalogue with this ID.

Condition

Reduces the list to catalogues in this state.

Initiator

Reduces the list to exports that were started in this way.

Initiator ID

Reduces the list to exports that were started by this person.
Tip: This filter is only available when the filter Initiator is set to User.

Has errors

Reduces the list to exports that either have or do not have errors.

Started from

Reduces the list to exports that were started on or after this date.
You can view the status of exports of the last 4 weeks.

Started to

Reduces the list to exports that were started up to this date.
You can view the status of exports of the last 4 weeks.

State last changed from

Reduces the list to exports with state changes since this date.
You can view the status of exports of the last 4 weeks.

State last changed to

Reduces the list to exports with state changes up to this date.
You can view the status of exports of the last 4 weeks.

3. Details view

Click on an export to see details about the export process.

Table 2. Details view of export
Setting Explanation

Progress logs
(playlist_play)

Click to show the logs. The list of logs is shown on the left. Click on one of the logs to show more details about the progress.

Performance logs
(bar_chart)

This setting is still without function. Stay tuned.

Data
(library_books)
(only available after export is completed)

Click to show the data that was exported. The data is shown in JSON format.
Important: Due to the data volume and complexity, the data cannot be shown as a table.

Download public export
(file_download)

Note: Use this download if you use a public link. You can change the settings for public links in the Download settings of the catalogue.
Note: The download button is only available for Async exports.

  1. Click on Download public export (file_download).
    → The export starts.
    Important: The export runs in the background. Note that there will be no window for downloading the file straight away. Even exporting small amounts of data will take around 30 minutes.
    → Once the export is finished, you will be notified (notifications_none) that the export file can be downloaded.

  2. In the notification centre, click on link Download.
    Tip: The notification is no longer shown? You can always access the file using the URL shown in the Download settings.

  3. Save the file on your computer.

Details

This lists detailed information about the export. This information is updated automatically every 20 seconds.

Error

A list of errors. This information is not updated automatically. So click on refresh to manually update the information if necessary.