Child pages
  • JSServer

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Divcache
Div
iddescription
HTML Table
id
classservoy sSummary
Colgroup Tag
Col
width80px
Col
Table Head (thead)
Table Row (tr)
styleheight: 30px;
Table Head (th)
colspan2
Method Summary
Table Row (tr)
Table Cell (td)
JSTableObject
Table Cell (td)createNewTable(tableName)
styleindexdisplay:none

DO NOT EDIT THE CONTENT OF THIS PAGE DIRECTLY (EXCEPT INSIDE THE DIV BELOW WITH ID=DESCRIPTION), UNLESS YOU KNOW WHAT YOU'RE DOING.
THE STRUCTURE OF THE CONTENT IS VITAL IN BEING ABLE TO AUTO UPDATE THE CONTENT THROUGH THE DOC GENERATOR.

true
refresh100d
showRefreshtrue
iddoc
titleRefresh page
showDatetrue
retryEnable
id

servoy sReturnTypes2100%height: 30px;2Supported ClientssWordListSmartClientsWordListWebClientsWordListNGClient

servoy sSummary12%30%58%height: 30px;3Methods SummaryCreates in this server a new table with the specified name. Table Row (tr)

Table Cell (td)
Boolean
Table Cell (td)dropTable(tableName)
Table Cell (td)getTable(tableName)
Drops the table with the specified name from this server. Table Row (tr)
Table Cell (td)
JSTableObject
Returns a JSTable instance corresponding to the table with the specified name from this server. Table Row (tr)
Table Cell (td)
String[]
Table Cell (td)getTableNames()
Returns an array with the names of all tables in this server. Table Row (tr)
Table Cell (td)
Boolean
Table Cell (td)isValid()
Get valid state for the server. Table Row (tr) Table Cell (td) Table Cell (td)reloadDataModel()
voidReloads the datamodel from the database, if changed externally or via rawSQL plugin. Table Row (tr)
Table Cell (td)
Boolean
Table Cell (td)synchronizeWithDB(table)
Synchronizes a JSTable instance with the database. HTML Table

functionclass Colgroup Tag Colcolspanservoy sDetail2width100%

Col
Table Head (thead) Table Row (tr)styleheight:30px;
Table Head (th)
colspan2
Method Details
Table Body (tbody)
idcreateNewTable-String
Table Row (tr)
idname
Table Cell (td)

createNewTable

Table Row (tr)
idsig
Table Cell (td)
Span
stylemargin-right: 5px;
JSTableObject
Span
stylefont-weight: bold;
createNewTable
Spanid2Methods DetailscreateNewTablename

createNewTable(tableName)

Table Row (tr)des Table Cell (td) DivclasssIndentCreates in this server a new table with the specified name. Table Row (tr)idprs

Table Cell (td)class

Parameters

DivsIndent{String} tableName - The name of the table to create. Table Row (tr)idtdret

Returns

div Table Body (tbody)
iddropTable-String
Table Row (tr)
idname
Table Cell (td)

dropTable

Table Row (tr)
idsig
Table Cell (td)
Span
stylemargin-right: 5px;
Boolean
Span
stylefont-weight: bold;
dropTable
Span
(tableName)
Table Row (tr)
iddes
Table Cell (td) Div
classsIndent
sIndentclients

classsIndent
JSTableObject - JSTableObject created table.
Table Row (tr)
idsam
Table Cell (td)

Sample

Div
classsIndent
Code Block
languagejavascript
var server = plugins.maintenance.getServer("example_data");
if (server)
{
	var table = server.createNewTable("new_table");
	if (table) {
		var pk = table.createNewColumn("new_table_id", JSColumn.INTEGER, 0);
		pk.rowIdentifierType = JSColumn.PK_COLUMN;
		if (server.synchronizeWithDB(table))
			application.output("New table created in the database.");
		else
			application.output("New table not created in database.");
	}
	else application.output("New table not created at all.");
}
Table Row (tr)
classlastDetailRow
Table Cell (td)
 

Supported Clients

