Page History

Divcache

Div

id	description

Excerpt Include

The Servoy Foundset

nopanel

true

HTML Table

id

class

servoy sSummary

Colgroup Tag

Col

width	80px

Col

Table Head (thead)

Table Row (tr)

style	height: 30px;

Table Head (th)

colspan	2

Method Summary

Table Row (tr)

Table Cell (td)
Boolean

Table Cell (td)next()

indexstyle	true	display: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.

refresh	100d
showRefresh	true
id	doc
title	Refresh page
showDate	true
retry	Enable

servoy sReturnTypes2100%height: 30px;2Supported ClientssWordListSmartClientsWordListWebClientsWordListNGClient

Table Cell (td)
Boolean

Table Cell (td)performUpdate()

servoy sSummary

12%

30%

58%

height: 30px;

3

Methods Summary

Go to next record in this updater, returns true if successful.

Table Row (tr)

Do the actual update in the database, returns true if successful.

Table Row (tr) Table Cell (td) Table Cell (td)resetIterator()

void

Start over with this iterator 'next' function (at the foundset selected record).

Table Row (tr)

Table Cell (td)
Boolean

Table Cell (td)setColumn(name, value)

Set the column value to update, returns true if successful.

table

id

functionclass Colgroup Tag Colcolspanservoy sDetail2width100%

Col

Table Head (thead) Table Row (tr)style

height:30px

;

Table Head (th)

colspan	2

Method Details

Table Body (tbody)

id	next

Table Row (tr)

id	name

Table Cell (td)
next

Table Row (tr)

id	sig

Table Cell (td)

Span

style	margin-right: 5px;

Boolean

Span

style	font-weight: bold;

Span
()

Table Row (tr)

id	des

Table Cell (td)

Div

class	sIndent

Go to next record in this updater, returns true if successful.

Table Row (tr)

id	ret

Table Cell (td)

Returns

Div

class	sIndent

Boolean - Table Row (tr)

id	ret

Table Cell (td)

Returns

Div

class	sIndent

Boolean -

2

Methods Details

next()

des

sIndent

Go to next record in this updater, returns true if successful.
NOTE: this method doesn't take into account deletes and inserts that may happen at same time. For more reliable iterator see foundset.forEach

ret

Returns

sIndent

true if proceeded to next record, false otherwise

clients

Table Row (tr)

id	sam

Table Cell (td)

Sample

Div

class	sIndent

Code Block

language	javascript

controller.setSelectedIndex(1)
var count = 0
var fsUpdater = databaseManager.getFoundSetUpdater(foundset)
while(fsUpdater.next())
{
	fsUpdater.setColumn('my_flag',count++)
}

Table Row (tr)

class	lastDetailRow

Table Cell (td)

Table Body (tbody)

id	performUpdate

Table Row (tr)

id	name

Table Cell (td)
performUpdate

Table Row (tr)

id	sig

Table Cell (td)

Span

style	margin-right: 5px;

Boolean

Span

style	font-weight: bold;

performUpdate

Span
()

Table Row (tr)

id	des

Table Cell (td)

Div

class	sIndent

Do the actual update in the database, returns true if successful.
There are 3 types of possible use with the foundset updater
1) update entire foundset by a single sql statement; that is not possible when the table of the foundset has tracking enabled then it will loop over the whole foundset.
When a single sql statement is done, modification columns will not be updated, because it does the update directly in the database, without getting the records.
2) update part of foundset, for example the first 4 row (starts with selected row)
3) safely loop through foundset (starts with selected row)

after the perform update call there are no records in edit mode, that where not already in edit mode, because all of them are saved directly to the database,
or in mode 1 the records are not touched at all and the database is updated directly.

Table Body (tbody)

id	resetIterator

Table Row (tr)

id	name

Table Cell (td)
resetIterator

Table Row (tr)

id	sig

Table Cell (td)

Span

style	margin-right: 5px;

void

Span

style	font-weight: bold;

resetIterator

Span
()

Table Row (tr)

id	des

Table Cell (td)

Div

class	sIndent

Start over with this iterator 'next' function (at the foundset selected record).

Table Row (tr)

id	ret

Table Cell (td)

Returns

Div

class	sIndent

void

Table Row (tr)

id	sam

Table Cell (td)

Sample

Div

class	sIndent

Code Block

language	javascript

controller.setSelectedIndex(1)
var count = 0
var fsUpdater = databaseManager.getFoundSetUpdater(foundset)
while(fsUpdater.next())
{
	fsUpdater.setColumn('my_flag',++count)
}
fsUpdater.resetIterator()
while(fsUpdater.next())
{
	fsUpdater.setColumn('max_flag',count)
}

Table Row (tr)

class	lastDetailRow

