Child pages
  • JSTableObject

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
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.
Enter additional information related to this 'class' inside the {div} macro with 'id=description'
Divcache
styleindexdisplay:none

...

iddescription

...

padding0px
width80px

...

Table Row (tr)
styleheight: 30px;
Table Head (th)
colspan2
Method Summary

...

Table Cell (td)
JSColumnObject

...

true
refresh100d
showRefreshtrue
iddoc
titleRefresh page
showDatetrue
retryEnable

servoy sReturnTypes2100%height: 30px;2Supported ClientssWordListSmartClientsWordListWebClientsWordListNGClient

servoy sSummary12%30%58%height: 30px;3Methods SummaryCreates a new column in this table.

...

Table Cell (td)
JSColumnObject

...

...

Creates a new column in this table.

...

Table Cell (td)
JSColumnObject

...

...

Creates a new column in this table.

...

void

...

Deletes the column with the specified name from this table.

...

Table Cell (td)
JSColumn

...

...

Table Cell (td)
String[]

...

Returns a JSColumn for the named column (or column dataproviderID).

...

...

Table Cell (td)
String

...

Returns an array containing the names of all table columns.

...

Returns the table data source uri.

...

Table Cell (td)
String

...

Returns a quoted version of the table name, if necessary, as defined by the actual database used.

...

Table Cell (td)
String[]

...

Table Cell (td)
String

...

Returns an array containing the names of the identifier (PK) column(s).

...

Returns the table name.

...

Table Cell (td)
String

...

Returns the Servoy server name.

...

Table Cell (td)
Boolean

...

id
HTML Table
Returns whether table was flagged as metadata table.

...

servoy sDetail

function

class
Colgroup Tag
Column
padding0px
width100%
Table Row (tr)
style2100%height:30px;
Table Head (th)
colspan1
Method Details
Table Body (tbody)
idcreateNewColumn-String_Number_Number
Table Row (tr)
idname
Table Cell (td)
createNewColumn
Table Row (tr)
idsig
Table Cell (td)
Span
stylemargin-right: 5px;
JSColumnObject
Span
stylefont-weight: bold;
createNewColumn
Span2Methods DetailscreateNewColumnname

createNewColumn(columnName, type, length)

Table Row (tr)id

des Table Cell (td) DivclasssIndent
Creates a new column in this table. The name, type and length of the new column must be specified. For specifying the


type of the column, use the JSColumn constants. The column is not actually created in the database until this


table is synchronized with the database using the JSServer.synchronizeWithDB method.


The method returns a JSColumn instance that corresponds to the newly created column. If any error occurs and the column cannot be created, then the method


returns null.
Table Row (tr)id
prs

Table Cell (td)class

Parameters

Div
Table Row (tr)
idret
Table Cell (td)
Returns
Div
classsIndent
JSColumnObject
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("users");
	if (table)
	{
		var pk = table.createNewColumn("id", JSColumn.MEDIA, 16); // can also use (JSColumn.TEXT, 36) for UUIDs
		pk.rowIdentifierType = JSColumn.PK_COLUMN;
		pk.setFlag(JSColumn.UUID_COLUMN, true)
		pk.sequenceType = JSColumn.UUID_GENERATOR
		var c = table.createNewColumn("name", JSColumn.TEXT, 100);
		c.allowNull = false
		table.createNewColumn("age", JSColumn.INTEGER, 0);
		table.createNewColumn("last_login", JSColumn.DATETIME, 0);
		var result = server.synchronizeWithDB(table);
		if (result) application.output("Table successfully created.");
		else application.output("Table not created.");
	}
}
Table Row (tr)
classlastDetailRow
Table Cell (td) Table Body (tbody)
idcreateNewColumn-String_Number_Number_Boolean
Table Row (tr)
idname
Table Cell (td)
createNewColumn
Table Row (tr)
idsig
Table Cell (td)
Span
stylemargin-right: 5px;
JSColumnObject
Span
stylefont-weight: bold;
createNewColumn
SpansIndent{String} columnName
{Number} type
{Number} lengthcolumnName ;type ;length ;ret

Returns

sIndent
clients

Supported Clients

sIndentSmartClient,WebClient,NGClient
sam

Sample

sIdentjavascript
lastDetailRow
createNewColumnname

createNewColumn(columnName, type, length, allowNull)

Table Row (tr)idclass

des Table Cell (td) DivsIndent
Creates a new column in this table. The name, type and length of the new column must be specified. For specifying the


type of the column, use the JSColumn constants. The column is not actually created in the database until this


table is synchronized with the database using the JSServer.synchronizeWithDB method.


The method returns a JSColumn instance that corresponds to the newly created column. If any error occurs and the column cannot be created, then the method


