Matrix42
Introduction
This document provides comprehensive and up-to-date instructions for integrating Matrix42 into Autom Mate. The integration allows users to interact with Matrix42's service management platform, enabling operations like viewing tickets, managing users, and retrieving system data directly within Autom Mate workflows.
Through this integration, Autom Mate users can automate processes such as ticket management, user updates, and system health monitoring, all without needing to write additional code.
What is Matrix42?
Matrix42 is a leading IT service management (ITSM) platform, designed to streamline and automate IT operations. It provides tools for managing service requests, incidents, changes, and asset management, as well as enabling IT teams to provide high-quality service delivery.
Matrix42 is used in enterprises to optimize IT processes, improve productivity, and enhance user satisfaction. With this integration, Autom Mate users can easily access and manipulate Matrix42 data within their workflows.
Automate Integration with Matrix42
Under the Integration Library, Autom Mate provides several built-in actions that allow seamless interaction with Matrix42, including View Tickets, View Users, and View Attachments.
🔐 Prerequisite
Before using this integration, ensure you have the appropriate credentials stored securely in Autom Mate:
Navigate to the Vault page in Autom Mate.
Create a new Vault item containing your Matrix42 API Key or connection credentials.
Use this credential in the App Credential field within the action configuration.
This ensures secure communication and credential management across your automation processes.
Using the Integration
To use the Matrix42 integration in Autom Mate:
Select the Matrix42 Action: Choose from pre-built actions like "View a Ticket", "View All Users", or "View Attachments" from the Integration Library.
Fill in Required Fields: Provide necessary inputs like Ticket ID, Widget ID, or Application ID, depending on the action being used.
Assign Variables: For each action, you will be prompted to assign output variables (e.g., ticket data, user details, etc.) to store the results.
Use Variables in Subsequent Actions: After executing the action, you can use the assigned output variables in downstream actions, such as sending notifications, updating records, or making decisions based on ticket or user data.
How to Use Actions
View a Ticket
Description and Purpose
The Matrix42 - View a Ticket action allows Autom Mate users to retrieve details about a specific ticket in the Matrix42 system. This action is essential for automation processes that involve retrieving ticket information based on a unique Ticket Number, such as ticket status, priority, assignee, or other details.
By providing the Ticket Number, users can fetch the full ticket data from Matrix42, which can then be used in further processing or decision-making workflows.
Usage Instructions
Select App Credential
App Credential (Required): Select the credential that connects Autom Mate to Matrix42. Example:
Matrix42This credential ensures secure communication between Autom Mate and Matrix42, allowing you to view tickets.
Assign Output Variables
Output Body (Required): Select an object-type variable (e.g.,
ViewaTicket_output_d1469266fbad4b959bdf1154c0955aed) to store the full details of the ticket.Output Header (Required): Select another object-type variable (e.g.,
ViewaTicket_output_header_d1469266fbad4b959bdf1154c0955aed) to store metadata about the ticket query, such as response status or additional information.
Inputs
App Credential
Select the credential for connecting to Matrix42 (e.g., Matrix42).
Ticket Number
Enter the unique ticket number for the Matrix42 ticket (e.g., TICKET-12345).
Outputs
Output Body
Contains the full ticket data from Matrix42, including status, priority, assignee, etc.
Output Header
Contains metadata about the response, such as status code, message, or other relevant details.
Example
App Credential:
Matrix42Ticket Number:
TICKET-12345Output Body: The output variable
ViewaTicket_output_d1469266fbad4b959bdf1154c0955aedwill contain detailed information about the specified ticket, such as ticket status, assigned team, description, and more.Output Header: The output variable
ViewaTicket_output_header_d1469266fbad4b959bdf1154c0955aedwill contain metadata about the response, such as the API status or error messages.
View All Users
Description and Purpose
The Matrix42 - View All Users action allows Autom Mate users to retrieve a list of all users in the Matrix42 system. This action is helpful for use cases where user information needs to be fetched for reporting, user management, or creating a list of all users within the system. The action does not require any input data, and the output consists of user data retrieved from Matrix42.
Usage Instructions
Assign Output Variables
Output Body (Required): Select an object-type variable (e.g.,
ViewAllUsers_output_c092ffba813347c9809c3aaebb36fadc) to store the full details of all users retrieved from Matrix42. This variable will hold the list of all users.Output Header (Required): Select another object-type variable (e.g.,
ViewAllUsers_output_header_c092ffba813347c9809c3aaebb36fadc) to store metadata about the response, such as status, message, or additional information.
Inputs
This action does not require any input data. It fetches all user data directly from the Matrix42 system based on the provided credential.
Outputs
Output Body
Contains the full list of all users in the Matrix42 system. This is typically an object or array containing user details such as user ID, name, role, etc.
Output Header
Contains metadata about the response, such as status, message, or other relevant details.
Example
App Credential:
Matrix42Output Body: The output variable
ViewAllUsers_output_c092ffba813347c9809c3aaebb36fadcwill contain detailed information about all users in Matrix42, including usernames, roles, and other associated details.Output Header: The output variable
ViewAllUsers_output_header_c092ffba813347c9809c3aaebb36fadcwill contain metadata such as the status of the request, the number of users retrieved, or any error messages if applicable.
View Attachments of a Ticket
Description and Purpose
The Matrix42 - View Attachments of a Ticket action allows Autom Mate users to retrieve all attachments associated with a specific ticket in the Matrix42 system. This action is essential for automation scenarios where ticket-related attachments need to be processed, saved, or reviewed.
By specifying the Ticket ID and defining the output type, users can extract the attachment details for further actions, such as saving them to Mate Drive or processing them dynamically within workflows.
Usage Instructions
Select App Credential
App Credential (Required): Select the credential that connects Autom Mate to Matrix42. Example:
Matrix42This credential ensures secure access to the Matrix42 system, allowing for the retrieval of ticket attachments.
Provide Ticket ID
Ticket ID (Required): Enter the unique identifier of the Matrix42 ticket whose attachments you wish to view. Example:
TICKET-12345This ID will be used to query Matrix42 and retrieve the attachments associated with the specified ticket.
Choose Output Type
Output Type (Required): Select the desired format for the attachment data:
Base64: The attachments will be returned in base64 encoding, which is useful if the files need to be saved or transmitted as binary data.
Folder Path: Select this option if you want to specify the destination folder where the attachments should be saved in Mate Drive. You need to provide a folder path.
The Folder Path option requires a valid destination path to save the file in MateDrive. Ensure that the destination folder exists or will be created during the process. You can use Data Store paths like mate:/ or mate:/foldername.
Assign Output Variables
Output Body (Required): Select an array-type variable (e.g.,
ViewAttachmentsofaTicket_output_349c66a9359c4487b38ed9e0daacc783) to store the list of attachments retrieved from the ticket.Output Header (Required): Select an object-type variable (e.g.,
ViewAttachmentsofaTicket_output_header_349c66a9359c4487b38ed9e0daacc783) to store metadata about the response, such as status, message, or additional information.
Execute and Review
Run the action. After execution, the output variables will contain the attachment details for the specified ticket, which can then be used in subsequent actions, such as saving to Mate Drive or logging.
Inputs
App Credential
Select the credential for connecting to Matrix42 (e.g., Matrix42).
Ticket ID
Enter the ticket ID of the Matrix42 ticket to retrieve attachments from (e.g., TICKET-12345).
Output Type
Choose the format for the output. Options include Base64 or Folder Path.
Folder Path
Specify the folder path to save the attachments in Mate Drive (optional).
Outputs
Output Body
An array containing the list of attachments for the specified ticket. This could include file names, types, and other metadata.
Output Header
Contains metadata about the response, such as status, message, or other relevant details.
Example
App Credential:
Matrix42Ticket ID:
TICKET-12345Output Type:
Base64Folder Path:
mate:/ticket_attachmentsOutput Body (
ViewAttachmentsofaTicket_output_349c66a9359c4487b38ed9e0daacc783): The output will contain an array of attachment details like the file names, sizes, and other relevant data.Output Header (
ViewAttachmentsofaTicket_output_header_349c66a9359c4487b38ed9e0daacc783): The output will contain metadata such as the status of the request, the number of attachments retrieved, or any error messages if applicable.
View Data of a Widget
Description and Purpose
The Matrix42 - View Data of a Widget action allows Autom Mate users to retrieve the data associated with a specific widget within the Matrix42 platform. This action is useful for automating the process of fetching widget data based on a given Application ID and Widget ID, allowing users to process or analyze widget-specific information dynamically within their workflows.
By providing the Application ID and Widget ID, users can access detailed data related to the widget, such as configuration settings, performance metrics, or status information, and integrate it into their automation processes.
Usage Instructions
Assign Output Variables
Output Body (Required): Select an array-type variable (e.g.,
ViewDataofaWidget_output_8bea9a4af0e54544a7b4d694032f9e2e) to store the data retrieved for the widget.Output Header (Required): Select an object-type variable (e.g.,
ViewDataofaWidget_output_header_8bea9a4af0e54544a7b4d694032f9e2e) to store metadata about the response, such as status, message, or other relevant information.
Inputs
App Credential
Select the credential for connecting to Matrix42 (e.g., Matrix42).
Application ID
Enter the unique Application ID to retrieve data for (e.g., APP-56789).
Widget ID
Enter the unique Widget ID to retrieve data for (e.g., WIDGET-12345).
Output Body
Select an array-type variable to store the widget data.
Output Header
Select an object-type variable to store metadata about the response.
Outputs
Output Body
An array containing the data of the specified widget, such as its configuration, metrics, or status.
Output Header
Metadata about the response, including status, message, or other relevant details.
Example
App Credential:
Matrix42Application ID:
APP-56789Widget ID:
WIDGET-12345Output Body (
ViewDataofaWidget_output_8bea9a4af0e54544a7b4d694032f9e2e): The output variable will contain an array of widget data, such as configuration settings, performance metrics, or widget-specific information.Output Header (
ViewDataofaWidget_output_header_8bea9a4af0e54544a7b4d694032f9e2e): The output variable will contain metadata such as the response status, success message, or error details.
Last updated
Was this helpful?