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).

...

Table Cell (td)
String

...

Returns the table name.

...

...

Returns the Servoy server name.

...

Table Cell (td)
Boolean
Returns whether table was flagged as metadata table.

...

function

...

servoy sDetail

...

padding0px
width100%

...

2100%height:30px

...

Table Head (th)
colspan1
Method Details

...

idcreateNewColumn-String_Number_Number
Table Row (tr)
idname
Table Cell (td)
createNewColumn

...

idsig

...

Span
stylemargin-right: 5px;
JSColumnObject
Span
stylefont-weight: bold;
createNewColumn

...

2Methods DetailscreateNewColumnname

createNewColumn(columnName, type, length)

...

des

...

sIndent
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.

...

prs

...

Parameters

...

sIndent

...

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.");
	}
}

...

classlastDetailRow

...

idcreateNewColumn-String_Number_Number_Boolean
Table Row (tr)
idname
Table Cell (td)
createNewColumn

...

idsig

...

Span
stylemargin-right: 5px;
JSColumnObject
Span
stylefont-weight: bold;
createNewColumn

...

...

columnName ;type ;length ;ret

Returns

sIndent
clients

Supported Clients

sIndentSmartClient,WebClient,NGClient
sam

Sample

sIdentjavascript
lastDetailRow
createNewColumnname

createNewColumn(columnName, type, length, allowNull)

...

des

...

sIndent
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.

...

prs

...

Parameters

...

...

sIndent

...

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.");
	}
}

...

classlastDetailRow

...

idcreateNewColumn-String_Number_Number_Boolean_Boolean
Table Row (tr)
idname
Table Cell (td)
createNewColumn

...

idsig

...

Span
stylemargin-right: 5px;
JSColumnObject
Span
stylefont-weight: bold;
createNewColumn

...

...

columnName ;type ;length ;allowNull ;ret

Returns

sIndent
clients

Supported Clients

sIndentSmartClient,WebClient,NGClient
sam

Sample

sIdentjavascript
lastDetailRow
createNewColumnname

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

...

des

...

sIndent
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.

...

prs

...

Parameters

...

...

sIndent

...

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.");
	}
}

...

classlastDetailRow

...

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);
	}
}

...

classlastDetailRow

...

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).

...

idprs

...

classsIndent

...

...

columnName ;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.

...

ret

...

Returns

...

...

sIndent

...

...

JSColumn column.clients

...

Supported Clients

sIndentSmartClient,WebClient,NGClient
sam

...

idret

...

classsIndent

...

Sample

...

classsIndent

...

Code Block
languagejavascript
var jsTable = databaseManager.getTable('udm', 'campaigns')
var jsColumn = jsTable.getColumn('campaign_name')

...

classlastDetailRow

...

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()

...

classlastDetailRow

...

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()

...

classlastDetailRow

...

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.

...

sIdentjavascriptlastDetailRowgetColumnNamesname

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

...

idsam

...

classlastDetailRow

...

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).

...

idret

...

classsIndent

...

Supported Clients

sIndentSmartClient,WebClient,NGClient
sam

Sample

...

classsIndent

...

Code Block
languagejavascript
//use with the raw SQL plugin:
//if the table name contains characters that are illegal in sql, the table name 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])

...

sIdentjavascriptlastDetailRowgetRowIdentifierColumnNamesname

getRowIdentifierColumnNames()

dessIndent
Returns an array containing the names of the identifier (PK) column(s).
 Please note that if the table is in mem, then the internal rowid column name is also returned.
ret

Returns

sIndent String array of row identifier column names.
clients

...

Supported Clients

sIndentSmartClient,WebClient,NGClient
sam

...

classlastDetailRow

...

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()

...

classlastDetailRow

...

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()

...

classlastDetailRow

...

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()

...

classlastDetailRow

...

Sample

...

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