returns null.
Table Row (tr)idtd
prs

Parameters


div

classsIndent{String} columnName
{Number} type
{Number} length
{Boolean} allowNull

Table Row (tr)
idret
Table Cell (td)
Returns
Div
classsIndent
JSColumnObject
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("users");
	if (table)
	{
		var pk = table.createNewColumn("id", JSColumn.MEDIA, 16); // can also use (JSColumn.TEXT, 36) for UUIDs
		pk.rowIdentifierType = JSColumn.PK_COLUMN;
		pk.setFlag(JSColumn.UUID_COLUMN, true)
		pk.sequenceType = JSColumn.UUID_GENERATOR
		var c = table.createNewColumn("name", JSColumn.TEXT, 100);
		c.allowNull = false
		table.createNewColumn("age", JSColumn.INTEGER, 0);
		table.createNewColumn("last_login", JSColumn.DATETIME, 0);
		var result = server.synchronizeWithDB(table);
		if (result) application.output("Table successfully created.");
		else application.output("Table not created.");
	}
}
Table Row (tr)
classlastDetailRow
Table Cell (td) Table Body (tbody)
idcreateNewColumn-String_Number_Number_Boolean_Boolean
Table Row (tr)
idname
Table Cell (td)
createNewColumn
Table Row (tr)
idsig
Table Cell (td)
Span
stylemargin-right: 5px;
JSColumnObject
Span
stylefont-weight: bold;
createNewColumn
SpancolumnName ;type ;length ;allowNull ;ret

Returns

sIndent
clients

Supported Clients

sIndentSmartClient,WebClient,NGClient
sam

Sample

sIdentjavascript
lastDetailRow
createNewColumnname

createNewColumn(columnName, type, length, allowNull, pkColumn)

Table Row (tr)idclass

des Table Cell (td) DivsIndent
Creates a new column in this table. The name, type and length of the new column must be specified. For specifying the


type of the column, use the JSColumn constants. The column is not actually created in the database until this


table is synchronized with the database using the JSServer.synchronizeWithDB method.


The method returns a JSColumn instance that corresponds to the newly created column. If any error occurs and the column cannot be created, then the method


returns null.
Table Row (tr)idtd
prs

Parameters


div

classsIndent{String} columnName
{Number} type
{Number} length
{Boolean} allowNull
{Boolean} pkColumn

Table Row (tr)
idret
Table Cell (td)
Returns
Div
classsIndent
JSColumnObject
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("users");
	if (table)
	{
		var pk = table.createNewColumn("id", JSColumn.MEDIA, 16); // can also use (JSColumn.TEXT, 36) for UUIDs
		pk.rowIdentifierType = JSColumn.PK_COLUMN;
		pk.setFlag(JSColumn.UUID_COLUMN, true)
		pk.sequenceType = JSColumn.UUID_GENERATOR
		var c = table.createNewColumn("name", JSColumn.TEXT, 100);
		c.allowNull = false
		table.createNewColumn("age", JSColumn.INTEGER, 0);
		table.createNewColumn("last_login", JSColumn.DATETIME, 0);
		var result = server.synchronizeWithDB(table);
		if (result) application.output("Table successfully created.");
		else application.output("Table not created.");
	}
}
Table Row (tr)
classlastDetailRow
Table Cell (td) Table Body (tbody)
iddeleteColumn-String
Table Row (tr)
idname
Table Cell (td)
deleteColumn
Table Row (tr)
idsig
Table Cell (td)
Span
stylemargin-right: 5px;
void
Span
stylefont-weight: bold;
deleteColumn
Span
(columnName)
Table Row (tr)
iddes
Table Cell (td)
Div
classsIndent
Deletes the column with the specified name from this table. The column is not actually deleted from the database until this
table is synchronized with the database using the JSServer.synchronizeWithDB method.
Table Row (tr)
idprs
Table Cell (td)
Parameters
Div
classsIndent
{String} columnName
Table Row (tr)
idret
Table Cell (td)
Returns
Div
classsIndent
void
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("users");
	if (table) {
		table.deleteColumn("last_login");
		server.synchronizeWithDB(table);
	}
}
Table Row (tr)
classlastDetailRow
Table Cell (td) Table Body (tbody)
idgetColumn-String
Table Row (tr)
idname
Table Cell (td)
getColumn
Table Row (tr)
idsig
Table Cell (td)
Span
stylemargin-right: 5px;
JSColumn
Span
stylefont-weight: bold;
getColumn
Span
(name)
Table Row (tr)
iddes
Table Cell (td)
Div
classsIndent
Returns a JSColumn for the named column (or column dataproviderID).
Table Row (tr)
idprs
Table Cell (td)Parameters
Div
classsIndent
{String} name – Table Row (tr)idcolumnName ;type ;length ;allowNull ;pkColumn ;ret

