Define General Tab Properties for a Form Arrangement

Use the Tab page in the Tab Properties window to define the general properties for a form arrangement tab.

Form arrangement general tab properties are:

  • Name: Name to display on the tab. By default, the name either comes from the defined name of the child object in the relationship (example: Journals) or from the name of the additional form being displayed (example: Resolution Details); however, you can provide a name or define an expression to conditionally change the name.
  • Image: Image, if any, to display on the tab. By default, the image comes either from the defined image for the child object in the relationship (example: Journals icon Journals Icon) or, in the case of additional forms, from the Business Object itself (example: Resolution Details); however, you can select any image or define an expression to conditionally change the image. Hide the image by clearing the Tab Image check box.
  • Visibility: When to display or hide the tab (example: Always, only after resolution details are logged, etc.). By default, a tab is always visible unless you define an expression to hide the tab.

    The Tab Properties window is available in the Form Arrangement Editor (within a Blueprint in CSM Administrator).

To define general tab properties for a form arrangement:

  1. Open a form arrangement in the Form Arrangement Editor.
  2. On a tab, right-click > Properties.
  3. Select the Tab page.
  4. Define a tab name, using either:
    • Text: Select this radio button to accept the default name or provide a new name.
    • Expression: Select this radio button to use an expression to conditionally provide the name. Then, define the expression using one of the following options:
      • Stored Expression: Select the ellipsis Ellipses Button to open the Expression Manager, and then select an existing stored expression or create a new stored expression. Stored expressions can be reused in numerous places in CSM.
      • Custom Expression: Select the Custom Expression button Expression Button to open the Custom Expression Builder, and then create a custom expression specifically for this scenario.
  5. Define the image:
    1. Tab Image: Select this check box to display an image on the tab. Clear the check box to hide an image.
    2. Select an image, using either:
      • Image: Select this radio button to accept the default image or select a new image.

        Select the image to open the Image Manager, and then select an existing image or import a new image to represent the item in the UI.

      • Expression: Select this radio button to use an expression to conditionally provide the image. Then, define the expression using one of the following options:
        • Stored Expression: Select the ellipsis Ellipses Button to open the Expression Manager, and then select an existing stored expression or create a new stored expression. Stored expressions can be reused in numerous places in CSM.
        • Custom Expression: Select the Custom Expression button Expression Button to open the Custom Expression Builder, and then create a custom expression specifically for this scenario.
  6. Define the visibility:
    1. Tab Visibility: Select this check box to conditionally display/hide the tab. Clear the check box to always display the tab.
    2. Expression: Select this radio button to use an expression to conditionally display/hide the tab. Then, define the expression using one of the following options:
      • Stored Expression: Select the ellipsis Ellipses Button to open the Expression Manager, and then select an existing stored expression or create a new stored expression. Stored expressions can be reused in numerous places in CSM.
      • Custom Expression: Select the Custom Expression button Expression Button to open the Custom Expression Builder, and then create a custom expression specifically for this scenario.
    3. Select the Tab When It Becomes Visible: Select this check box to have the tab selected when it becomes visible (based on the defined expression) so that its contents appear in the form arrangement.
  7. Select OK.
  8. Publish the Blueprint to commit the changes, or save the Blueprint to continue making other changes.