Skip to content

Managing global settings

Starting from CF237, the Global page under Administration > Settings in Practitioner Studio is read-only. To modify global settings, edit the parameters under configuration.webEngine.propertiesFilesOverrides in your custom Helm values file. For more information, refer to Updating DX properties using Helm values.

Specifying the default DX Compose language

To change the default language for DX Compose, add the language properties to your custom Helm values file:

configuration:
  webEngine:
    propertiesFilesOverrides:
      LocalizerService.properties:
        locale.default.language: “<language code>”
        locale.default.country: “<country code (optional)>”
        locale.default.variant: “<variant (optional)>“

Specifying how to handle portlets users are not authorized to view

Configure whether to display a message or hide portlets entirely when users lack permission to view them.

To display an informative message:

configuration:
  webEngine:
    propertiesFilesOverrides:
      ConfigService.properties:
        portlets.unauthorized.visible: "true"

To hide the portlet entirely:

configuration:
  webEngine:
    propertiesFilesOverrides:
      ConfigService.properties:
        portlets.unauthorized.visible: “false”

Specifying landing pages after login

After users log in, you can direct them to the default DX Compose page without resuming their session, return them to the last page visited in their previous session, or allow them to choose their starting view.

To direct users to the default DX Compose page without resuming their session:

configuration:
  webEngine:
    propertiesFilesOverrides:
      ConfigService.properties:
        persistent.session.level: "0"
        persistent.session.option: "0"

To return users to the last page visited in their previous session:

configuration:
  webEngine:
    propertiesFilesOverrides:
      ConfigService.properties:
        persistent.session.level: "2"
        persistent.session.option: "0"

To allow users to choose their initial view:

configuration:
  webEngine:
    propertiesFilesOverrides:
      ConfigService.properties:
        persistent.session.level: "2"
        persistent.session.option: "1"

Specifying the search engine URL

To configure the search engine URL used when users select Find:

configuration:
  webEngine:
    propertiesFilesOverrides:
      ConfigService.properties:
        portlet.url.find: “<URL>“

Important

The Search box feature is available in default DX Compose themes. To use it in custom themes, include the <portal:find> tag in your custom theme code.

HCLSoftware U learning materials

Note

Access HCLSoftware U resources for free. Log in or Sign up to get started. If you have further questions, Contact us or check the FAQ.

To learn how to do a traditional installation, go to Deployment for Intermediate Users. In this course, you will also learn about additional installation tasks that apply to both container-based and traditional deployments using the Configuration Wizard, DXClient, ConfigEngine, and more. You can try it out using the Deployment Lab and corresponding Deployment Lab Resources.