Module ProductExpiryIO

From Dolibarr ERP CRM Wiki
Jump to navigation Jump to search

Module ProductExpiryIO

ProductExpiryIO 3.20.0 - Product Expiry Import/Export Module for Dolibarr

Introduction

ProductExpiryIO is an external Dolibarr module designed to simplify and secure the bulk management of important product configuration fields through CSV export and import.

Instead of editing products one by one, administrators can export product settings to CSV, modify them in Excel or LibreOffice, validate the proposed changes in simulation mode and then perform the real import.

The module provides automatic backups, restore, simulation reports, import history, administrative audit and log archives.

Version 3.20.0 is the stable release validated on Dolibarr 23.0.4 with both desktop and mobile interfaces.

Main features

  • Export product configuration to CSV
  • Import products using the Dolibarr product reference/code
  • Download a ready-to-use CSV template
  • Simulation mode before modifying product data
  • Detailed preview of detected changes
  • Current value / proposed new value comparison
  • Downloadable simulation report CSV
  • Automatic backup before every real import
  • Automatic backup before every restore
  • Restore product values from previous backups
  • Download and delete backup files
  • Import history and administrative audit log
  • Archive the import log before deletion
  • Download and manage archived logs
  • Simulation report management
  • Separate user permissions
  • Dolibarr menu and dashboard integration
  • Responsive desktop, tablet and mobile interface
  • English and Romanian interface

Import and simulation workflow

ProductExpiryIO provides a safe workflow for bulk product updates:

  1. Export products to CSV.
  2. Edit the CSV file in Excel, LibreOffice or another compatible application.
  3. Upload the modified CSV file.
  4. Run the import in Simulation mode.
  5. Review all detected changes.
  6. Download the simulation report if required.
  7. Run the real import.
  8. ProductExpiryIO automatically creates a backup before modifying the products.
  9. Review the import result and audit history.
ProductExpiryIO CSV import and simulation mode

During simulation, the database is not modified.

The module displays:

  • Products processed
  • Products that would be updated
  • Products not found by code
  • Validation errors
  • Field being changed
  • Current value
  • Proposed new value

When changes are detected, a CSV simulation report is automatically generated and can be downloaded from the module.

Supported product fields

ProductExpiryIO supports bulk management of the following Dolibarr product fields:

Field Description
Code Dolibarr product reference/code
Label Product label
Sell Product available for sale
Buy Product available for purchase
BatchMode Batch or serial number management
MandatoryExpiry Mandatory sell-by / use-by date configuration
StockManagement Product managed in stock
Warehouse Default warehouse
Nature Product nature

CSV columns

The friendly CSV format generated by ProductExpiryIO uses the following columns: 

Code;Label;Sell;Buy;BatchMode;MandatoryExpiry;StockManagement;Warehouse;Nature

Accepted values

Field Accepted values
Sell / Buy / StockManagement Yes / No or 1 / 0
BatchMode No / Batch / Serial or 0 / 1 / 2
MandatoryExpiry None / SellByDate / ExpiryDate / Both or 0 / 1 / 2 / 3
Warehouse Dolibarr warehouse code. Empty value means no default warehouse.
Nature Product nature must exist and be active in the Dolibarr product nature dictionary.

Product nature values are validated against the active Dolibarr dictionary instead of writing arbitrary values directly to the product record.

Automatic backups and restore

Before every real import, ProductExpiryIO automatically creates a CSV backup containing the previous product values.

Backups can be:

  • Downloaded
  • Restored
  • Deleted
  • Cleaned according to their age

Before restoring an older backup, ProductExpiryIO automatically creates a new safety backup containing the current values.

This allows the administrator to recover the state that existed immediately before the restore operation.

ProductExpiryIO automatic backups and safe restore

The restore operation reports:

  • Products processed
  • Products updated
  • Products not found
  • Errors

Backup restores are also recorded in the import audit log.

Import log and administrative audit

ProductExpiryIO maintains a history of important operations.

The log records:

  • Simulations
  • Real imports
  • Backup restores
  • Administrative actions

Each entry contains information such as:

  • Date and time
  • Dolibarr user
  • Operation mode
  • Import or backup file
  • Products processed
  • Products updated
  • Products that would be updated
  • Products not found
  • Errors
  • Backup or additional details

