Skip to main content

iDempiere Extension Management

🚀 Features​

  • Centralized Registry: Tracks all installed extensions and their current versions.
  • Dependency Resolution: Automatically validates requirements and dependencies before installation.
  • Extension Lifecycle Control: Provides services to install, uninstall, enable and disable dynamically.
  • Metadata Integration: Parses and processes metadata.json and info.md files to provide a rich UI experience for administrators.
  • Secure Downloads: Manages secure retrieval of artifacts from remote repositories and verifies checksums.

📦 Changes​

  • New Metadata Tables:
    • AD_Extension: to store name, id, version and metadata of an extension. This includes external and bundled extensions (differentiated by the bundled flag).
    • AD_ExtensionEntity: to store database entity that belongs to an extension. This is used to disable/enable the corresponding database entities when user disables/enables/uninstalls an extension.
  • New Form:
    • Extension Management: Form to browse and manage extensions from remote extension repository, extensions that have been installed locally and extensions that's bundled with the application.
  • New Window:
    • Extension Registry: Window to view and manage AD_Extension and AD_ExtensionEntity.
  • New Process:
    • Install Extension: Install remote extension.
    • Uninstall Extension: Uninstall locally installed extension.
    • Disable Extension: Disable installed extension.
    • Enable Extension: Enable an extension that have been disabled.
    • Invoke from the Extension Management form or Extension Registry window.
  • System Property: Adds new System Property IDEMPIERE_EXTENSION_REPOSITORY to define default extension repository URLs.
  • Default Extension Repository:
  • Extension Repository Template:

🛠 Usage & Configuration​

  • Configuration:

    1. Configure the Extension Provider URL using the IDEMPIERE_EXTENSION_REPOSITORY System Property to point to a compatible metadata repository.
    2. Access the configured extension repository via the Extension Management form.
    3. View and manage installed extensions at the Extension Registry window.

  • Extension Management Form:

    • Left Pane:
      • Extension Repository: list extensions hosted in the configured extension repository.
      • Installed Extension: list extensions that have been installed locally.
      • Filter text input: filter extensions by name or description. Use tag:{filter text} to filter by tags and category:{filter text} to filter by categories.
    • Right Pane:
      • Toolbar to install, uninstall, enable or disable an extension.
      • Download button to download an extension as an archive with .idext extension.
      • Registry button to open the corresponding extension record in the Extension Registry window.
      • Content area to display the details and change log (if available) of the selected extension.
      • The content area includes a right sidebar to show some metadata of the selected extension.

  • Extension Form: Browse Available Extensions Extension Form: Browse Available Extensions

  • Extension Form: Browse Installed Bundled Extensions Extension Form:Browse Installed Bundled Extension

  • Extension Form: Browse Installed External Extensions Extension Form:Browse Installed External Extension

  • Extension Registry Window:

    • View and manage installed extension.
    • Header: Installed extension details (AD_Extension) .
    • Detail: Database entities that are managed by an extension (AD_ExtensionEntity).
    • Gear Dropdown: list of actions that can be applied to an extension (install, uninstall, disable or enable).

  • Extension Registry Window: Bundled Extension Extension Registry: Bundled Extension

  • Extension Registry: External Extension Extension Registry: External Extension