User Guide

Chapter 1: ColdFusion Tags 113
TABLENAME
Required. Name of the table you want the form fields inserted in. Note the
following:
• ORACLE drivers — This specification must be in uppercase.
• Sybase driver — This specification is case-sensitive and must be in the same
case as that used when the table was created
TABLEOWNER
Optional. For data sources that support table ownership (such as SQL Server,
Oracle, and Sybase SQL Anywhere), use this field to specify the owner of the table.
TABLEQUALIFIER
Optional. For data sources that support table qualifiers, use this field to specify the
qualifier for the table. The purpose of table qualifiers varies across drivers. For SQL
Server and Oracle, the qualifier refers to the name of the database that contains
the table. For the Intersolv dBase driver, the qualifier refers to the directory where
the DBF files are located.
USERNAME
Optional. If specified, USERNAME overrides the username value specified in the
ODBC setup.
PASSWORD
Optional. If specified, PASSWORD overrides the password value specified in the
ODBC setup.
PROVIDER
Optional. COM provider (OLE-DB only).
PROVIDERDSN
Optional. Data source name for the COM provider (OLE-DB only).
FORMFIELDS
Optional. A comma-separated list of form fields to insert. If this attribute is not
specified, all fields in the form are included in the operation.
Example <!--- This example shows how to use CFINSERT instead of CFQUERY
to place data into a datasource. --->
<!--- if form.POSTED exists, we are inserting a new record,
so begin the CFINSERT tag --->
<CFIF IsDefined ("form.posted")>
<CFINSERT DATASOURCE="cfsnippets"
TABLENAME="Comments"
FORMFIELDS="Email,FromUser,Subject,MessText,Posted">
<H3><I>Your record was added to the database.</I></H3>
</CFIF>
<!--- use a query to show the existing state of the database --->
<CFQUERY NAME="GetComments" DATASOURCE="cfsnippets">