Skip to main content
Matrix42 Self-Service Help Center

Matrix42 File Storage Services

Overview 

Matrix42 File Storage Services is a package to expand the default Matrix42 files upload and storage capabilities. It provides an ultimate facility to integrate external object storage providers to upload files, attachments, and other assets.  

Matrix42 File Storage Services includes a Default SQL Server storage provider out of the box and multiple cloud providers available for further configuration. It is also well-designed and handy to accept more custom providers if required.  

Matrix42 File Storage Services extension is published and available in the Extension Gallery. To view and install it, follow the next steps: 

  1. Go to Administration application  
  2. Go to Extension Gallery menu item 
  3. Search for Matrix42 File Storage Services extension
  4. Click on Install  

 file_storage_services_extension.png

Once the installation process is complete, the new menu item and dialog are available for the further services configuration. To access it, go to Administration application → IntegrationFile Storage Services:

  

Default SQL Server storage provider is enabled and set as default.  

Creating a new File Storage Service 

To add a new provider, click on Add File Storage Service action located above the grid. The following screen with the following settings should appear: 

 

General

General section is dedicated to the basic settings:  

  • Name: the name of the storage service 
  • Description: the description of the storage service 
  • Priority: the priority of the storage service. Default is 0Priority field value must be numeric and unique. The priority field is used when determining the storage service on file uploading. The bigger value means the higher priority. Default checkbox is read-only. To change the default provider, go to the list of providers in Administration application → Integration → File Storage Services → select the desired storage service → click Set as Default Storage in the preview dialog:
  • Default: identifies whether storage service is default or not. Default is false
  • Enabled: identifies whether storage service is active or not. Default is true.

 Apply To

Apply To section is dedicated to allocating the service to a particular Location, Roles, or Configuration Items.  

  • Locations: the list of locations. Default is empty
  • Roles: the list of roles. Default is empty
  • Configuration Items: the list of configuration items. Default is empty. 

Empty values mean the service is active throughout the application for all objects while uploading the files. Allocating it to a particular Location, Role, or Configuration Items makes it actual for the selected criteria only. Using this approach, it becomes feasible to use multiple storages. As an example, it is getting easy to use different storages for i.e., Tickets and Incidents. It’s enough to set Configuration Item Ticket (SPSActivityTypeTicket) for one storage and Incident (SPSActivityTypeIncident) for another one. Depending on the object the user has created (ticket or incident) the appropriate storage will be selected.

Please note, if Apply To values are empty or the same for multiple storages, the Priority is used to determine the best matching storage provider (see General section).

Storage

Storage section is dedicated to set connection properties for the selected provider:

  • Type: the type of storage.  

Depending on the selected storage type the rest of the fields may vary, details are listed below. 

By default, Matrix42 File Storage Services extension has the following types of storage: 

  • MS SQL Server database: uploads files to SQL Server database 
  • Azure Blob: uploads files to Azure Blob Storage  
  • Matrix42 Cloud Storage: uploads files to internal Matrix42 Cloud storage 

MS SQL Server database

To configure MS SQL Server database set the following properties: 

  • Connection string: the connection string to MS SQL database (mandatory field) 
  • Storage container: the name of the storage container to bind the files to (optional value)
     

Azure Blob

To configure Azure Blob set the following properties: 

  • Connection string: the connection string to Azure Storage Account (mandatory field) 

  • Storage container: the storage container to store the files (mandatory field) 

 

While configuring Azure Blob, the connection string and storage container name should be obtained from the Azure portal (https://portal.azure.com).  

To get the connection string, go to Storage Account Access KeysShow Keys → Copy the Connection String

 

The container name must be taken from containers in Storage AccountContainers:  

 

Matrix42 Cloud Storage

To configure Matrix42 Cloud Storage set the following properties: 

  • Service Connection: the name of Matrix42 Service Connection 
  • Region: the region of the Blob storage to be used 
  • Storage container: the container name of the storage   

 

  • Was this article helpful?