This document explains how to work with specific property types in the Semarchy xDM Application Builder.
Literal vs. SemQL Properties
When designing a model or application, most properties support literal values. For example, the Label of a field is a literal value. Certain properties in application components also support SemQL values, which are values based on the record data.
When a field supports literal and SemQL, a value type drop down appears aside the field to select the type of value. (Literal or SemQL).
If you select Literal, the property editing component adapts to the property type (boolean, string, etc).
If you select SemQL, the property editing component adapts gives you access to a SemQL editor. Note that if the property is a boolean, then the SemQL editor requires a condition, and not an expression.
In the example below, the Visible property is configured as a literal. As this property is a boolean, it appears as a checkbox. In that case, Visible is always true, and this field is always visible.
If the same property is now configured as SemQL, you can provide a SemQL expression to define its value.
In this second case, Visible is true if the value of the
Label attribute is not null. The field will be visible or invisible depending on the data.
In both these example, look at the Relative Width or Component Type properties. They only support literal values and do not have the value type selector.
Certain properties store color values. For example, the Label Color for a form field, or the Icon Color for an application action. Colors in Semarchy xDM applications are defined using three possible formats:
css: <css-color>, where
<css-color>is a CSS color value.
css: rgb(255, 255, 155)
css: rgba(255, 255, 155, 0.5)
theme: <intention>[ <hue>], where
<intention>is one of
<hue>is one of
hue-3. See Material Design Color for more information.
theme: primary hue-1
Material Design Palette Color:
md:<color>[ <shade>], where
<color>is one of named Material Design color and
<shade>is one of the hues defined for this color (500, A500…). See Material Design Color for more information.
Certain properties and values store images or references to images or icons. For example, the Primary Image or Avatar for a display card, or the Icon Color for an application action. An image or icon in a Semarchy xDM application is displayed from one of the following source types:
Binary Data, stored in the hub. This is the case for form or collection attributes images that display attributes with a binary data type. The form or collection component is configured with the Image Source property set to Content.
External URL, referring to images stored on another server. This is the case for form or collection images that display attributes containing an URL string. The form or collection component is configured with the Image Source property set to URL. Such an URL starts with
Image Library URL. This is the case for icons selected in the application, or form or collection image that display a literal or computed value containing an URL starting with
images://. An Image Library URL is structured as follows:
See Image Libraries for more information about images and image libraries.
Composing Image URLs
It is possible to compose external or image library URLs using SemQL.
For example, the
|Use the following link to Learn Markdown in 60 seconds.|
Markdown is a markup language with a simple text formatting syntax. Semarchy xDM is able to render Markdown text as HTML in the applications:
Certain properties, such as Documentation, support this language.
The Markdown component can be used in your applications to render and author Markdown text stored in entities' attributes.
|The markdown editor does not support the table edition. To edit tables in text attributes, users should either use inline HTML code or edit the raw Markdown content using a multi-line text field.|
Semarchy xDM support the following Markdown flavors:
GitHub Flavored Markdown (GFM), including tables and HTML embedded in markdown text.
Learn about them:
Markdown, when used in Semarchy xDM application, supports specific links patterns to open the model documentation using URL patterns.