User Interface

Revision as of 18:06, 7 March 2014 by Gionatan (talk | contribs)
Jump to navigation Jump to search

HSYCO allows the interaction with the system through a custom user interface. We can identify three entities:

  • Project: a single interface
  • Page: a project can contain pages
  • Object: a page can contain objects

A project is defined by a subdirectory inside www that contains an index.hsm file.

Whenever HSYCO detects any change to the files in www and in its subdirectories, it forces the reload of all the projects on the connected browsers.

For each sub-directory in www in which the file index.hsm exists, you can access the page with the following URL:

https://<name server>/<URLKey>/<subdirectory name>

To create or edit a project there are two methods: visually, through the Project Editor or by manually editing the project's source code, the index.hsm file.


Projects are described through a custom markup language that defines page, objects and various directives that apply to the project (skin, language, size...).

The syntax for every object is described in the corresponding section.

index.hsm files can be viewed from the Project Editor (tools > source) and edited from the Editor in the File Manager.

When errors are detected, the page is not served to the Web browser. File parsing stops at the first error, so only the first line with errors is reported in the log file. Each type of graphic object could require one or more parameters, separated by the “;” character. Empty lines or blank spaces are ignored.

Changes to index.hsm cause an automatic page reload on the connected Web browsers.

You can insert comment lines, which are ignored. A comment line starts with the “#” character at the beginning of the line.

Names in index.hsm are case sensitive, small and capital letters are significant; all objects defined in the standard skin have names with lower-case letters.

Some objects support a variant called identified version to allow the !id dynamic modification of the text, visibility, color several other attributes with the uiSet() Java method or the UISET action.