Create an Application

Applications provide business users and data stewards with a customized experience to access and manage their data. This document explains how to create and configure an 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, check the Auto Fill option 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 box is checked, the Label for is automatically filled in. Modifying this 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: Select the action that will be the Home Page of the application. As the application has no other component yet, you have the choice between the Global Search, the My Tasks and 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 but accessible via its URL, or Disabled. Note that when an application has been disabled, you must re-deploy the model 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. Use this color to ensure that the text of the title displays correctly on top of the Cover image.

    • Avatar: An icon representing the application. It appear in the navigation drawer’s title, and is also used to represent this application on the Welcome page.

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

    • Cover: Background image of the navigation drawer’s title.

    • 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 Title Bar and for the right Sidebar:

      • These colors may be specified using the material design or CSS color syntax.

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

      • Each color set includes the background Color or the title or sidebar and the Contrast Color used for the text and icons.

      • The color of the sidebar, if left undefined, is computed from the corresponding title bar color for the same context. For example, 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 main colors. These only support the material design color syntax:

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

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

      • Error Color is 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.