Entity Names editor

It is possible to define an entity name as a text string, which you can then use in the PolicyCenter interface to represent that entity. Thus, you often see the term display name associated with this feature as well, especially in code and in Gosu documentation.

PolicyCenter uses the DisplayName property on an entity to represent the entity name as a text string. You can define this entity name string as a simple text string, or you can use a complicated Gosu expression to generate the name. PolicyCenter uses these entity name definitions in generating database queries that return the limited information needed to construct the display name string. This ensures that PolicyCenter does not load the entire entity and its subentities into memory simply to retrieve the few field values necessary to generate the display name.

The use of the Entity Name feature helps to avoid loading entities into memory unless you are actually going to view or edit its details. The use of display names improves overall application performance.

The Entity Names editor consists of two parts:

  • A table in which you manage variables for use in the Gosu code that defines the entity name
  • A Gosu editor that contains the Gosu code that defines the entity name
Warning: Do not reference in an entity name definition either a virtual property or an otherwise non-queryable column, including an amount virtual property. Failing to follow this guidance will compromise performance and lead to exceptions.