Add screen element

Screen elements (controls) are the building blocks of custom screens. They determine the layout, display read-only info, and provide user interaction.

Element properties are a combination of settings (simple values) and CRMScripts.

Adding an element

1. Click New element.
2. Select an element type and enter element properties.
3. Add config in the Simple values tab.
4. Click Apply.
5. Select the Creation script tab.
6. Set which data to display by extending the script.
7. Click Apply.

Simple values

Most elements have configuration options. These are specific to the different types of elements (for example, title and name).

Each option is written as a key-value pair in the Simple values tab of the element.

key = value
key2 = value2
key3 = value3

Each line is interpreted independently of the other lines. You can use our line-based query syntax to specify values.

Keys are automatically sorted alphabetically when you save an element.

Body

Many elements have a body, which can be quite long. Settings for the element body are set in the Body tab, not the Simple values tab.

The body is a CRMScript. It can:

• print any HTML to the screen using print()
• retrieve any configuration variable using getVariable() (v. 4.11)

Creation scripts

A creation script builds the element and populates it with data. It consists of 2 parts:

• An initial call to addHtmlElement() - default
• Your extension, which tailors the element and pulls in data

You’ll see the default code when you open the Creation Script tab of an element.

addHtmlElement(getScreenElementId(screenElementIndex),
  getScreenElementName(screenElementIndex),
  getScreenElementType(screenElementIndex),
  getScreenElementConfig(screenElementIndex));

To extend the default code, you’ll be using database queries and the functions supported by that element.

It might look something like this:

1. Get a reference to the element by declaring a variable of type HtmlElement and assigning the object returned by addHtmlElement()

2. Create a SearchEngine object and specify your query.

3. Run the query.

4. Loop over the result. For each row:

   • Create a Map.
   • Add key-value pairs to the map.
   • Add the map to the element using one of the element’s functions.