Create an application

MDM applications provide business users and data stewards with a customized experience to access and manage their data. This page explains how to create and configure an MDM application in Semarchy xDM.

Create an application

To create an application:

  1. Right-click the Applications node and select Add Application…. The Create New Application wizard opens.

  2. In the Create New Application wizard, select the Auto Fill checkbox and then enter the following values:

    • Name: internal name of the object.

    • Label: user-friendly label for this object. Note that as the Auto Fill checkbox is selected, this field is automatically filled in. Modifying the label is optional.

    • Required Role: the application is by default available for all users. To restrict access to this application to a specific role, select it from the drop-down list.

    • Default Action: choose the action to display on the home page of the application. Since there are no other components yet, you can select between the Global Search page, the Inbox interface, or the root folder.

  3. Click Finish to close the wizard. The Application editor opens.

  4. In the Description field, optionally enter a description for the Application.

  5. In the Visibility field, select whether the application should be visible on the Welcome page and available, hidden from the Welcome page yet accessible through its URL, or disabled.

    When an application is disabled, the model must be redeployed after changing its visibility to Visible or Hidden.

Configure the application branding

To configure an application branding:

  1. Configure the application Branding. For this purpose, you can use images from the image libraries.

    • Title: the short name of the application that appears in the navigation drawer’s title.

    • Title Color: color used for the application title text. Adjust this color to ensure proper visibility of the title text over the cover image.

    • Avatar: an icon symbolizing the application. The avatar is displayed in the navigation drawer’s title and serves as the application’s representation on the Welcome page. Recommended dimensions and file formats: 48x48 px as SVG, PNG, JPG, or GIF files.

    • Logo: large logo representing the application, for example on the Global Search page.

    • Cover: background image of the navigation drawer’s title. Recommended dimensions and file formats: 320x128 px as PNG, JPG, or GIF files.

    • Favicon: icon displayed in the browser tab.

  2. In the Color Theming section, configure the color theme for this application.
    In this theme, you define:

    • Colors for the application’s title bar and the sidebar located on the right-hand side.

      • Colors may be specified using Material Design or CSS color syntax.

      • Each color set is defined for a different context: by default (when browsing, searching, etc.), when authoring records or when browsing errors.

      • Each color set includes a background color for the title or sidebar and a contrast color for text and icons.

      • The color of the sidebar, if left undefined, is computed from the corresponding title bar color for the same context (e.g., the sidebar authoring color is computed from the title bar authoring color).

      • The contrast color, if left undefined, is computed for optimal contrast with the corresponding background color.

    • The theme’s main colors. These only support Material Design color syntax:

      • Primary Color: used for input fields, buttons, etc., or when a theme:primary color is specified.

      • Secondary Color: used in other situations in the UI, or when a theme:accent color is specified.

      • Error Color: used for fields in error state, or when a theme:warn color is specified.

Configure the application features

  1. Configure the Display Properties for the application:

    • Sort Method: defines the sort method for application folders and actions. They can be automatically sorted alphabetically according to their Label or organized in a fixed Position set at design time.

  2. In the Features section:

    • Select Enable History Browsing to allow users to browse data at a specific point in time. This feature works with entities for which data historization is activated.

    • You can limit history browsing access to users with the role selected in the History Browsing Required Role drop-down list.