Skip to main content
Matrix42 Self-Service Help Center

How to create a custom storage type

Overview 

Matrix42 File Storage extension supports custom storage types to be integrated into the package. Having installed Matrix42 File Storage extension, there are 3 types of storage provided by default: 

  • MS SQL Server database 
  • Azure Blob 
  • Matrix42 Cloud Storage 

The list above can be extended by creating a new type with its own set of settings required to establish the connection to the new storage. It can have any amount of the fields and related UI controls to manage all the settings in the database.

In the scenario below, we’ll review how to create the type from the scratch and make it available in the storage type list.  

Creating a new storage type 

Assume we are aimed to create a custom storage type named Large Files Storage. For the example, the new storage should have a connection string, schema, and a table name. Thus, while setting up the Large Files Storage, we must enable users to provide these properties. 

Schema: Data Definition

To create a new storage type, follow the next steps: 

  1. Go to Administration application 
  2. Go to SchemaData Definitions 
  3. Click on Add Data Definition (see also Data Definition page for more details)
  4. Provide the internal and display name:
  5. Go to Attributes 
  6. Add the fields listed above with the required data types: connection string, schema, table 
  7. Click on Save and reload the application 

 Schema: Configuration Items 

For the next steps, let’s create a Configuration Item like shown in the example below: 

  1. Go to Administration application 
  2. Go to SchemaConfiguration Items 
  3. Click on Add Configuration Item (see also Configuration Item page for more details)
  4. Provide an internal and display name:
  5. Click on Data Definitions view 
  6. Add File Storage Account Class Custom Entity to the main class type 
  7. Add Large Files Storage to the additional definitions:
  8. Click on Create Configuration Item 
  9. Click on Build User Interface:
  10. Click on Define Objects To Be Created view:
  11. Select Create Dialog and Create Data Query with Large Files Storage Data Definition  
  12. Click on Summary 
  13. Click on New Management Area 

Once the process of a new management area is complete, the related dialog Large File Storage Dialog is created. The layout of the created dialog includes all the fileds we have created for the Data Definition. If additional customization is needed for the layout, it can be easily modified. 

 

To ensure the new Large Files Storage is now available in the storage types, reload the application.  

To verify Large Files Storage, go to AdministrationIntegrationFile Storage Services → click on Add File Storage Service → try to select Large Files Storage from the storage type dropdown.  

The following dialog should be displayed with all fields (connection string, schema, table) listed and available to accept the settings for the new type: 

 

  • Was this article helpful?