Extensions Management
Overview
This section explains the Extensions Management function, which allows you to execute customized actions and processes in your Order Management System (OMS).
Extensions Management Functionality
Find the Extensions Management functionality in the System section of your OMS.
This functionality allows you to execute customized actions in your OMS, in the Extensions Management Dashboard.
Find the Available Extensions and Execution Log of the Extension Definitions that your System Integrator (SI) configured previously in this dashboard.
These definitions are previously configured by your SI, and can be enabled in your Configuration Portal, which is not accessible externally yet. Please contact Magento to change this configuration.
Available extensions
In this tab you can see a list of all available extensions for your OMS. Click View more to access the details of the extension. Then, you can see the instructions to run the extension and, if applicable, the list of parameters you need to add in order to identify and execute the extension.
Be aware that fields with are mandatory and you must fill them in.
Once all fields are completed, click Execute Extension to launch it.
Execution log
In the Execution Log tab you can find the history and details of every Extension Definition that you launched:
In this view you can find several values:
Value | Description |
---|---|
Extension Name | Name of the Extension Definition. |
Executed by | User who launched the Extension. |
Execution ID | Unique ID for that execution. |
Execution Start Date | Date when the execution was launched. |
Elapsed Time | Time elapsed since the execution started. |
Status | Status in which you can find each extension launched. |
Execution Log | History of that execution. Click View Details to seee a detailed log of that execution. |
You can filter the results of this dashboard by using the Show filters on top of this view.
Extensions Management Definition
You can find the Extensions Management Definition in the Configuration Portal:
There are two sections in this definition:
Value | Description |
---|---|
Enabled | Enables the functionality in your OMS. |
List of Extensions | Shows the list of the available extensions. |
Enable the Extensions Management Definition
In order to use this functionality there are two requirements:
-
It is necessary to enable the functionality in your Configuration Portal:
Click
when you finished configuring your Extensions Management rule. A confirmation message appears.
In this configuration rule you can see other values like:
Value | Description |
---|---|
View History | Shows the change history of this configuration rule over time. |
Unset ![]() |
Resets the configuration rule to the default value. |
This configuration is available through the configuration portal, which is not accessible externally yet. Please contact Magento to change this configuration.
-
Make sure that your profile has the correct permissions, you can access your SYSTEM section and check Roles:
Here you can set the different functionalities a role has access to. For this case, make sure that the checkbox Extensions in Internal Tools is selected.
List of Available Extensions
As mentioned earlier, besides the possibility to enable the functionality in your OMS, you can see a list of the available extensions that the System Integrator can create for this functionality. You have an extension value by default, which can be filled in and it is ready to use.
In case you would like to add other extensions values, first deselect the default checkbox, and click add a new value. Whenever you would like to remove a value, click .
Each Item (or Extension Definition), has several mandatory values which you have to fill in:
Value | Description |
---|---|
Name | Name of the Extension Definition. |
Title | Title of the Extension Definition. |
Integration Name | Name of the Integration to be registered in the system. |
Description | A description of the Extension Definition. |
Instructions | Instructions of the Extension Definition. |
List of Parameters | An unlimited number of required input information. |
The fields for these values should be strings, and they have a limitation in the characters allowed in their descriptions. For example, the value Description has a limitation of 350 characters.
If you want to use the List of Parameters value, you need to fill some required fields, like the key name of the parameter, or the type where you can you select the type of input:
- shortstring
- longstring
- arrayofshortstring
This value has the same characteristics as the root Extensions Management definition, where you can add more items, or remove them if necessary. You can enable/disable them when a parameter is required.
When you finish setting up the different Extensions Management Definitions, click save rule.