com.ebasetech.xi.api
Interface BaseForm

All Superinterfaces:

Element, EventOwner, java.io.Serializable

All Known Subinterfaces:

IntegrationService, WebForm, WorkflowJob

public interface BaseForm
extends EventOwner

BaseForm is an interface that represents any Ebase runnable entity that can have fields, tables and access to resources via a Business View. This interface is extended by WebForm (an interactive form), IntegrationService (an Integration Service) and WorkflowJob (a workflow job). It also provides the basic interface for a component's view of its fields, tables, resources etc when the component is deployed.

Since:

V4.4

Method Summary

void	abort(java.lang.String message) Aborts execution of the current form, integration service or workflow node and rolls back the current transaction.
java.lang.String	getAbortMessage() Returns the abort message after a failure has occurred.
Fields	getFields() Returns the Fields object that gives access to all fields available to the form.
java.lang.String	getLanguage() Returns the language code for the user session.
Resources	getResources() Returns the Resources object that gives access to all resources available to the form.
Tables	getTables() Returns the Tables object that gives access to all tables available to the form.
void	setLanguage(java.lang.String language) Sets the language code for the user session.

Methods inherited from interface com.ebasetech.xi.api.Element

getElementName, getElementType

Method Detail

getLanguage

java.lang.String getLanguage()

Returns the language code for the user session. Language codes are defined in the Internationalization dialog. See Tools > System Preferences > Internationalization.

The language is used to:

• Display language sensitive items: texts, messages and static lists
• Control the formatting of numeric and date fields when data is presented to the user or entered by the user
• Set the character encoding (optional)

Further documentation.

Returns:

language code

Since:

V4.4

setLanguage

void setLanguage(java.lang.String language)

Sets the language code for the user session. Language codes must be defined in the Internationalization dialog. See Tools > System Preferences > Internationalization.

The language is used to:

• Display language sensitive items: texts, messages and static lists
• Control the formatting of numeric and date fields when data is presented to the user or entered by the user
• Set the character encoding (optional)

Further documentation.

Example:

 form.setLanguage("es_US");
 

Parameters:

language - language code

Since:

V4.4

abort

void abort(java.lang.String message)

Aborts execution of the current form, integration service or workflow node and rolls back the current transaction. If an on error event is specified, this will receive control and can access the abort message via getAbortMessage(). Otherwise the default system abort page is displayed.

Parameters:

message - the failure message

Since:

V4.4

getAbortMessage

java.lang.String getAbortMessage()

Returns the abort message after a failure has occurred. This is intended to be used in an on error event.

Returns:

the failure message or null if no failure has occurred

Since:

V4.4

getResources

Resources getResources()

Returns the Resources object that gives access to all resources available to the form. An individual resource can then be accessed using its resource name as shown in the examples below.

Javascript example:

 resources.EMAIL1.sendmail();
 form.getResources().WEB_SERVICE1.call();
 

Returns:

Resources

Since:

V4.4

getFields

Fields getFields()

Returns the Fields object that gives access to all fields available to the form. An individual field can then be accessed using its field name as shown in the examples below.

Javascript example:

 var v1 = fields.FIELD1.value;
 var v2 = form.getFields().FIELD_2.value;
 

Returns:

Fields

Since:

V4.4

getTables

Tables getTables()

Returns the Tables object that gives access to all tables available to the form. An individual table can then be accessed using its table name as shown in the examples below.

Javascript example:

 var t1 = tables.TABLE1;
 var t2 = form.getTables().TABLE2;
 

Returns:

Tables

Since:

V4.4