Style templates

The Style templates menu item can be found in the Hauptmenü via the ‘Administration/Styling’ menu node, provided sufficient permissions are available.

  • View name: de.lobster.scm.client.style::StyleDeclaration|listSearchWindow

  • Menu node name: admin/stylingGroup/styleDeclaration

The menu item opens the predefined overview for the 'Style template' entity type (StyleDeclaration), which displays a list of all Style templates.

Access to the Style templates entity type is governed by the permissions for the ‘Administration/Configuration/Styles’ node (administration/designer/style), which also determine access to Styles.

  • Style templates do formally have an owner. However, ownership is categorically ignored for this entity type.

  • Effectively, access control is therefore based exclusively on the permissions available for the Role of session.

  • The Style templates menu item only appears if the permission for 'Show' (show) is available in Styles (and Style-Vorlagen).

Style templates form the basis for creating Styles, which inherit characteristic values as long as the inheritance is not overridden.

'Style templates' overview

images/download/attachments/201677210/image-2025-5-19_16-16-54-version-1-modificationdate-1747664213258-api-v2.png

The Style templates overview lists all Style templates created, provided no filters are active.

The ribbon only contains generic functions for overviews of entities whose availability may depend on permissions:

  • The main category Settings allows authorised roles to make adjustments to the list and the ribbon menu.

  • Style templates can be imported and exported via Meta exchange.

Starting from the overview, a data input form for Style templates can be opened using one of the following methods:

  • Clicking on the New ribbon button opens the input form with volatile data for a new, not yet saved entity of the ‘Style template’ (StyleDeclaration) type.

  • Clicking on the Edit ribbon button (see screenshot) or Display transfers the data of the selected line to a data input form.

  • Double-clicking on a list item sends the data of the selected line to a data input form for 'Display' or 'Edit' (depending on permissions).

'Style template' input form

'Style template' tab

images/download/attachments/201677210/image-2025-5-19_16-17-55-version-1-modificationdate-1747664274866-api-v2.png

The Style template tab contains two key features for the style template:

  • The Template name (name) defines the name of the template. In the example, the string ERP was selected. After saving, it is displayed with write protection, which can be cancelled by clicking on the button with the lock symbol.

  • The selection for the Theme (styleResource) defines the basic layout for the application and the Style properties available by default as well as their default values.
    NOTE◄ As a rule, the ‘Urban’ theme (text key: desktop:urban) should be used here.

'Style properties' tab

images/download/attachments/201677210/image-2025-5-19_16-19-30-version-1-modificationdate-1747664369939-api-v2.png

The Style properties tab is divided into different areas:

  • The toggle buttons in the header (‘Default’, ‘Dark’, 'Bright', ‘Dark bluish’) define which of the predefined or alternative colour modes a ‘style’ from the template supports.

    • Depending on the number of active colour modes, the user may or may not be offered a choice of colours when logging in or via the User menu.

  • The list area below provides an overview of all Style properties, with a default value and preview column for each activated colour mode.

    • By clicking on Add custom property (in the header area), the list of Style properties can be expanded to include custom properties..

  • The detail area (right) shows the details for each activated colour mode for a selected style property. Changes to the default values for Styles can be made here.

NOTE◄ The handling of Style properties in Style templates is largely the same as for Styles.

The ribbon buttons in the Style subcategory (on the right in the screenshot) also work for Style templates in the same way as the buttons for Styles:

  • The Preview ribbon button temporarily applies all default values for Style properties of a template to the current session.
    NOTE If more than one colour mode is activated for a style template, the colour mode required for the Preview is queried via the context menu.

  • The Reset ribbon button restores the default values for Style properties that the style applicable to the session prescribes.

Example:

The screenshot shows a Preview of the appearance of the ‘Style template’ tab using the features of the ‘Style template’ with the name 'ERP' with the colour mode ‘Bright’ displayed in it:

images/download/attachments/201677210/image-2025-5-19_16-22-55-version-1-modificationdate-1747664574813-api-v2.png

For comparison: The same view with 'Factory settings' for the 'Default' colour mode.

images/download/attachments/201677210/image-2025-5-19_16-17-55-version-1-modificationdate-1747664274866-api-v2.png