Skip to main content

         This documentation site is for previous versions. Visit our new documentation site for current releases.      

Configuring master-detail settings

Updated on December 13, 2022
Applicable to Theme Cosmos applications

Show extra information about the contents of each row by configuring the master-detail settings in your table. By enabling users to access data in a row, you help them avoid losing the current context.

The master-detail settings help you enable users to view or edit the details of a master object (a table row). Users can navigate between the master objects and make changes to details without leaving the page. For example, in a table that contains a list of employees, users can display and update additional employee details after clicking a row.

  • The master-detail option is available only for non-optimized tables.
  • The UI Gallery landing page contains a working example of the table layout components, which you can use for reference or copy directly to your application. For more information, see Accessing the UI Gallery.
Before you begin: Create a table layout for your application. For more information, see Creating a table layout without code optimization.
  1. In the navigation pane of Dev Studio, click Records.
  2. Expand the User Interface category, and then click Section.
  3. In the section list, select the section that contains the target layout.
  4. In the Table header, click the View properties icon.
  5. In the Properties window, select the Operations tab.
  6. In the Row operations section, select the Master-detail check box.
  7. In the Display of details list, select a way to display row details when a user clicks a row:
    • To display details in a modal window that is displayed on top of the table, select Modal dialog. The edits are applied when the user closes the modal window.
    • To display details in an expandable detail area that is displayed below the selected row, select Expandable rows. The edits are applied when the user saves the changes or selects another row.
    • To display details in a detail area below the table or in a designated section, select Embedded elsewhere. The edits are applied when the user saves the changes or selects another row.
  8. In the Detail flow action field, specify the flow action that provides the form for the selected display type that appears when the user clicks a row.
    Note: A flow action is a section that contains the form fields for the user to complete when they interact with the details data.
  9. Optional: To personalize the display of details, choose additional personalization options:
    Select a new format for the Modal dialog display type
    1. In the Modal format list, select Other.
    2. In the new field, press the Down arrow key and select the format that you want to use
      Note: The field shows custom formats that are defined in the skin.
    Skip showing users the expand/collapse icon at each row level for the Expandable rows display typeClear the Display an expand/collapse icon per row check box.
    Change the default place for showing the details for the Embedded elsewhere display type
    1. In the Details location setting, click In place of a section.
    2. In the new field, specify the section in which you want the details to appear.
      For example: If you want the detail area to appear to the right of the table, create the gridResults section with a two-column layout. Embed the table in the first column, and then add an empty section in the second column. Specify the name of the empty section in the field.
  10. Optional: To override the default template for the row details, select the Override default template check box, and then, in the Template name field, specify the new template name.
    Note: By default, the templates are the following standard rules:
    • .pyGridModalTemplate (for the Modal dialog display type)
    • .pyGridRowDetails (for the Expandable rows display type)
    • .pyGridDetails (for the Embedded elsewhere display type)
  11. Optional: To allow the user to view the flow action with details in the read-only mode, select the Display details read-only check box.
    Note: If you select this option if the flow action with details contains an editable table, you prevent users from editing the table.
  12. Click Submit.
  13. On the section form, click Save.
  • Previous topic Modifying presentation options of the non-optimized table layout
  • Next topic Creating a hierarchical table layout

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best. is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us