multirow is really template::multirow or possibly template::query::multirow depending on context. the "template::" or "template::query::" may be omitted depending on what the namespace is. .tcl pages are evaluated in the template:: namespace. DEPRECATED: namespace should actually NOT be omitted

Switches:

-ulevel

(defaults to "1") (optional)

-local

(boolean) (optional)

-unclobber

(boolean) (optional)

Parameters:

op
name

See Also:

• template::multirow
• template::query::multirow

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Generic Caching

Parameters:

command
cache_key

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Create/Manipulate a multirow datasource (for use with <multiple> tags)

template::multirow create datasourcename column [column ...]

creates a multirow datasource of datasourcename

template::multirow extend datasourcename column [column ...]

extend adds a column to an existing multirow

template::multirow append datasourcename value [value ...]

appends the row to an existing multirow.

template::multirow pop datasourcename

pops a row off an existing multirow, returning a list of the rows keys gand values

template::multirow size datasourcename

returns the rowcount

template::multirow columns datasourcename

returns the columns in the datasource

template::multirow get datasourcename rownum [column]

returns the row of data (or the particular row/column if column is provided)

template::multirow set datasourcename rownum column value

set an element value

template::multirow foreach datasource code

evaluate code block for each row (like db_foreach)

template::multirow upvar datasource [new_name]

upvar the multirow, aliasing to new_name if provided

template::multirow unset datasource

unset multirow

template::multirow sort datasource -lsort-switch col1 col2

Sort the multirow by the column(s) specified. The value sorted by will be the values of the columns specified, separated by the space character. Any switches specified before the columns will be passed directly to the lsort command.

template::multirow exists datasource

Return 1 if the multirow datasource exists, 0 if it doesn't.

Switches:

-ulevel

(defaults to "1") (optional)

Used in conjunction with the "local" parameter to specify how many levels up the multirow variable resides.

-local

(boolean) (optional)

If set, the multirow will be looked for in the scope the number of levels up given by ulevel (normally the caller's scope), instead of the [template::adp_level] scope, which is the default.

-unclobber

(boolean) (optional)

This only applies to the 'foreach' command. If set, will cause the proc to not overwrite local variables. Actually, what happens is that the local variables will be overwritten, so you can access them within the code block. However, if you specify -unclobber, we will revert them to their original state after execution of this proc.

Parameters:

command - Multirow datasource operation: create, extend, append, pop, size, get, set, foreach, upvar
name - Name of the multirow datasource

See Also:

• db_multirow
• template::query::multirow

Partial Call Graph (max 5 caller/called nodes):

Testcases:

db__transaction_bug_3440, util_user_messages, templates_and_scripts

Public interface to template query api. This routine parses the arguments and dispatches to the query command specified by the type argument.

Parameters:

statement_name - Standard db_api query name
result_name - Tcl variable name when doing an uplevel to set the returned result
type - The query type
sql - The sql to be used for the query

Options:

-maxrows

Limits the query results of a multirow query to a fixed number of rows.

-cache

Cache the query results keyed on an identifier that is unique for both the query and the bind variables used in the query. The cached result reflects any initial specification of maxrows and startrows.

-refresh

Force a query to be performed even if it is cached, and refresh the cache.

Only applicable if the cache option is specified as well. Does not affect a previously specified timeout period.

-timeout

The maximum period of time for which the cached results are valid in seconds. Only applicable for persistently cached results.

-persistent

Cache the query results persistently, so that all subsequent requests use the results.

Returns:

1 if query was a success, 0 if it failed

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Maintains an ns_set of parameters that can be bulk converted to URL parameters. It is not clear if this API makes a lot of sense, many alternatives exist to export parameters in various forms...

Parameters:

command - one of 'set_param *name* *value*' (set a parameter), 'get_param *name* *default*' (get a parameter value), or 'get_query' (export all parameters as URL query).

See Also:

• export_vars

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.