Solution
Overview
The Servoy solution
represents a project
that encapsulates both user interface and business logic. It supports modular design by allowing integration with other solutions defined as modules, improving organizational flexibility. Key properties include comment
for programmer notes, firstForm
to define the initial form upon deployment, and modulesNames
listing the modules added to the solution. Authentication requirements are managed with mustAuthenticate
, while solutionType
specifies the type of solution, such as "Normal", "Module", "NG Client", or "Service". Other attributes like styleSheet
, titleText
, and version
provide customization options and semantic versioning support.
Notable events include onOpen
, triggered when the solution starts, and onClose
, which allows conditional termination. The onAutoSaveFailed
event captures validation or save failures during automatic saving. Additional functionality is available through events like onDataBroadcast
for handling data updates and onError
to manage runtime exceptions.
The solution provides flexible integration with login forms, internationalization, and custom styling, offering extensive configurability for various application requirements.
Properties Summarized
Additional information, such as programmer notes about this model object's purpose.
These are the event types of the solution that can be added/fired/removed from eventsManager object.
The first form that loads when a solution is deployed.
The i18n database server connection and database table that stores the i18n keys for a solution.
The name of the login form that loads when a solution is deployed.
Get the first module that is also a login solution.
The list of modules that have been added to a solution.
Flag that tells if authentication is needed in order to access the solution.
The type of a solution; can be "Normal" (non-module), "Module", "Web client only (deprecated)", "Smart client only (deprecated)", "Login", "Authenticator", "Pre-import hook module", "Post-import hook module", "Mobile", "Mobile shared module", "NG Client", "NG Module", "Service".
The custom CSS used by the solution (a MEDIA lib entry).
The direction that text is displayed.
The menu bar title of a solution.
This is the version of the solution, this can be any kind of string but try to follow "Semantic Versioning".
Events Summarized
void
The method that is executed when autosave results in validation or save failures.
void
The method that is to onOpen just that it executes before the login on solutions with a login form (not login soliution).
The method that is executed when a solution closes.
void
Method that is executed when data broadcast occurs.
The method that is executed when a solution opens and an error occurs.
void
The method that is executed when a solution opens.
Properties Detailed
comment
Additional information, such as programmer notes about this model object's purpose.
eventTypes
These are the event types of the solution that can be added/fired/removed from eventsManager object. These event types are added on top of default form events. They can be access through EventType.name property when used to fire or listen to.
firstForm
The first form that loads when a solution is deployed.
NOTE: If the Login form is specified, then the firstForm is the first form that will load next after the loginForm.
i18nDataSource
The i18n database server connection and database table that stores the i18n keys for a solution.
loginForm
The name of the login form that loads when a solution is deployed.
loginSolutionName
Get the first module that is also a login solution.
modulesNames
The list of modules that have been added to a solution.
mustAuthenticate
Flag that tells if authentication is needed in order to access the solution. If unchecked, the Smart Client will always require authentication, regardless of this setting. If checked, authentication is required, and either a provided loginSolution or otherwise the default Servoy login mechanism will be used. If default Servoy login mechanism is used, the "servoy.webclient.basic.authentication" setting on the Admin Page can be used to enable the use of the standard browser basic authentication.
solutionType
The type of a solution; can be "Normal" (non-module), "Module", "Web client only (deprecated)", "Smart client only (deprecated)", "Login", "Authenticator", "Pre-import hook module", "Post-import hook module", "Mobile", "Mobile shared module", "NG Client", "NG Module", "Service".
styleSheet
The custom CSS used by the solution (a MEDIA lib entry). It can reference other media resources (even additional .css through relative '@import' statements). For NGClient - this CSS will be available directly in the browser.
textOrientation
The direction that text is displayed.
Options include: DEFAULT left to right right to left locale specific
titleText
The menu bar title of a solution.
version
This is the version of the solution, this can be any kind of string but try to follow "Semantic Versioning". This version is important when you are making modules that are distributed by the Servoy Package Manager. Then this version is used to know what the developer has installed. This version should be in sync then with the webpackage.json file.
Events Detailed
onAutoSaveFailed(recordMarkers)
The method that is executed when autosave results in validation or save failures. This is not called for save or validate calls that are triggered from javascript itself (databaseManager.saveData()), only when Servoy tries an auto save because of some event like user clicking on the form itself or foundset selection change.
Parameters
Returns: void
onBeforeLogin(queryParams)
The method that is to onOpen just that it executes before the login on solutions with a login form (not login soliution). The default is -none-.
Parameters
Returns: void
onClose(force)
The method that is executed when a solution closes. The default is -none-.
Parameters
onDataBroadcast(dataSource, action, pks, cached)
Method that is executed when data broadcast occurs. The default is -none-.
Parameters
Returns: void
onError(ex)
The method that is executed when a solution opens and an error occurs. The default is -none.
Parameters
onOpen(arg, queryParams)
The method that is executed when a solution opens. The default is -none-.
Parameters
Returns: void
Last updated
Was this helpful?