🏄‍♂️Surf The Wave in Salesforce

Manage Grids in Wave Embedded

Surf The Wave

In Surf the Wave, users can view and interact with the grids they have access to. Depending on their permissions, they can personalize the grid without affecting the original configuration.

Surf the Wave

Publishing a Grid

To publish a grid, click the Publish Grid Instructions button on the Home, App, or Record Page. This button provides guidance on the publishing process, and users can also refer to this document for detailed steps.

Publish the grid

Viewing Configured Locations

If a grid has already been published and configured, users can view its location by clicking the Configured Locations button. This button is available only for Valorx Grids published on an App Page. Valorx Grids published on Home and Record Pages do not display the Configured Locations option.

Configured location

Valorx Grids

Valorx Grid

Users can publish their Valorx Grids across various platforms using the Lightning App Builder. This allows other users to access and interact with these grids seamlessly.

Users can publish their related grids only on the Record Page using Valorx Related Grid in the Lightning App Builder. Other users can view these grids.


Adding Valorx Grids to Lightning Pages

Valorx Grids can be integrated into App Pages, Home Pages, and Record Pages using Lightning App Builder. The sections below provide step-by-step instructions for each page type.

App Page Instruction.

In this section, we will create a new Lightning App Page using Lightning App Builder. Follow the steps below:

  1. If you’re using Lightning Experience, click , then select Setup.

  1. From Setup, in the Quick Find box, enter "Lightning App Builder". Select "Lightning App Builder".

  2. Then, click the "New" button.

  1. On the "Create a New Lightning Page" screen, select "App Page" and click "Next".

  1. Enter a name for Lightning page in the Label field, then click "Next".

  1. Select the One Region template, and click Done.

One Region will provide the largest canvas and is recommended. 

  1. Scroll down the left panel (components section) until you reach the Custom-Managed section at the bottom. Then, click and drag the "Valorx Grid" into the middle section. 

  1. After adding the Valorx Grid, the configuration panel on the right will become accessible. You can now customize the grid as follows:

    • Choose your desired grid configuration from the dropdown menu.

    • Specify the Relation Name, which defines the Lookup Relation Name. For example, on the Account Record Page, if you want to display Related Opportunities, include the API name of the Account Lookup field from Opportunities.

    • Adjust the height settings for your grid configuration.

    Then, click "Save".

  1. After the save is complete, a pop-up will appear prompting you to activate the page. Click "Activate" to proceed.

  1. In Lightning Experience page, you can integrate a page with a grid into any app. To do this, click on the Lightning Experience tab, select the Sales app, and click Add Page to App. Then, click "Save".

Your app home page is now ready for your Lightning Experience users!


Home Page Instructions

In this section, we will create a new Lightning App Page using Lightning App Builder. Follow the steps below:

  1. If you’re using Lightning Experience, click , then select Setup.

  1. From Setup, in the Quick Find box, enter "Lightning App Builder". Select "Lightning App Builder".

  2. Then, click the "New" button.

  1. On the "Create a New Lightning Page" screen, select "Home Page" and click "Next".

  1. Enter a name for Lightning page in the Label field, then click "Next".

  1. Select the One Region template, and click Done.

One Region will provide the largest canvas and is recommended. 

  1. Scroll down the left panel (components section) until you reach the Custom-Managed section at the bottom. Then, click and drag the "Valorx Related Grid" into the middle section. 

  1. After adding the Valorx Related Grid, the configuration panel on the right will become accessible. You can now customize the grid as follows:

  • Choose your desired grid configuration from the dropdown menu.

  • Specify the Relation Name, which defines the Lookup Relation Name. For example, on the Account Record Page, if you want to display Related Opportunities, include the API name of the Account Lookup field from Opportunities.

  • Adjust the height settings for your grid configuration.

  1. Then, click "Save".

  1. After the save is complete, a pop-up will appear prompting you to activate the page. Click "Activate" to proceed.

  1. In the activation window, you have three options to assign and deploy the page. Click Org Default, then click "Assign as Org Default". Close the window. After assigning the Home page, click the "Save" button to apply changes to the org.

  • Org Default: This will replace the default Home page with the custom Lightning Experience page.

  • App Default: This option causes the Lightning Experience page to replace the org default home page in the selected applications.

  • App and Profile: In this option, the Lightning Experience page will be assigned to apps with some specific profiles that can access and view the home page.

