Difference between revisions of "CEData 1 0-getCEData"
From ADF Docs
Gcronkright (talk | contribs) (→Usage:) |
Gcronkright (talk | contribs) (→Usage:) |
||
Line 85: | Line 85: | ||
<source lang="cfm"> | <source lang="cfm"> | ||
<cfscript> | <cfscript> | ||
− | // get data | + | // get data from the "My Element" custom element |
data = application.ADF.ceData.getCEData( | data = application.ADF.ceData.getCEData( | ||
customElementName="My Element" | customElementName="My Element" | ||
Line 101: | Line 101: | ||
<source lang="cfm"> | <source lang="cfm"> | ||
<cfscript> | <cfscript> | ||
− | // get data | + | // get data from the "My Element" custom element by a uniqueID value |
data = application.ADF.ceData.getCEData( | data = application.ADF.ceData.getCEData( | ||
customElementName="My Element", | customElementName="My Element", |
Revision as of 21:42, 13 August 2010
Attention: Do not change any text in the description, signature, and paramter sections.
Return to CEData_1_0
Description
Returns array of structs for all data matching the Custom Element.
Signature
public array getCEData ( string customElementName, string customElementFieldName, any item, string queryType, string searchValues, string searchFields )
Parameters
Required | Name | Type | Description |
required | customElementName | string | |
optional | customElementFieldName | string | [Default: ] |
item | any | [Default: ] | |
queryType | string | [Default: selected] | |
searchValues | string | [Default: ] | |
searchFields | string | [Default: ] |
Examples
The getCEDdata function is handy way to get data out of a CommonSpot Custom Element. Making a call to this method will return an Array of Structures of the data contained in the element specified.
Usage:
Example 1: Use getCEData to get ALL records in a Custom Element:
<cfscript>
// get data from the "My Element" custom element
data = application.ADF.ceData.getCEData(
customElementName="My Element"
);
</cfscript>
<!---// loop over results (will be all records from the Custom Element) --->
<cfloop from="1" to="#arrayLen(data)#" index="itm">
<!---// renders data from the uniqueID and Title fields from the element --->
<cfoutput>#data[itm].values.uniqueID# #data[itm].values.Title#</cfoutput>
</cfloop>
Example 2: Use getCEData to get only the records that match the provided value for a specific field:
<cfscript>
// get data from the "My Element" custom element by a uniqueID value
data = application.ADF.ceData.getCEData(
customElementName="My Element",
customElementFieldName="uniqueID",
item='DF6D9B32-1143-FF53-952805B368AB301B'
);
</cfscript>
<!---// loop over results (will only be records that matched the criteria) --->
<cfloop from="1" to="#arrayLen(data)#" index="itm">
<!---// renders data from the uniqueID and Title fields from the element --->
<cfoutput>#data[itm].values.uniqueID# #data[itm].values.Title#</cfoutput>
</cfloop>