sIndentSmartClient,WebClient,NGClient
sam

Sample

sIdentjavascript
lastDetailRow 
dropTablename

dropTable(tableName)

dessIndentDrops the table with the specified name from this server.
Table Row (tr)idtdprs

Parameters

Divclass{String} sIndenttableName - The name of the table to drop. Table Row (tr)idret

Table Cell (td)

Returns

div Table Cell (td) Div
classsIndent
sIndentclients

classsIndent
Boolean - boolean success.
Table Row (tr)
idsam
Table Cell (td)

Sample

Div
classsIndent
Code Block
languagejavascript
var server = plugins.maintenance.getServer("example_data");
if (server) {
	var result = server.dropTable("new_table");
	if (result)
		application.output("Table dropped.");
	else
		application.output("Table not dropped.");
}
Table Row (tr)
classlastDetailRow
Table Cell (td)
 
Table Body (tbody)
idgetTable-String
Table Row (tr)
idname
Table Cell (td)

getTable

Table Row (tr)
idsig
Table Cell (td)
Span
stylemargin-right: 5px;
JSTableObject
Span
stylefont-weight: bold;
getTable
Span
(tableName)
Table Row (tr)
iddes

Supported Clients

sIndentSmartClient,WebClient,NGClient
sam

Sample

sIdentjavascript
lastDetailRow 
getTablename

getTable(tableName)

dessIndentReturns a JSTable instance corresponding to the table with the specified name from this server.
Table Row (tr)idprs

Table Cell (td)

Parameters

Divclass{String}

sIndenttableName - The name of the table to retrieve. Table Row (tr)idret

Table Cell (td)

Returns

div Div
classsIndent
sIndentclients

classsIndent
JSTableObject - JSTableObject table.
Table Row (tr)
idsam
Table Cell (td)

Sample

Div
classsIndent
Code Block
languagejavascript
var server = plugins.maintenance.getServer("example_data");
if (server) {
	var table = server.getTable("employees");
	if (table) {
		var colNames = table.getColumnNames()
		application.output("Table has " + colNames.length + " columns.");
		for (var i=0; i<colNames.length; i++)
			application.output("Column " + i + ": " + colNames[i]);
	}
}
Table Row (tr)
classlastDetailRow
Table Cell (td)
 
Table Body (tbody)
idgetTableNames
Table Row (tr)
idname
Table Cell (td)

getTableNames

Table Row (tr)
idsig
Table Cell (td)
Span
stylemargin-right: 5px;
String[]
Span
stylefont-weight: bold;
getTableNames
Span
()
Table Row (tr)
iddes
Table Cell (td)

Supported Clients

sIndentSmartClient,WebClient,NGClient
sam

Sample

sIdentjavascript
lastDetailRow&nbsp;
getTableNamesname

getTableNames()

dessIndentReturns an array with the names of all tables in this server.
Table Row (tr)idret

Table Cell (td)

Returns

div Table Body (tbody)
idisValid
Table Row (tr)
idname
Table Cell (td)

isValid

Table Row (tr)
idsig
Table Cell (td)
Span
stylemargin-right: 5px;
Boolean
Span
stylefont-weight: bold;
isValid
Span
()
Table Row (tr)
iddes
Table Cell (td) Div
classsIndent
sIndentclients

classsIndent
String[] - Array of String table names.
Table Row (tr)
idsam
Table Cell (td)

Sample

Div
classsIndent
Code Block
languagejavascript
var server = plugins.maintenance.getServer("example_data");
if (server) {
	var tableNames = server.getTableNames();
	application.output("There are " + tableNames.length + " tables.");
	for (var i=0; i<tableNames.length; i++)
		application.output("Table " + i + ": " + tableNames[i]);
}
else {
	plugins.dialogs.showInfoDialog("Attention","Server 'example_data' cannot be found.","OK");
}
Table Row (tr)
classlastDetailRow
Table Cell (td)
 

Supported Clients

sIndentSmartClient,WebClient,NGClient
sam

Sample

sIdentjavascript
lastDetailRow&nbsp;
isValidname