Returns

sIndent
clients

Supported Clients

sIndentSmartClient,WebClient,NGClient
sam

Sample

sIdentjavascript
lastDetailRow
deleteColumnname

deleteColumn(columnName)

dessIndent
Deletes the column with the specified name from this table. The column is not actually deleted from the database until this
table is synchronized with the database using the JSServer.synchronizeWithDB method.
prs

Parameters

sIndentcolumnName ;
clients

Supported Clients

sIndentSmartClient,WebClient,NGClient
sam

Sample

sIdentjavascript
lastDetailRow
getColumnname

getColumn(name)

dessIndent
Returns a JSColumn for the named column (or column dataproviderID).
prs

Parameters

sIndentnameThe name of the column to return the value from.
tdret

Returns


DivclassJSColumn

sIndent JSColumn column.clients

Table Row (tr)
idsam
Table Cell (td)
Sample
Div
classsIndent
Code Block
languagejavascript

var jsTable = databaseManager.getTable('udm', 'campaigns')
var jsColumn = jsTable.getColumn('campaign_name')
Table Row (tr)
classlastDetailRow
Table Cell (td) Table Body (tbody)
idgetColumnNames
Table Row (tr)
idname
Table Cell (td)
getColumnNames
Table Row (tr)
idsig
Table Cell (td)
Span
stylemargin-right: 5px;
String[]
Span
stylefont-weight: bold;
getColumnNames
Span
()
Table Row (tr)
iddes
Table Cell (td)
Div
classsIndent
Returns an array containing the names of all table columns.
Table Row (tr)
idret
Table Cell (td)
Returns
Div
classsIndent
String[] – String array of column names.
Table Row (tr)
idsam
Table Cell (td)
Sample
Div
classsIndent
Code Block
languagejavascript

var jsTable = databaseManager.getTable('udm', 'campaigns')
var columnNames = jsTable.getColumnNames()
Table Row (tr)
classlastDetailRow
Table Cell (td) Table Body (tbody)
idgetDataSource
Table Row (tr)
idname
Table Cell (td)
getDataSource
Table Row (tr)
idsig
Table Cell (td)
Span
stylemargin-right: 5px;
String
Span
stylefont-weight: bold;
getDataSource
Span
()
Table Row (tr)
iddes
Table Cell (td)
Div
classsIndent
Returns the table data source uri.
Table Row (tr)
idret
Table Cell (td)
Returns
Div
classsIndent
String – String datasource uri.
Table Row (tr)
idsam
Table Cell (td)
Sample
Div
classsIndent
Code Block
languagejavascript

var jsTable = databaseManager.getTable('udm', 'campaigns')
var dataSource = jsTable.getDataSource()
Table Row (tr)
classlastDetailRow
Table Cell (td) Table Body (tbody)
idgetQuotedSQLName
Table Row (tr)
idname
Table Cell (td)
getQuotedSQLName
Table Row (tr)
idsig
Table Cell (td)
Span
stylemargin-right: 5px;
String
Span
stylefont-weight: bold;
getQuotedSQLName
Span
()
Table Row (tr)
iddes
Table Cell (td)
Div
classsIndent
Returns a quoted version of the table name, if necessary, as defined by the actual database used.
Table Row (tr)
idret
Table Cell (td)Returns
Div
classsIndent
String – String td

Supported Clients

sIndentSmartClient,WebClient,NGClient
sam

Sample

sIdentjavascript
lastDetailRow
getColumnNamesname

getColumnNames()

dessIndent
Returns an array containing the names of all table columns.
If the table is in mem, then the internal rowid column name is not returned.
ret

Returns

sIndent String array of column names.
clients

Supported Clients

sIndentSmartClient,WebClient,NGClient
sam

Sample

sIdentjavascript
lastDetailRow
getDataSourcename

getDataSource()

dessIndent
Returns the table data source uri.
ret

Returns

sIndent String datasource uri.
clients

Supported Clients

sIndentSmartClient,WebClient,NGClient
sam

Sample

sIdentjavascript
lastDetailRow
getQuotedSQLNamename

getQuotedSQLName()

dessIndent
Returns a quoted version of the table name, if necessary, as defined by the actual database used.
ret

Returns

sIndent String table name, quoted if needed.
clients

Table Row (tr)

idsam
//use with the raw SQL plugin: //if the table name contains characters that are illegal in sql,

Supported Clients

sIndentSmartClient,WebClient,NGClient
sam

Sample

Div
classsIndent
Code Block
languagejavascript
sIdentjavascriptlastDetailRowgetRowIdentifierColumnNamesname

getRowIdentifierColumnNames()

