Display cards


Certain simple display properties are defined as part of the logical modeling effort: The Labels and Descriptions of the entities, attributes, types and references. These are used as default labels and descriptions when using entities, attributes or references in applications.

An entity contains several attributes (simple and complex). When an entity value needs to be displayed in a compact form (for example, in a collection, or in a single field), its Display Card is used.

The display card defines how an entity record appears in a list. It uses the entity’s attribute values to build the elements of the display card:

  • Primary Text: This text is displayed as the first line of the display card.

  • Secondary Text and Supporting Text: These texts appear as the second and third line when the component showing the display card requires them.

  • Primary Image: This picture is displayed for a grid list. If the primary image has a null value, it is replaced by the Fallback Image.

  • Avatar: This small picture is displayed in a round shape in a list.

Display card

The examples below show a display card used to show the same product record in a grid and a list.

Display card in a grid Display card in a list

In this example:

  • Primary Text is set to the Label attribute of the product.

  • Secondary Text concatenates the brand, family and sub-family of the product, using the following SemQL expression: FDN_Brand || ' (' || FDN_Family || ' - ' || FDN_SubFamily || ')'.

  • The Primary Image and the Avatar use the ImageURL attribute of the product.

Create display cards

To create an entity display card:

  1. Right-click the entity node and select Add Display Card.

  2. In the Create New Display Card wizard, enter the following values:

    • Name: Internal name of the object.

    • Default Display Card select this option to use this display card by default for the entity. Only one default display card can exist for an entity.

  3. Click Next.

  4. Use the SemQL editor to define the Primary Text Expression as well as the Secondary Text Expression

  5. Click Next.

  6. Use the SemQL editor to define the Primary Text Expression as well as the Secondary Text Expression

  7. Select a Primary Image and an Avatar from the image libraries. You can also define these using SemQL expressions.

  8. Click Finish to close the wizard.

  9. Press Control+S (or Command+S on macOS) to save the Display Card editor.

  10. Close the editor.

You must define at least one display card for each entity within a model. A very basic display card uses the most representative attribute of the entity as the primary text.