History is the control panel where you can view the status, progress, and detailed results of every executed or scheduled job. From here you can also manage recurrence, cancel active jobs, and delete history records.
1) Available filters
The filter bar at the top narrows the list immediately. Any change to a filter automatically reloads the list.
🗂 Category
- All (default)
- Imports
- Exports
🚦 Status
- Completed
- Running
- Scheduled
- Queued · Waiting
- Failed · Cancelled
🔄 Recurrence
- All
- One-time (no repeat)
- Recurring (periodic schedule)
📋 Limit
Number of results: last 20, 50 (default), or 100.
2) Table columns
Each row represents a job and contains:
| Column |
Description |
| Category | Import or Export |
| Type | Module (Products, Orders, Google Feed, etc.) |
| File | Name of the uploaded or generated file |
| Status | Current status with colour badge |
| Progress | Percentage bar + rows created / errors |
| Scheduled | Scheduled date/time + "Recurring" badge |
| Estimated start | Estimated start time according to the queue |
| Date | Record creation date |
| Actions | "View" button to open job details |
3) Possible statuses
- Completed – finished successfully
- Running – executing right now
- Scheduled – waiting for its scheduled time
- Queued – waiting for its turn
- Waiting – resources unavailable
- Failed – finished with error
- Cancelled – manually cancelled
Tip:
"Queued" and "Waiting" are transient states: the job will start automatically when the scheduler has available resources. No action is required.
4) File storage (ZIP)
Import and export files are automatically stored in the database, compressed in ZIP format to minimise space and ensure portability.
📥 Imports
The uploaded CSV or Excel file (or one downloaded from a URL) is saved automatically and is available for download in the job detail view.
📤 Exports
The generated file (CSV, TXT, etc.) is also stored and downloadable from the history.
What happens when you download?
When you click "Download file" in the detail view, the server extracts the original file from the ZIP and delivers it with its original name and format. You don’t need any special software – you will receive the CSV, Excel, or other format directly.
Retention period
Files are kept for a limited period (typically 7 days). After that they are automatically deleted to free up space. Download files you need before the retention period expires.
5) Job details
Clicking "View" on any row opens a detail panel with all information about the job.
Process statistics
- Total rows processed / created / with errors
- Start and end dates
- Scheduled date and estimated start
- Wait reason (if applicable)
Error log
If there were row-level errors, a detailed list appears with the reason for each failure. This helps you identify which records need correction before re-running the import.
Actions available in the detail view
- ⬇️ Download file: original or generated file
- 🔄 Manage recurrence: view, edit, or disable the periodic schedule
- ❌ Cancel job: available when status is Scheduled, Queued, Waiting, or Running
6) Recurring schedules
Jobs with active recurrence show a "Recurring" badge next to the scheduled date. From the detail view you can see and modify the entire repeat configuration.
Recurrence summary information
- Frequency: Daily or Weekly
- Mode: Fixed times (e.g. 08:00, 14:30) or Every 30 min within a time window (e.g. 09:00–18:00)
- Days of the week (weekly recurrence only)
- Shop time zone
How to edit the recurrence
Only possible when the job status is Scheduled, Queued, or Waiting:
- Open the detail view by clicking "View"
- In the "Recurring schedule" section, set the Frequency (Daily / Weekly)
- Set the Mode (Fixed times or Every 30 min)
- Enter the times or time window
- If weekly, check the days of the week
- Click "Save changes"
Note:
Changes apply to the next pending execution and all subsequent ones. Already-completed executions are not affected.
Disabling recurrence
Click "Disable recurrence" to convert the job to a one-time run. The next scheduled execution (if any) will remain pending but without further repeats. Confirmation is required before the change is applied.
7) Cancelling a job
The "Cancel" button appears at the bottom of the detail panel when the job is in any active state: Scheduled, Queued, Waiting, or Running.
Important:
Cancelling a recurring job stops the current execution but does not remove future scheduled runs. To stop the repetition entirely, disable recurrence before cancelling, or delete the record from the history.
8) Deleting history records
You can delete one or more records at once using the selection checkboxes:
- Check the boxes next to the jobs you want to delete
- Use the header checkbox to select all visible rows
- The "Delete selected" button activates as soon as at least one is selected
- Confirm the action in the confirmation dialog
- The list refreshes automatically after deletion
Warning:
This action cannot be undone. Deleting a record also removes the stored file (ZIP) and any pending recurring schedule linked to that job.
Summary: what History enables
- Filter by category, status, recurrence, and result limit
- Monitor status and progress of imports and exports
- Review statistics and the error log for each run
- Download original and generated files (stored as ZIP)
- View, edit, and disable recurring schedules
- Cancel active jobs (scheduled, queued, or running)
- Delete records individually or in bulk