Extensions

Manage custom extensions to the Management Dashboard.

Use the Extensions section to manage your custom extensions to Emporix system. For example, if you have your custom module for the Emporix Management Dashboard, you can manage the connection here.

Hosting

Emporix provides you with the possibility to host the custom extensions within the Emporix infrastructure. Emporix hosting is a secure, and scalable way to store your custom components. To have the service enabled on your tenant, contact the Sales Team.

Learn more in Extension and Cloud Function Hosting.

Adding an extension

You can add your extension by providing a URL to a remote module JS file. The extension is built from the components.

This video demostrates adding an extension to MD.

Prerequisites

Build and configure your extension to be able to display it in the Emporix Management Dashboard.

• Fork the repository and follow the installation steps described in the README file.

For more information and intructions on preparing the extension, see the Enabling Custom Extensions documentation.

When your extension is ready to use, add it to the Management Dashboard.

Adding an extension to MD

To add an extension as a module, follow these steps:

1

Open Extensions

Go to Administration -> Extensions and choose Add extension.

2

Name the extension

Provide your extension's name as you want it to be displayed in the navigation menu.

3

Provide module URL

Add the URL to the remoteEntry.js (or relevant js module file).

Make sure the name of the js file is consistent with its reference in the vite.config.ts file of the custom extension module.

4

Set package name

Optionally, you can provide the custom package name. By default, the package name is generated automatically from the extension's name.

5

Save the extension

Save your extension.

The added extension is connected and you can also see it embedded in the Extensions module.

Removing an extension

1

Locate the extension

In Administration -> Extensions, find the extension to be deleted on the list.

2

Delete the extension

Choose the Delete icon.

The connection gets removed and the extension is no longer available under the Extensions module.

Sample extensions

Emporix exposes more sample extensions that are available for public reuse. Refer to the MD Extensions repository.