The import log can be downloaded as CSV.

Before deleting the active import log, ProductExpiryIO automatically creates an archive file.

Archived logs can later be downloaded or deleted from the Log archives page.

ProductExpiryIO import audit trail and log archives

Simulation reports

When a simulation detects changes, ProductExpiryIO can automatically create a CSV report.

Simulation reports show the proposed changes before any database modification is made.

Reports can be:

  • Downloaded
  • Deleted individually
  • Deleted according to age
  • Deleted in bulk

This provides an additional review step before applying large product updates.

Responsive desktop and mobile interface

ProductExpiryIO 3.20.0 includes a responsive interface designed for desktop, tablet and mobile use.

Desktop pages use contained horizontal scrolling for wide registers so the Dolibarr page itself is not expanded.

On mobile devices, wide tables such as backups, logs and report registers are transformed into readable cards.

ProductExpiryIO responsive desktop and mobile interface

Responsive pages include:

  • Product import
  • Accepted CSV values
  • Import backups
  • Import log
  • Simulation reports
  • Log archives

Safety and data protection

ProductExpiryIO is designed to reduce the risks associated with bulk product configuration changes.

Important safeguards include:

  • Simulation before import
  • No database modification during simulation
  • Automatic backup before real import
  • Automatic backup before restore
  • Validation of supported values
  • Product lookup by reference/code
  • Audit history
  • Simulation reports
  • Log archives

Product updates use Dolibarr product logic instead of direct bulk SQL modification of product settings.

Permissions

ProductExpiryIO uses separate permissions:

Permission Purpose
View Product Expiry IO Access the module dashboard and export functions
Import products Product Expiry IO Run imports, simulations and manage simulation reports
Manage backups and logs Product Expiry IO Manage backups, restores, import logs, archives and administrative actions

Administrators can assign the permissions through the standard Dolibarr user/group permission system.

Installation

ProductExpiryIO can be installed using the standard Dolibarr external module deployment system.

  1. Download the ProductExpiryIO ZIP package from DoliStore.
  2. In Dolibarr go to Home → Setup → Modules/Applications.
  3. Open Deploy/Install external app/module.
  4. Upload the ProductExpiryIO ZIP file.
  5. Enable ProductExpiryIO.
  6. Assign the required permissions to users or groups.

The ZIP package contains the required root directory: 

productexpiryio/

Upgrade

To upgrade an existing ProductExpiryIO installation:

  1. Download the new ZIP package.
  2. Upload it through Deploy/Install external app/module.
  3. Replace the previous module files when requested.
  4. Return to the Modules/Applications page.
  5. Verify that ProductExpiryIO is enabled.
  6. Open the module pages and confirm the displayed version.

Normal module upgrades preserve existing ProductExpiryIO backups, reports and logs.

Compatibility

Item Value
Dolibarr V23
Validated Dolibarr version 23.0.4
PHP 7.4+
Database MariaDB / MySQL
ProductExpiryIO 3.20.0 Stable
License GPL-3.0-or-later
Interface languages English, Romanian

Version 3.20.0 Stable

ProductExpiryIO 3.20.0 consolidates the complete import/export workflow after functional and responsive-interface testing.

Validated workflows include:

  • Module installation and activation
  • Access from Dolibarr menu
  • Access from module dashboard
  • CSV export
  • CSV template
  • CSV import
  • Simulation without database modification
  • Detected changes preview
  • Simulation report generation
  • Real product update
  • Automatic pre-import backup
  • Backup download
  • Backup restore
  • Automatic pre-restore safety backup
  • Import logging
  • Administrative audit
  • Import log archiving
  • Log archive download
  • Desktop interface
  • Mobile interface
  • Upgrade to 3.20.0 on Dolibarr 23.0.4

DoliStore

ProductExpiryIO is available on DoliStore:

ProductExpiryIO - Product Expiry Import/Export Module for Dolibarr

Author

Vasile Panciuc

PanciucSoft

Support

Support by email:

support@panciucsoft.com

When requesting support, please include:

  • Dolibarr version
  • PHP version
  • ProductExpiryIO version
  • Screenshot of the issue
  • Steps to reproduce the issue

Website:

panciucsoft.com

Retrieved from "https://wiki.dolibarr.org/index.php?title=Module_ProductExpiryIO&oldid=67191"