(BETA) Embedding data from a custom application in the studio pages

Before you begin

Make sure that end users have permissions to the following items:

• The record definition from the custom application that you want to embed.
• The fields in the record definition from which you want to populate data.

For more information, see Enabling row-level security by defining security labels. 

To embed data from a record definition

1. Log in to the BMC Helix Digital Workplace  Administration Console, and select Configuration > Studio. 
2. Create a new page or open an existing page. 
3. Click Components .
4. Either double-click or drag the Record View component to the page canvas. 
5. Select Content options and then click Configure. 

6. In the Configure Record View wizard > on the Select application & record tab, configure the following parameters:
   
   

   Parameter	Description	Example
   Application	Select the custom application developed on BMC Helix Innovation Suite from which you want to select the record definition.
   Record	Select the record definition from which you want to populate data in the studio page.

7. Click Next. 

8. On the Define grid fields tab, configure the following settings: 
   
   

   Setting	Description	Example
   Fields	Select the fields from which you want to populate data.  The fields are displayed as columns in the page.
   Additional field settings	To change the sequence of the fields when they are displayed for the end users, click and drag as required.  To enable filtering on each field, click  Toggle filtering next to the field.  To enable sorting on each field, click  Toggle sorting next to the field.  To rename the field label, hover over the field and click  Edit . To deselect a field, hover over the field and click Delete .
   Languages	Select the language in which you want to customize the field labels, so that the end user will see translated field labels in the column headers appropriate to their language setting.

9. Click Save. 
10. (Optional) To configure the View details button, click Component Properties .

    1. In the Actions section, click Modify next to View details and configure the following settings: 
       
       

       Setting	Description	Example
       View details	Select the Select 'view details' grid action toggle to enable end users to see the View details button.
       Fields	Select the fields from which you want to display data when the end user is looking for more details.  You can reorder these fields and modify the field labels
       Languages	Select the language in which you want to customize the field labels, so that the end user will see translated field labels appropriate to their language setting.

    2. Click Save. 

11. To configure the page size and other visual properties, in the click Component Properties pane, and complete the following settings: 

    Setting	Description
    Page size	Specify the number of rows you want to display in the grid. Valid values: 1 to 20
    Bordered	Select this parameter if you want to add a border to the grid.
    Striped	Select this parameter if you want to add a gray background to each odd row.
    Toolbar	Select this parameter if you want to display the following example message to let the end user know how many rows are displayed in the grid.  1 to 15 of 25

12. Save and publish the page. 

Result

The following image is an example of how end users can view the data in the studio page:

Troubleshooting

The following table describes common errors that can occur when you embed data from a record definition and the steps to resolve them:

Customer feedback

We thank you for your participating in the Beta program. We request that you share your feedback or concerns regarding this capability and its documentation on the DWP Beta validation page on BMC Community.