Matrix Launcher
Last updated
Last updated
The Matrix Launcher managed package provides users with a seamless way to launch Matrix from within Salesforce. Matrix is currently offered as a browser extension, and this managed package allows Designers to configure a button and associate the correct Matrix to be launched.
Note: This managed package is not available on AppExchange and can be downloaded from this link.
Ensure that the Valorx Wave extension is installed in your browser.
If the Valorx Wave extension is not installed, complete the installation before proceeding with the setup of the Matrix Launcher.
Follow the steps below to set up the Matrix Launcher from Salesforce:
Log in to your Salesforce Org using an Administrator account.
Install the Matrix Launcher Managed Package:
Click here to download and install the Matrix Launcher.
Choose one of the installation options:
Install for All Users: Recommended if all users need access to the Matrix Launcher.
Install for Admins Only: Restrict access to administrators only.
Acknowledge Terms and Conditions:
Select the necessary options to acknowledge the terms, then click the Install button.
Check Installation Status:
If the installation takes a few minutes, wait for it to complete. You can verify the installation by checking the Installed Packages section in the Setup Menu.
After successfully installing the Matrix Launcher package, follow these steps to set it up and use it within Salesforce.
Open the Valorx Wave browser extension.
Click the Login with Salesforce button and enter your Salesforce credentials.
Once logged in, you will be directed to the Valorx Wave Extension Dashboard screen. Navigate to the Matrix tab.
To retrieve the Matrix ID, you need to first open and run the Matrix in the browser extension. Once the Matrix is executed, the Matrix ID will be visible in the URL, which you can then use for further configuration. Note: If you don’t have any Matrix created yet, you’ll need to create one to obtain the Matrix ID. Refer to this guide for instructions on creating a new Matrix.
Note down this Matrix ID, as it will be used for further configuration in Salesforce.
Open your Salesforce Org and search for Matrix Launcher Config in the App Launcher.
Select Matrix Launcher Config to open the configuration object.
Click the New button to create a new configuration record.
Fill in the following details:
Matrix Name: Provide a meaningful name for the Matrix (e.g., “Sales Data Matrix”). This will be referenced in button configurations.
Matrix ID: Enter the Matrix ID you copied from the extension URL (e.g., 156).
Matrix Type: Select the appropriate type based on the configuration within the Valorx Wave browser extension. Note: Ensure the Matrix Name is kept handy as it will be used during the button configuration step
By default, the Environment is set to Production. You can change it to Staging if necessary. Then click on the Save button.
To launch a Matrix directly from a Salesforce object (e.g., Contact or Account), you need to create a custom button. Follow these steps to configure a detail page button:
Create a New Button on the Salesforce Object
Navigate to Object Manager and select the Opportunity object. (If you're using a different object, select that specific object instead.)
Click on Buttons, Links, and Actions from the left panel.
Click the New Button or Link button.
Configure the Button
Provide a name for your button (e.g., "Launch Matrix").
Choose Detail Page Button as the display type.
In the Text Area box, paste the following URL:
Replace the matrixName parameter with the appropriate Matrix Name you configured in Step 3 (e.g., "Account Contact").
Modify the FirstContextId and SecondContextId parameters based on the objects being used:
FirstContextId: This is the ID of the main object (e.g., {!Contact.Id}).
SecondContextId: Optional parameter for additional context (e.g., {!Account.Id}).
Then, click on the Save button. Note: Ensure the matrixName parameter is filled in correctly, as it is mandatory.
Add the Button to the Object Page Layout
Go to the Page Layouts section for the selected object.
Choose the page layout you want to modify and click on it.
Click on the Mobile and Lightning Actions tab.
Drag and drop the newly created button (Launch Matrix) into the Salesforce Mobile and Lightning Experience Actions section.
Save the layout changes.
Test the Button
Navigate to the object record (e.g., a Opportunity record) where the button has been added.
Click on the new Launch Matrix button.
Note: If you don’t see the button, check if Dynamic Forms are enabled for your Salesforce org. If so, follow the additional steps below to add the button.
Allow Pop-ups (if required)
If a pop-up blocker prevents the Matrix from launching, click the Allow pop-ups and redirects option at the top right of your browser’s URL bar.
Click Done, reload the page, and try clicking the button again.
To finalize the button configuration:
Edit the Record Page Navigate to the Record page, click on the Setup icon, and select Edit Page.
Add the Custom Button Select the Highlight Panel, then click on the Add Action button.
Select the Custom Button In the Custom Button section, locate and select the newly created button. Click Done and save your changes.
Now, you should be able to see and use your custom button on the Record page.
