1. General information

1.1. Description of the control

HTML is a control that allows the embedding of any HTML code.

1.2. Create a new control

A new html can be created as follows from the view page using the toolbar with controls:

  • First, clicking the mouse on the view page determines the position in which the new html should be placed. This will highlight the selected position with a gray horizontal line. Then just click on “HTML” in the toolbar of the view page, fill in the attributes of the new control in the newly opened dialog, and then save. This will insert a new html at a pre-selected location on the view page.
  • If the required position is not determined before inserting a new html, the new html will be inserted at the end of the view page.

1.3. Edit or delete a control

  • For each existing control, a pencil icon appears to the left of the control page to change or delete the control's settings.
  • Individual controls can be moved vertically on the view page using the Drag&Drop method. Moving consists of grabbing the control, preferably behind its name, and then dragging it to the desired location on the view page.
  • Controls can be moved only with the “Drag&Drop” check box located above the toolbar with controls selected. For security reasons, this check box is cleared after each login to the application, so that a control is not moved by accident.

2. List of tabs in the control settings dialog

  • General – Setting general properties
  • Help – HTML code editor help
  • Other – Setting availability in portlets
  • Rights – Rights settings
  • Administration – Setting other properties

2.1. “General” tab

2.1.1. Name

  • The name of the control.

2.1.2. Variables and functions

  • Drop-down list with a selection of variables, javascript and server functions that can be used inside the HTML code.
  • A detailed description of the variables is provided in the separate guide Variables.
  • A detailed description of javascript functions is provided in the separate guide JavaScript functions.
  • A detailed description of the server functions is provided in the separate guide Server functions.

2.2. “Help” tab

  • HTML code editor help.

2.3. “Other” tab

2.3.1. Options

  • For portlets only
    • Checking this box determines whether the HTML code should be available in the list of controls to be placed in portlets.
    • The content of the HTML code in user mode remains hidden on the view page itself.

2.4. “Rights” tab

2.4.1. Rights

  • Rights define a list of user groups and users who have permission to display the control on the view page.
  • For a new control, the rights are prefilled from the control at the position selected before inserting it; if no position is selected, from the rights of the view page.

2.4.2. Replace rights to other controls

  • The “Replace rights to other controls” feature is used to unify rights across the entire view page for controls that are related in terms of rights.
  • Thanks to the “Show...” link, it is possible to display a list of all controls on the view page, including the settings of the rights of these controls. A check box is displayed for each control to select it. When the control is saved, the same rights are then set for the selected controls.
  • An alternative for unifying rights within the entire view page is the overview of the rights settings of all controls, displayed by the “Show summary...” link on the “Rights” tab in the view page settings.

2.5. “Administration” tab

  • The “Administration” tab is only displayed for existing controls.

2.5.1. Location

  • Select the view page on which the control is located.
  • The drop-down list contains the view pages located in the same application and in the same category as the view page on which the control stands. For a view page without a category, it offers only view pages without a category. For a new control, it contains only the current view page.

2.5.2. Change tracking

  • Change tracking displays a detailed report with all changes made to the HTML code by individual users.

2.5.3. Other

  • Change type to
    • The drop-down list offers the types of controls to which conversion of the control is supported.

2.5.4. Compare

  • The “Compare” button is used to compare the HTML code on the “General” tab with another version of the code, which the administrator inserts into the text field on the “Administration” tab.
  • After pressing the button, a comparison table with two columns is displayed:
    • General – values displayed on the “General” tab,
    • Administration – the corresponding values from the “Administration” tab.
  • If the values in the same item differ, the system highlights the difference in red text.
  • A textual summary of discrepancies (e.g., “General is not equal to Administration”) is displayed in a dialog.

2.6. “Save”, “Save and continue editing”, “Copy”, “Delete”, and “Close” buttons

  • “Save” button – Saves changes to the control settings.
  • “Save and continue editing” button – Saves changes to the control settings and keeps the settings dialog open for further modifications.
  • “Copy” button – Creates a new copy of the current control with identical settings, but with a newly generated unique identifier.
  • “Delete” button – Permanently deletes the control.
  • “Close” button – Closes the control settings dialog without saving changes.