Difference between revisions of "Taxonomy 1 0-getCSTaxObj"

From ADF Docs
Jump to: navigation, search
m (Reverted edits by Ecaxabu (Talk) to last revision by Rwest)
 
(4 intermediate revisions by 3 users not shown)
Line 5: Line 5:
  
 
== Description ==  
 
== Description ==  
[[taxonomy_1_0|Return to taxonomy_1_0]]
 
 
 
Returns the taxonomy object for a given taxonomy name
 
Returns the taxonomy object for a given taxonomy name
  
Line 33: Line 31:
 
 
 
</table>
 
</table>
 +
 +
== Examples ==
 +
 +
Using the getCSTaxObj function is simple and straight forward. Making a call to this method will return a component which contains all of the Taxonomy API calls available in the CommonSpot Taxonomy.
 +
 +
=== CE Data calls return Taxonomy Term ID ===
 +
If you have Taxonomy fields inside your Custom Element and you make calls to get data for that custom Element using CEData, the Taxonomy fields will return term ID's.  You can convert those term ID's using code like this:
 +
<source lang="cfm">
 +
<cfscript>
 +
    // custom element data
 +
    data = application.ADF.ceData.getCEData("My Element");
 +
    // returns taxonomy object
 +
    taxObj = application.ADF.taxonomy.getCSTaxObj("My Taxonomy");
 +
</cfscript>
 +
 +
<cfloop from="1" to="#arrayLen(data)#" index="itm">
 +
    <!---// renders the term name instead of the term id --->
 +
    <cfoutput>#taxObj.getTermName(data[itm].values.myTaxField)#</cfoutput>
 +
</cfloop>
 +
</source>

Latest revision as of 17:40, 24 November 2010

Attention: Do not change any text in the description, signature, and paramter sections.

Return to Taxonomy_1_0

Description

Returns the taxonomy object for a given taxonomy name

Signature

public any getCSTaxObj ( string taxName )

Parameters

Required Name Type Description
required taxName string

Examples

Using the getCSTaxObj function is simple and straight forward. Making a call to this method will return a component which contains all of the Taxonomy API calls available in the CommonSpot Taxonomy.

CE Data calls return Taxonomy Term ID

If you have Taxonomy fields inside your Custom Element and you make calls to get data for that custom Element using CEData, the Taxonomy fields will return term ID's. You can convert those term ID's using code like this:

 <cfscript>
     // custom element data
     data = application.ADF.ceData.getCEData("My Element");
     // returns taxonomy object
     taxObj = application.ADF.taxonomy.getCSTaxObj("My Taxonomy");
 </cfscript>

 <cfloop from="1" to="#arrayLen(data)#" index="itm">
    <!---// renders the term name instead of the term id --->
    <cfoutput>#taxObj.getTermName(data[itm].values.myTaxField)#</cfoutput>
 </cfloop>