Home >	Contents >	Index >

Template Tags TOC   |    Alpha TOC   |    Tag Family TOC   |    Purpose TOC   |    Annotated TOC   |    Index

---

ics:catalogmanager.updaterow

Updates field values for a row in a table using ics:catalogmanager.

Syntax

<ics:catalogmanager>
<ics:argument name="ftcmd" value="updaterow" />
<ics:argument name="tablename" value="table" />
[<ics:argument name="columnname" value="column name"/>]
[<ics:argument name="urlcolumnname_folder" value="folder name"/>]
[<ics:argument name="columnname_file" value="file name"/>]
[<ics:argument name="tablekey" value="column name"/>]
[<ics:argument name="tablekeyvalue" value="value"/>]
</ics:catalogmanager>

Parameters

ftcmd (required)

Value must be set to updaterow.

tablename (required)

Name of the table containing the row to be updated.

columnname (optional)

Each column in the row to be modified. columnname is a table column name.

In absence tablekey and tablevalue attributes specified, one of the columnnames must be primary key for the table.

urlcolumnname_folder (optional)

Subfolder name to store the uploaded file. The file is then stored under the upload folder and the subfolder. The upload folder is specified in the SystemInfo table's defdir column. You can have multiple upload columns.

Upload columns are designated by the prefix url. The column name in the table must begin with url (for example, urltext). The argument name must include the table's column name with _folder appended to the column name (for example, urltext_folder).

columnname_file (required for non-binary files)

Name of the file you want to upload. The column name in the table must begin with url (for example, urltext). The agrument name must have _file appended to the table's column name (for example, urltext_file).

tablekey (optional)

Use the tablekey parameter if you want to update rows based on a value other than the primary key. The value of tablekey is the column name of the column you use to perform the update.

tablekeyvalue (optional)

Value in the tablekey columm of the row you want to update.

This parameter is required only if the tablekey parameter is used.

Description

The updaterow command updates field values for a row in a table. For each column and specified value, the existing column value is replaced with the incoming data for that column. Only values specified are changed; you can not clear a value in a table row or column by using editrows or updaterows. You must use ics:catalogmanager.replacerow or ics:catalogmanager.updaterow2 .

Error Numbers

The possible values of errno include:

Value	Description
-103	No such table.
-104	No table definition.
-105	Database error.

Example

The following example updates the ExampleTable's row (id-=100).

Original data

id	description	quantity
100	Apple	100
102	Grape	300

<ics:catalogmanager>
    <ics:argument name="ftcmd" value="updaterow"/>
    <ics:argument name="tablename" value="ExampleTable"/>
    <ics:argument name="id" value="100"/>
    <ics:argument name="description" value="Apple"/>
    <ics:argument name="quantity" value="300"/>
</ics:catalogmanager>

Changed data

id	description	quantity
100	Apples	300
102	Grape	300

See Also

The following ics:catalogmanager commands:

ics:catalogmanager.replacerow

ics:catalogmanager.updaterow2

ics.catalogmanager.updaterows

		Home >	Contents >	Index >
	Oracle JSP Tag Reference Copyright (c) 2013, Oracle and/or its affiliates. All rights reserved.