Home > Contents > Index >
Template Tags TOC | Alpha TOC | Tag Family TOC | Purpose TOC | Annotated TOC | Index
ics:catalogmanager.updaterow2
Updates or clears values in columns for a row in a table using
ics:catalogmanager.
Syntax
<ics:catalogmanager>
<ics:argument name="ftcmd" value="updaterow2" /> <ics:argument name="tablename" value="table" /> [<ics:argument name="columnname" value="columnname"]/>] [<ics:argument name="urlcolumnname_folder" value="folder name"]/>] [<ics:argument name="columnname_file" value="file name"]/>] [<ics:argument name="tablekey" value="key value"]/>] [<ics:argument name="tablekeyvalue" value="value"]/>] [<ics:argument name="updaterowNullColumns" value="column1, column2"/>]</ics:catalogmanager>Parameters
ftcmd (required)
- Value must be set to
updaterow2
.
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 withurl
(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 argument 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 oftablekey
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 thetablekey
parameter is used.
updaterowNullColumns (optional)
- A comma-separated list of columns that are to be cleared if no data is supplied when the user submits a form.
- Note that if this list is supplied, other columns are ignored and is not cleared.
Description
Like
ics:catalogmanager.updaterow
,updaterow2
updates values in columns for a row in a table; however, in contrast toupdaterow
, which does not allow you to clear columns,updaterow2
allows you to clear columns if there is no value for the specified column (for example, if there is no related field in the form, or if the field on the form was left blank).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 clears the contents of quantity column in ExamplesTable for id=100
Orignal data
id description quantity 100 Apple 100 102 Grape 300 <ics:catalogmanager> <ics:argument name="ftcmd" value="updaterow2"/> <ics:argument name="tablename" value="ExampleTable"/> <ics:argument name="id" value="100"/> <ics:argument name="description" value="Apple"/> </ics:catalogmanager>Changed data
id description quantity 100 Apple 102 Grape 300
See Also
The following
ics:catalogmanager
commands:ics.catalogmanager.updaterows2
Home > Contents > Index > ![]()
Oracle JSP Tag Reference
Copyright (c) 2013, 2015, Oracle and/or its affiliates. All rights reserved.