dessIndent
Returns an array containing the names of the identifier (PK) column(s).
 Please note that if the table 
name
is 
will be quoted var jsTable = databaseManager.getTable('udm', 'campaigns') var quotedTableName = jsTable.getQuotedSQLName() plugins.rawSQL.executeSQL('udm', quotedTableName, 'select * from ' + quotedTableName + ' where is_active = ?', [1]) Table Row (tr)
classlastDetailRow
Table Cell (td) Table Body (tbody)
idgetRowIdentifierColumnNames
Table Row (tr)
idname
Table Cell (td)
getRowIdentifierColumnNames
Table Row (tr)
idsig
Table Cell (td)
Span
stylemargin-right: 5px;
String[]
Span
stylefont-weight: bold;
getRowIdentifierColumnNames
Span
()
Table Row (tr)
iddes
Table Cell (td)
Div
classsIndent
Returns an array containing the names of the identifier (PK) column(s).
Table Row (tr)
idret
Table Cell (td)Returns
Div
classsIndent
String[] – id
in mem, then the internal rowid column name is also returned.
ret

Returns

sIndent String array of row identifier column names.
clients

Table Row (tr)

Supported Clients

sIndentSmartClient,WebClient,NGClient
sam

Table Cell (td) Table Row (tr)

classlastDetailRow
Table Cell (td) Table Body (tbody)
idgetSQLName
Table Row (tr)
idname
Table Cell (td)
getSQLName
Table Row (tr)
idsig
Table Cell (td)
Span
stylemargin-right: 5px;
String
Span
stylefont-weight: bold;
getSQLName
Span
()
Table Row (tr)
iddes
Table Cell (td)
Div
classsIndent
Returns the table name.
Table Row (tr)
idret
Table Cell (td)
Returns
Div
classsIndent
String – String table name.
Table Row (tr)
idsam
Table Cell (td)
Sample
Div
classsIndent
Code Block
languagejavascript

var jsTable = databaseManager.getTable('udm', 'campaigns')
var tableNameForDisplay = jsTable.getSQLName()
Table Row (tr)
classlastDetailRow
Table Cell (td) Table Body (tbody)
idgetServerName
Table Row (tr)
idname
Table Cell (td)
getServerName
Table Row (tr)
idsig
Table Cell (td)
Span
stylemargin-right: 5px;
String
Span
stylefont-weight: bold;
getServerName
Span
()
Table Row (tr)
iddes
Table Cell (td)
Div
classsIndent
Returns the Servoy server name.
Table Row (tr)
idret
Table Cell (td)
Returns
Div
classsIndent
String – String server name.
Table Row (tr)
idsam
Table Cell (td)
Sample
Div
classsIndent
Code Block
languagejavascript

var jsTable = databaseManager.getTable('udm', 'campaigns')
var serverName = jsTable.getServerName()
Table Row (tr)
classlastDetailRow
Table Cell (td) Table Body (tbody)
idisMetadataTable
Table Row (tr)
idname
Table Cell (td)
isMetadataTable
Table Row (tr)
idsig
Table Cell (td)
Span
stylemargin-right: 5px;
Boolean
Span
stylefont-weight: bold;
isMetadataTable
Span
()
Table Row (tr)
iddes
Table Cell (td)
Div
classsIndent
Returns whether table was flagged as metadata table.
Table Row (tr)
idret
Table Cell (td)
Returns
Div
classsIndent
Boolean – boolean is metadata
Table Row (tr)
idsam
Table Cell (td)
Sample
Div
classsIndent
Code Block
languagejavascript

var jsTable = databaseManager.getTable('udm', 'campaigns')
var isMetaDataTable = jsTable.isMetadataTable()
Table Row (tr)
classlastDetailRow
td

Sample

Div
classsIndent
Code Block
languagejavascript

var jsTable = databaseManager.getTable('udm', 'campaigns')
var identifierColumnNames = jsTable.getRowIdentifierColumnNames()
sIdentjavascriptlastDetailRowgetSQLNamename

getSQLName()

dessIndent
Returns the table name.
ret

Returns

sIndent String table name.
clients

Supported Clients

sIndentSmartClient,WebClient,NGClient
sam

Sample

sIdentjavascript
lastDetailRow
getServerNamename

getServerName()

dessIndent
Returns the Servoy server name.
ret

Returns

sIndent String server name.
clients

Supported Clients

sIndentSmartClient,WebClient,NGClient
sam

Sample

sIdentjavascript
lastDetailRow
isMetadataTablename

isMetadataTable()

dessIndent
Returns whether table was flagged as metadata table.
ret

Returns

sIndent boolean is metadata
clients

Supported Clients

sIndentSmartClient,WebClient,NGClient
sam

Sample

sIdentjavascript
lastDetailRow