Valorx
HomeFusionWave
Wave
Wave
  • Getting Started
    • 🌊What is Valorx Wave
      • Pick The Right Wave
    • 📔Get Started with Valorx Wave
      • Wave Browser Extension Installation & Setup
      • Wave Embedded Installation & Setup
  • Wave Workspace
    • Overview
    • 🏡Home
    • 📃Grids
    • 🟣Wave Floaty
    • Wave Dashboard
  • Wave Experience
    • 📚Type of Grid in Wave
    • 📝Create A New Grid
      • 🌈Manage Grid in Wave Browser Extension
      • 🪄Grid Wizard in Salesforce
  • WAVE DATA MANAGEMENT
    • 📊Managing Grid Data
      • Filter
      • Condition
      • Group
      • Column Group
      • Mass Modifier
    • ✏️Data Control & Customization
    • 🔍Data Interaction
    • 🔢Data Insights & Summary
  • ⌛Managing Records in Wave
  • Surf The Wave
    • 🏄‍♂️Surf The Wave in Salesforce
      • Using Wave Grid in Components and Flows
      • Row Action
      • Known Limitation
      • Wave Embedded Grid Migration
  • Matrix
    • 🔳Matrix Screen
  • 🎨Matrix Designer
  • ▶️Matrix Runtime
  • ⚡Matrix Launcher
  • REPORTS
    • 📈Reports Overview
  • IMPORT
    • 🚀Import Overview
  • SETTINGS
    • 🛠️Settings Screen
  • Release Notes
    • 📢Wave Browser Extension
      • March 25 Release (v40)
      • February 25 Release (v39)
      • January 25 Release (v38)
      • December 24 Release (v37)
      • October 24 Release (v36) - Hotfix
      • September 24 Release (v35) - Hotfix
      • August 24 Release (v34)
      • July 24 Release (v32)
      • June 24 Release (v31) - Hotfix
      • May 24 Release (v30)
      • April 24 Release (v29)
      • Archived Release Notes
        • March 24 Release (v28)
        • Feb 24 Release (v27)
        • Jan 24 Release (v26)
        • Dec 23 Release (v25)
        • Nov 23 Release (v24)
        • Oct 23 Release (v23)
        • Sept 23 Release (v21)
        • Aug 23 Release (v20)
        • Jul 23 Release (v18)
        • Jun 23 Release (v17)
        • May 23 Release (v15)
        • Apr 23 Release (v12)-Hotfix
        • Apr 23 Release (v11)
        • Mar 23 Release (v10)
        • Jan 23 Release (v9)
        • Jan 23 Release (v8)
        • Dec 22 Release (v7)
        • Nov 22 Release (v6)
        • Oct 22 Release (v5)
        • Sep 22 Release (v4)
        • Sep 22 Release (v3)
        • Sep 22 Release (v2)
        • Sep 22 Release (v1)
    • ☁️Wave Embedded
      • May 25 Release (v12) - Hotfix
      • March 25 Release (v11)
      • February 25 Release (v10)
      • December 24 Release (v9) - Hotfix
      • November 24 Release (v8)
      • October 24 Release (v7)
      • September 24 Release (v6)
      • August 24 Release (v5)
      • July 24 Release (v4)
      • June 24 Release (v3)
  • HELP & FAQ
    • 💡FAQs
    • ✉️Get Support
Powered by GitBook
On this page
  • Prerequisites
  • Setup Instructions for Matrix Launcher Managed Package
  • How to Use the Matrix Launcher
  • Step 1: Connect the Browser Extension to Your Salesforce Org
  • Step 2: Configure the Matrix into the Extension
  • Step 3: Matrix Launcher Configuration in Salesforce
  • Configure the Detail Page Button
  • Additional Steps

Matrix Launcher

Last updated 5 months ago

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 .

Prerequisites

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.

Setup Instructions for Matrix Launcher Managed Package

Follow the steps below to set up the Matrix Launcher from Salesforce:

  1. Log in to your using an Administrator account.

  2. Install the Matrix Launcher Managed Package:

    • Click 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.

  3. Acknowledge Terms and Conditions:

    • Select the necessary options to acknowledge the terms, then click the Install button.

  4. 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.

How to Use the Matrix Launcher

After successfully installing the Matrix Launcher package, follow these steps to set it up and use it within Salesforce.

Step 1: Connect the Browser Extension to Your Salesforce Org

  1. Open the Valorx Wave browser extension.

  2. Click the Login with Salesforce button and enter your Salesforce credentials.

  3. Once logged in, you will be directed to the Valorx Wave Extension Dashboard screen. Navigate to the Matrix tab.

Step 2: Configure the Matrix into the Extension

  1. 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.

  2. Note down this Matrix ID, as it will be used for further configuration in Salesforce.

Step 3: Matrix Launcher Configuration in Salesforce

  1. Open your Salesforce Org and search for Matrix Launcher Config in the App Launcher.

  2. Select Matrix Launcher Config to open the configuration object.

  3. Click the New button to create a new configuration record.

  4. 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

  5. By default, the Environment is set to Production. You can change it to Staging if necessary. Then click on the Save button.

Configure the Detail Page 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:

  1. 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.

  2. 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:

      /apex/valorxwave__LaunchMatrix?matrixName=Account Contact&FirstContextId={!Contact.Id}&SecondContextId={!Account.Id}
    • 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.

  3. 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.

  4. 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.

  5. 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.

Additional Steps

To finalize the button configuration:

  1. Edit the Record Page Navigate to the Record page, click on the Setup icon, and select Edit Page.

  2. Add the Custom Button Select the Highlight Panel, then click on the Add Action button.

  3. Select the Custom Button In the Custom Button section, locate and select the newly created button. Click Done and save your changes.

  4. Now, you should be able to see and use your custom button on the Record page.

⚡
link
Valorx Wave Browser Extension (Google Chrome and Microsoft Edge )
Salesforce Org
here
Install Matrix Launcher
Matrix Launcher at Installed Packages
Open Wave Extension
Login into Wave Extension with Salesforce
Run Matrix
Get the Matrix ID
Matrix ID
Matrix Launcher Config
Create a new button
Add button's name and display type
Configure button URL
Allow pop-ups