Now, you have assign the Lightning Experience page to the org default and application in the Salesforce.


Record Page Instructions

In this section, we will create a new Lightning App Page using Lightning App Builder. Follow the steps below:

  1. If you’re using Lightning Experience, click , then select Setup.

  1. From Setup, in the Quick Find box, enter "Lightning App Builder". Select "Lightning App Builder".

  2. Then, click the "New" button.

  1. On the "Create a New Lightning Page" screen, select "Record Page" and click "Next".

  1. Enter a name for the Lightning page in the Label field and the name of the object for which the record page is being created. Then, click "Next".

  1. Select the Home Template One Region, and click Done.

  1. Scroll down the left panel (components section) until you reach the Custom-Managed section at the bottom. Then, click and drag the "Valorx Related Grid" into the middle section. 

  1. After adding the Valorx Related Grid, the configuration panel on the right will become accessible. You can now customize the grid as follows:

  • Valorx Grid: Choose your desired grid configuration from the dropdown menu.

  • Allowing Changing Grids: Toggle the 'Allow Changing Grids' option to enable or disable users' ability to switch between grids within the same object.

  • Height (px): Adjust the height settings for your grid configuration.

  1. Then, click "Save".

  1. After the save is complete, a pop-up will appear prompting you to activate the page. Click "Activate" to proceed.

  1. In the activation window, you have three options to assign and deploy the page. Click Org Default, then click "Assign as Org Default". Close the window. After assigning the Record page, click the "Save" button to apply changes to the org.

  • Org Default: This will replace the default Record page with the custom Lightning Experience page.

  • App Default: This option causes the Lightning Experience page to replace the org default Record page in the selected applications.

  • App and Profile: In this option, the Lightning Experience page will be assigned to apps with some specific profiles that can access and view the Record page.

Now, you have assign the Lightning Experience page to the org default and application in the Salesforce.


Adding Valorx Grids to Tabs or Subtabs in a Lightning Page

Valorx Grids can be embedded within tabs or subtabs on Lightning Page to enhance data accessibility. Follow the steps below to add and configure Valorx Grids inside custom tabs.

1

Add a Tab to the Lightning Page

  • Open the desired Lightning Page in Lightning App Builder.

  • Drag the Tab component onto the page.

  • Click on the newly added tab and set the Tab Type to Custom.

  • Enter a meaningful name for the tab (e.g., Hot Grid).

  • Click Done to save the tab settings.

Add a Tab to the Lightning Page
2

Configure Valorx Grids on Tabs

  • Click on the Hot Grid tab and add the Valorx Grid component.

  • Select and configure the grid for Hot Grid:

    • Valorx Grid: Select the Valorx Grid you created in the Wave Dashboard.

    • Allow changing grids?: Deselecting this option disables the Grid Selection dropdown.

    • Height (px): Enter the desired height for the grid in pixels.

  • Click on the Warm Grid tab and configure the Warm Grid.

Configure Valorx Grid on Tabs
3

Save and Activate the Page

  • Click Save in the top-right corner.

  • Click Activate to publish the changes if the Lightning Page is not yet active.

Save and activate the page
4

Access the Lightning Page

Your Valorx Grids are now successfully embedded within the Lightning Page tabs! 🚀

Access the Lightning Page

Embedding Valorx Grids in a Community Portal Page (Experience Cloud)

Applicable to all Experience Cloud sites except LWR Sites.

Valorx Grids and Related Grids can be embedded within Community Portal pages to provide users with interactive data views. Follow the steps below to configure Valorx Grid in your Experience Cloud site.

1

Access the Experience Cloud Editor

  • Ensure your Community Portal is set up.

  • Navigate to All Sites and select your community site.

  • Click Builder to open the Experience Cloud editor.

Access the Experience Cloud Editor
2

Add the Valorx Grid Component

  • In the Components section, locate Valorx Grid.

  • Drag and drop the Valorx Grid component onto the page layout.

  • Select the Grid Name from the dropdown menu to load the grid.

Add the Valorx Grid Component
3

Preview and Publish

  • Click Preview (top-right corner) to check the grid’s appearance.

  • Once confirmed, click Publish to make changes live.

  • Log in as a Community User to confirm the Valorx Grid is visible.

Preview and Publish

Your Valorx Grid is now successfully embedded in the Community Portal!

Last updated