isValid()

dessIndentGet valid state for the server.
Table Row (tr)idret

Table Cell (td)

Returns

divsIndentclients

classsIndent
Boolean - boolean valid state.
Table Row (tr)
idsam
Table Cell (td)

Sample

Div
classsIndent
Code Block
languagejavascript
var server = plugins.maintenance.getServer("example_data");
if (!server.isValid()) {
	application.output("Server not valid!");
}
Table Row (tr)
classlastDetailRow
Table Cell (td)
 
Table Body (tbody)
idreloadDataModel
Table Row (tr)
idname
Table Cell (td)

reloadDataModel

Table Row (tr)
idsig
Table Cell (td)
Span
stylemargin-right: 5px;
void
Span
stylefont-weight: bold;
reloadDataModel
Span
()
Table Row (tr)
iddes
Table Cell (td) Div
classsIndent

Supported Clients

sIndentSmartClient,WebClient,NGClient
sam

Sample

sIdentjavascript
lastDetailRow&nbsp;
reloadDataModelname

reloadDataModel()

dessIndentReloads the datamodel from the database, if changed externally or via rawSQL plugin.
Table Row (tr)id This call is not needed after a call to synchronizeWithDB().tdret

Returns

divsIndentclients

classtd

Supported Clients

sIndent
void Table Row (tr)
idsam
SmartClient,WebClient,NGClientsam

Sample

Div
classsIndent
Code Block
languagejavascript
var server = plugins.maintenance.getServer("example_data");
var result = plugins.rawSQL.executeSQL("example_data", null, 'CREATE TABLE raw_table (raw_table_id INTEGER)');
if (result) {
	application.output("Table created through rawSQL plugin.");
	if (server) {
		server.reloadDataModel();
		// All existing JSTableObject/JSColumn object references are invalid now! Use getTable to get new ones.
		var table = server.getTable("raw_table");
		if (table) {
			var colNames = table.getColumnNames()
			application.output("Table has " + colNames.length + " columns.");
			for (var i=0; i<colNames.length; i++)
				application.output("Column " + i + ": " + colNames[i]);
		}
	}
}
else {
	application.output("Raw table creation failed: " + plugins.rawSQL.getException());
}
Table Row (tr)
classlastDetailRow
Table Cell (td)
 
Table Body (tbody)
idsynchronizeWithDB-JSTableObject
Table Row (tr)
idname
Table Cell (td)

synchronizeWithDB

Table Row (tr)
idsig
Table Cell (td)
Span
stylemargin-right: 5px;
Boolean
Span
stylefont-weight: bold;
synchronizeWithDB
Span
(table)
Table Row (tr)
iddes
Table Cell (td) Div
classsIndent
idsIdentjavascriptlastDetailRow&nbsp;synchronizeWithDBname

synchronizeWithDB(table)

dessIndentSynchronizes a JSTable instance with the database. If columns were added to or removed from the JSTable instance, all these changes will now be persisted to the database.
Table Row (tr)prs

Table Cell (td)class

Parameters

DivsIndent{JSTableObject} table - A JSTableObject instance that should be synchronized. Table Row (tr)idtdret

Returns

div Table Row (tr)
classlastDetailRow
Table Cell (td) sIndentclients

classsIndent
Boolean - boolean success.
Table Row (tr)
idsam
Table Cell (td)

Sample

Div
classsIndent
Code Block
languagejavascript
var server = plugins.maintenance.getServer("example_data");
if (server)
{
	var table = server.createNewTable("new_table");
	if (table) {
		var pk = table.createNewColumn("new_table_id", JSColumn.INTEGER, 0);
		pk.rowIdentifierType = JSColumn.PK_COLUMN;
		if (server.synchronizeWithDB(table))
			application.output("New table created in the database.");
		else
			application.output("New table not created in database.");
	}
	else application.output("New table not created at all.");
}

Supported Clients

sIndentSmartClient,WebClient,NGClient
sam

Sample

sIdentjavascript
lastDetailRow&nbsp;