Page History

...

...

...

Components basically work as an umbrella for all objects which are referenced from the JSForm object. By retrieving an object as a component, you can change properties which are shared by all these objects or conveniently clone the object including its referenced objects and properties. Check the examples at components for more information.

When creating objects you need to make sure that the same object with the same name does not already exists. In this case you need to choose another name or remove the existing object.

As explained as an analogy in a previous section, some changes made with the Solution Model have such an impact that on other existing objects, that some of them need to be destroyed and recreated again.

By default, changes made by the Solution Model are not persistent and are only valid for the current session in which these changes are made.

...

• Create an object
• Retrieve an existing object
• Change a property of an object
• Remove an existing object

Calculations

...

Create

As described in a previous section, the Solution Model includes some factury functions which allow you to create certain layout object which can be used at forms.

To create a new calculation with name myCalculation on table customers of server example_data which returns 1blue line border of width 1 and use that on an existing form:

var calculationborder = solutionModel.newCalculationcreateLineBorder('function myCalculation() { return 1; }', JSVariable.INTEGER, 'db:/example_data/customers');

...

1, 'blue');
var form = solutionModel.getForm('myForm);
form.borderType = border;

Calculations

During development, calculations can be created as stored or unstored. As soon as the name of a calculation corresponds with a database column, it automatically becomes a stored calculation. The same rule applies for the Solution Model.

To create a new calculation with name myCalculation on table customers of server example_data which returns 1:

var calculation = solutionModel.getCalculationnewCalculation('myCalculation', 'function myCalculation() { return 1; }', JSVariable.INTEGER, 'db:/example_data/customers');

To get the existing calculation myCalculation on table customers of server example_data:

var calculation = solutionModel.getCalculation('myCalculation', 'db:/example_data/customers');

To output whether or not this calculation is a stored one:

...

...

Form variables

...

Components

Components allow you to retrieve all objects which are referenced from the JSForm object. By retrieving an object as a component, you can change properties which are shared by all these objects or conveniently clone the object including its referenced objects and properties.

To retrieve component with name myButton:

var formVariablecomponent = form.newFormVariablegetComponent('myFormVariable', JSField.TEXT_FIELDmyButton');

To get existing form variable myFormVariablehide the element:

component.visible = true;

To retrieve all available components on the form:

var formVariablecomponents = form.getFormVariablegetComponents('myFormVariable');

To change its default value to abcthe width of all elements to 200:

formVariable.defaultValue
for (var i = 'abc'0;

...

 i < components.length; i++) {
	components[i].width = 200;
}

To clone an existing component:

formsolutionModel.removeFormVariablecloneComponent('myFormVariablemyClonedComponent', component);

Form methods

To create a new form method with name myFormMethod:

Form variables

To create a new form variable with name myFormVariable:

var formVariable = form.newFormMethodnewFormVariable('function myFormMethod() {controller.newRecord(myFormVariable', JSField.TEXT_FIELD);
}');

To get existing form method myFormMethodvariable myFormVariable:

var formMethodformVariable = form.getFormMethodgetFormVariable('myformMethodmyFormVariable');

To make it appear in the menuchange its default value to abc:

globalMethodformVariable.showInMenudefaultValue = true'abc';

To remove existing form method myFormMethodvariable myFormVariable:

form.removeFormMethodremoveFormVariable('myFormMethodmyFormVariable');

Form

...

methods

To create a new body:form method with name myFormMethod:

var partformMethod = form.newPart(JSPart.BODY, 20newFormMethod('function myFormMethod() {controller.newRecord(); }');

To retrieve the existing body partget existing form method myFormMethod:

var partformMethod = form.getPart(JSPart.BODYgetFormMethod('myformMethod');

To change its background to whitemake it appear in the menu:

partglobalMethod.backgroundshowInMenu = 'white'true;

To remove the existing body partform method myFormMethod:

form.removePart(JSPart.BODYremoveFormMethod('myFormMethod');

...

Form parts

To create a tree view with name myBeannew body:

var beanpart = form.newBean('myBean', 'com.servoy.extensions.beans.dbtreeview.DBTreeView', 200, 200, 300, 300newPart(JSPart.BODY, 20);

To get existing bean myBeanretrieve the existing body part:

form.getBean('myBean'var part = form.getPart(JSPart.BODY);

To change its anchoring to top, left and bottombackground to white:

beanpart.anchorsbackground = SM_ANCHOR.NORTH | SM_ANCHOR.WEST | SM_ANCHOR.SOUTH'white';

To remove the existing bean myBeanbody part:

form.removeBean('myBean'removePart(JSPart.BODY);

...

Beans

To create a new button tree view with name myButton and text Text and attaching global method myGlobalMethod to it myBean:

var globalMethodbean = solutionModelform.getGlobalMethodnewBean('myGlobalMethodmyBean');
var button = form.newButton('Text, 'com.servoy.extensions.beans.dbtreeview.DBTreeView', 0200, 0200, 80300, 20, globalMethod300);
button.name = 'myButton';

...

To get existing bean myBean:

var button = solutionModel.getButtonform.getBean('myButtonmyBean');

To change its height to 30anchoring to top, left and bottom:

buttonbean.heightanchors = 30 SM_ANCHOR.NORTH | SM_ANCHOR.WEST | SM_ANCHOR.SOUTH;

To remove existing button myButtonbean myBean:

form.removeButtonremoveBean('myButtonmyBean');

Components

Components basically work as an umbrella for all form elements. By retrieving a form element through a component, you can clone the element including its properties.

Or, If you want to change properties which are common to all elements, you can do this through components instead of having to retrieve each individual object separately.

...

Buttons

To create a new button with name myButton and text Text and attaching global method myGlobalMethod to it:

var component globalMethod = solutionModel.getGlobalMethod('myGlobalMethod');
var button = form.getComponentnewButton('myButton'Text', 0, 0, 80, 20, globalMethod);

To hide the element:

component.visiblebutton.name = true'myButton';

To retrieve all available components on the formget existing button myButton:

var componentsbutton = formsolutionModel.getComponentsgetButton('myButton');

To change the width of all elements to 200its height to 30:

for (var i = 0; i < components.length; i++) {
	components[i].widthbutton.height = 20030;
}

To remove existing button myButton:

form.removeButton('myButton');

Fields

To create a new text field with name myField with form variable myFormVariable as its dataprovider:

...

solutionModel.removeMedia('myMedia');