Table Cell (td)

Table Body (tbody)

id	setColumn-String_Object

Table Row (tr)

id	name

Table Cell (td)
setColumn

Table Row (tr)

id	sig

Table Cell (td)

Span

style	margin-right: 5px;

Boolean

Span

style	font-weight: bold;

setColumn

Span
(name, value)

Table Row (tr)

id	des

Table Cell (td)

Div

class	sIndent

Set the column value to update, returns true if successful.

Table Row (tr)

id	prs

Table Cell (td)

Parameters

Div

class	sIndent

{String} name -

Supported Clients

sIndent

SmartClient,WebClient,NGClient

sam

Sample

sIdent

javascript

lastDetailRow

performUpdate

name

performUpdate()

des

sIndent

Do the actual update in the database, returns true if successful. It will first try to save all editing records (from all foundsets), if cannot save will return false before doing the update.
There are 3 types of possible use with the foundset updater
1) update entire foundset by a single sql statement; that is not possible when the table of the foundset has tracking enabled then it will loop over the whole foundset.
   When a single sql statement is done, modification columns will not be updated and associated Table Events won't be triggered, because it does the update directly in the database, without getting the records.
  NOTE: this mode will refresh all foundsets based on same datasource
2) update part of foundset, for example the first 4 row (starts with selected row)
3) safely loop through foundset (starts with selected row)

after the perform update call there are no records in edit mode, that where not already in edit mode, because all of them are saved directly to the database,
or in mode 1 the records are not touched at all and the database is updated directly.

ret

Returns

sIndent

true if succeeded, false if failed.

clients

Table Row (tr)

id	sam

Table Cell (td)

Sample

Div

class	sIndent

Code Block

language	javascript

//1) update entire foundset
var fsUpdater = databaseManager.getFoundSetUpdater(foundset)
fsUpdater.setColumn('customer_type',1)
fsUpdater.setColumn('my_flag',0)
fsUpdater.performUpdate()

//2) update part of foundset, for example the first 4 row (starts with selected row)
var fsUpdater = databaseManager.getFoundSetUpdater(foundset)
fsUpdater.setColumn('customer_type',new Array(1,2,3,4))
fsUpdater.setColumn('my_flag',new Array(1,0,1,0))
fsUpdater.performUpdate()

//3) safely loop through foundset (starts with selected row)
controller.setSelectedIndex(1)
var count = 0
var fsUpdater = databaseManager.getFoundSetUpdater(foundset)
while(fsUpdater.next())
{
	fsUpdater.setColumn('my_flag',count++)
}

Table Row (tr)

class	lastDetailRow

Table Cell (td)

Supported Clients

sIndent

SmartClient,WebClient,NGClient

sam

Sample

sIdent

javascript

lastDetailRow

resetIterator

name

resetIterator()

des

sIndent

Start over with this iterator 'next' function (at the foundset selected record).

clients

Supported Clients

sIndent

SmartClient,WebClient,NGClient

sam

Sample

sIdent

javascript

lastDetailRow

setColumn

name

setColumn(name, value)

des

sIndent

Set the column value to update, returns true if successful.

prs

Parameters

sIndent

name

The name of the column to update.

{Object}

value

- Table Row (tr)id

The new value (can be an array with data for x number of rows) to be stored in the specified column.

td

ret

class

Returns

DivBoolean -

sIndent

Table Row (tr)

class	lastDetailRow

Table Cell (td)

true if succeeded, false if failed.

clients

Table Row (tr)

id	sam

Table Cell (td)

Sample

Div

class	sIndent

Code Block

language	javascript

//1) update entire foundset
var fsUpdater = databaseManager.getFoundSetUpdater(foundset)
fsUpdater.setColumn('customer_type',1)
fsUpdater.setColumn('my_flag',0)
fsUpdater.performUpdate()

//2) update part of foundset, for example the first 4 row (starts with selected row)
var fsUpdater = databaseManager.getFoundSetUpdater(foundset)
fsUpdater.setColumn('customer_type',new Array(1,2,3,4))
fsUpdater.setColumn('my_flag',new Array(1,0,1,0))
fsUpdater.performUpdate()

//3) safely loop through foundset (starts with selected row)
controller.setSelectedIndex(1)
var count = 0
var fsUpdater = databaseManager.getFoundSetUpdater(foundset)
while(fsUpdater.next())
{
	fsUpdater.setColumn('my_flag',count++)
}

Supported Clients

sIndent

SmartClient,WebClient,NGClient

sam

Sample

sIdent

javascript

lastDetailRow

Child pages

Versions Compared

Old Version 24

New Version Current

Key

next

next()

performUpdate

resetIterator

setColumn

performUpdate()

resetIterator()

setColumn(name, value)