Difference between revisions of "Troubleshooting"

From ADF Docs
Jump to: navigation, search
(ColdFusion Error Msg: Element logging is undefined in a CFML structure referenced as part of an expression.)
Line 1: Line 1:
 
=== ADF is not reseting ===
 
=== ADF is not reseting ===
Make sure that you are logged into the site.  The IF block in the custom-application.cfm code requires the user to be logged into the site to reset the ADF.  See the [[Reset_ADF|Reset ADF]] wiki page for more info.
+
Make sure you're logged into the site.  The IF block in the custom-application.cfm code requires the user to be logged into the site to reset the ADF.  See the [[Reset_ADF|Reset ADF]] wiki page for more info.
  
 
=== ADF Applications AppBeanConfig is not updating the sites Application variables ===
 
=== ADF Applications AppBeanConfig is not updating the sites Application variables ===
Line 12: Line 12:
 
The ADF version schema is based on ''major_minor_revisions''.
 
The ADF version schema is based on ''major_minor_revisions''.
  
See [[Library_Component_Versions|ADF Library Component Versions]] wiki page for details on ADF versioning schema.
+
See the [[Library_Component_Versions|ADF Library Component Versions]] wiki page for details on ADF versioning schema.
  
 
=== Changes to your application components are not seen ===
 
=== Changes to your application components are not seen ===
If for some reason you use the "ResetServerADF" and "ResetApplicationADF" parameters and changes to your Application components is still not seen try the following:
+
If you use the "ResetServerADF" and "ResetApplicationADF" parameters and changes to your Application components are still not seen try the following:
 
# Make sure that the code in your application component is correct
 
# Make sure that the code in your application component is correct
 
# Make sure that you are logged into CommonSpot (Reset parameters don't function unless you are logged in)
 
# Make sure that you are logged into CommonSpot (Reset parameters don't function unless you are logged in)
  
 
=== Error calling CSContent.populateContent() ===
 
=== Error calling CSContent.populateContent() ===
If you receive an error like this:
+
If you receive an error like:
Element elementType is undefined in a Java object of type class com.paperthin.common.serialization.XMLDecoratedMap.  
+
<pre>
 +
Element elementType is undefined in a Java object of type class com.paperthin.common.serialization.XMLDecoratedMap.  
 +
</pre>
  
Then make sure that you have created your ccapi.xml [[CCAPI Config]] correctly.  You are probably missing the "<elementType>" xml node.
+
Make sure that you have created your ccapi.xml [[CCAPI Config]] correctly.  You are probably missing the "<elementType>" xml node.
  
 
=== Application Level Configuration Data not loaded ===
 
=== Application Level Configuration Data not loaded ===
If you place an .xml file in your sites /_cs_apps/config directory but the variables you define do not appear in #server.ADF.environment[request.site.id]# then you may either:
+
If you place an .xml file in your sites /_cs_apps/config directory but the variables you define do not appear in #server.ADF.environment[request.site.id]# then:  
# Have a mall formed XML file
+
 
 +
# You may have a mall formed XML file
 
# The value for "rootDir" in the ServerSites Table (from the CommonSpot-Sites database) does not match your site folder structure
 
# The value for "rootDir" in the ServerSites Table (from the CommonSpot-Sites database) does not match your site folder structure
  
 
=== AjaxService returns <wddx> not value ===
 
=== AjaxService returns <wddx> not value ===
If you are calling AjaxService.cfc with jQuery (or other JS Library) and you are going to work with a return variable, be sure that you add "retrurnformat='json'" to your functions.  This is available ONLY in CF8 - it will return the data as a JSON object which will be formatted correctly for use in your return function.
+
If you are calling AjaxService.cfc with jQuery (or other JS Library) and you are going to work with a return variable, be sure you add "returnformat='json'" to your functions.  This is available ONLY in CF8 - it will return the data as a JSON object which will be formatted correctly for use in your return function.
  
=== ADF Reset is throwing an error when loading a component that was delete ===
+
=== ADF Reset is throwing an error when loading a component that was deleted ===
This usually occurs when you update the ADF applications [[App_Bean_Config|App Bean Config]] to remove a reference to a component.  Check all your sites that are running a site level [[App_Bean_Config|App Bean Config]].  Probably one of those config files has a reference to the deleted component.
+
This usually occurs when you update the ADF applications [[App_Bean_Config|App Bean Config]] to remove a reference to a component.  Check all your sites that are running a site level [[App_Bean_Config|App Bean Config]].  It is likely one of those config files has a reference to the deleted component.
See also this wiki page for more info [[Application_Site_Customization|Application Site Customization]].
+
See the [[Application_Site_Customization|Application Site Customization]] for additional information.
  
 
=== ColdFusion Error Msg: Element ADF_APP_NAME is undefined in a CFML structure referenced as part of an expression. ===
 
=== ColdFusion Error Msg: Element ADF_APP_NAME is undefined in a CFML structure referenced as part of an expression. ===
The ADF_APP_NAME is not in the /ADF/apps/ directory.  This error is because the ADF.cfc for the site is attempting to load an ADF application that is not in the ADF.  See the [[Site_Configuration#ADF_Applications|Site Configuration - ADF Applications]] wiki page for more info.
+
The ADF_APP_NAME is not in the /ADF/apps/ directory.  This error results when the ADF.cfc for the site is attempting to load an ADF application that is not in the ADF.  See the [[Site_Configuration#ADF_Applications|Site Configuration - ADF Applications]] wiki page for more info.
  
 
=== ColdFusion Error Msg: Element logging is undefined in a CFML structure referenced as part of an expression. ===
 
=== ColdFusion Error Msg: Element logging is undefined in a CFML structure referenced as part of an expression. ===
If you attempt to use any of the components of the CCAPI and you receive this error it is because either
+
If you attempt to use any of the components of the CCAPI and you receive this error it is because either:
# You do not have the correct configuration (go to [[CCAPI|CCAPI]] for more info)
+
# You do not have the correct configuration - see [[CCAPI|CCAPI]] for more info or
# Or the configuration file has not been loaded - try reloading the ADF.
+
# The configuration file has not been loaded - try reloading the ADF.
  
 
=== Method not found error ===
 
=== Method not found error ===
 
If you choose to extend a CFC for an Application written in the ADF at the site level (see [[Site Level Customizations]]) and you receive a "Method not found" error - be sure to check the CFC you have in your sites /_cs_apps/... directory - it MUST extend the original CFC from the application
 
If you choose to extend a CFC for an Application written in the ADF at the site level (see [[Site Level Customizations]]) and you receive a "Method not found" error - be sure to check the CFC you have in your sites /_cs_apps/... directory - it MUST extend the original CFC from the application
 
  
 
=== Element Class is not defined ===
 
=== Element Class is not defined ===
Line 58: Line 60:
 
Note: The path to the config file is controlled via the following code:
 
Note: The path to the config file is controlled via the following code:
  
ExpandPath("#request.site.csAppsWebURL#config/ccapi.xml");
+
<pre>ExpandPath("#request.site.csAppsWebURL#config/ccapi.xml");</pre>
  
the variable: #request.site.csAppsWebURL# can sometimes be different if you have "/" ColdFusion mapping which goes to a different location
+
The variable: #request.site.csAppsWebURL# can sometimes be different if you have "/" ColdFusion mapping which goes to a different location.
  
 
=== Custom Element CCAPI fails with No DB Record Found ===
 
=== Custom Element CCAPI fails with No DB Record Found ===
If you are having trouble using the Content Creation API by updating a Custom Element and your log files in the /commonspot/logs/ directory you have populate_content_error.log file with entries:
+
If you are having trouble using the Content Creation API to update a Custom Element and your populate_content_error.log file in the /commonspot/logs/ directory has the following entries:
  
Error recorded: Invalid pageid/pageName.  No DB record found.
+
<pre>Error recorded: Invalid pageid/pageName.  No DB record found.</pre>
  
It could be that your custom element has a field "pageID" - which will break cause this error
+
It could be that your custom element has a field "pageID" - which will cause this error.
  
 
=== General Chooser Field Type does not render ===
 
=== General Chooser Field Type does not render ===
 
If your General Chooser Field is not rendering correctly, go to Firebug and look for any "Red" error "Net" calls.  If you see the following error:
 
If your General Chooser Field is not rendering correctly, go to Firebug and look for any "Red" error "Net" calls.  If you see the following error:
  
Cannot invoke method controller on an object of type coldfusion.runtime.Struct with named arguments.
+
<pre>Cannot invoke method controller on an object of type coldfusion.runtime.Struct with named arguments.</pre>
 
 
 
Make sure that the Bean Name you placed into your GC properties dialog matches with your actual GC.cfc file
 
Make sure that the Bean Name you placed into your GC properties dialog matches with your actual GC.cfc file
  
Remember to reset the ADF after making any changes to GC files
+
Remember to [[Reset ADF|reset the ADF]] after making any changes to GC files.

Revision as of 22:21, 20 December 2009

ADF is not reseting

Make sure you're logged into the site. The IF block in the custom-application.cfm code requires the user to be logged into the site to reset the ADF. See the Reset ADF wiki page for more info.

ADF Applications AppBeanConfig is not updating the sites Application variables

Check that you do not have multiple copies of the AppBeanConfig anywhere in the apps directory. Ensure that you don't have any AppBeanConfig backup or old files under the apps directory. The AppBeanConfig sets an appBeanName variable, so if you have multiple files being called only the last file executed will load in application space.

How can I see the beans in my object factory?

To view all the beans in the object factory do a CF dump of the bean configuration structure:

 <cfdump var="#server.ADF.beanConfig.getConfigStruct()#" label="ADF Bean Config" expand="false">

What is the ADF Library Component versioning schema?

The ADF version schema is based on major_minor_revisions.

See the ADF Library Component Versions wiki page for details on ADF versioning schema.

Changes to your application components are not seen

If you use the "ResetServerADF" and "ResetApplicationADF" parameters and changes to your Application components are still not seen try the following:

  1. Make sure that the code in your application component is correct
  2. Make sure that you are logged into CommonSpot (Reset parameters don't function unless you are logged in)

Error calling CSContent.populateContent()

If you receive an error like:

Element elementType is undefined in a Java object of type class com.paperthin.common.serialization.XMLDecoratedMap. 

Make sure that you have created your ccapi.xml CCAPI Config correctly. You are probably missing the "<elementType>" xml node.

Application Level Configuration Data not loaded

If you place an .xml file in your sites /_cs_apps/config directory but the variables you define do not appear in #server.ADF.environment[request.site.id]# then:

  1. You may have a mall formed XML file
  2. The value for "rootDir" in the ServerSites Table (from the CommonSpot-Sites database) does not match your site folder structure

AjaxService returns <wddx> not value

If you are calling AjaxService.cfc with jQuery (or other JS Library) and you are going to work with a return variable, be sure you add "returnformat='json'" to your functions. This is available ONLY in CF8 - it will return the data as a JSON object which will be formatted correctly for use in your return function.

ADF Reset is throwing an error when loading a component that was deleted

This usually occurs when you update the ADF applications App Bean Config to remove a reference to a component. Check all your sites that are running a site level App Bean Config. It is likely one of those config files has a reference to the deleted component. See the Application Site Customization for additional information.

ColdFusion Error Msg: Element ADF_APP_NAME is undefined in a CFML structure referenced as part of an expression.

The ADF_APP_NAME is not in the /ADF/apps/ directory. This error results when the ADF.cfc for the site is attempting to load an ADF application that is not in the ADF. See the Site Configuration - ADF Applications wiki page for more info.

ColdFusion Error Msg: Element logging is undefined in a CFML structure referenced as part of an expression.

If you attempt to use any of the components of the CCAPI and you receive this error it is because either:

  1. You do not have the correct configuration - see CCAPI for more info or
  2. The configuration file has not been loaded - try reloading the ADF.

Method not found error

If you choose to extend a CFC for an Application written in the ADF at the site level (see Site Level Customizations) and you receive a "Method not found" error - be sure to check the CFC you have in your sites /_cs_apps/... directory - it MUST extend the original CFC from the application

Element Class is not defined

When calling the CCAPI for any of the actions, you may receive this error:

The value of CLASS attribute is invalid.

Be sure that you have a "ccapi.xml" file located in your sites /_cs_apps/config/ directory and that it is configured correctly.

Note: The path to the config file is controlled via the following code:

ExpandPath("#request.site.csAppsWebURL#config/ccapi.xml");

The variable: #request.site.csAppsWebURL# can sometimes be different if you have "/" ColdFusion mapping which goes to a different location.

Custom Element CCAPI fails with No DB Record Found

If you are having trouble using the Content Creation API to update a Custom Element and your populate_content_error.log file in the /commonspot/logs/ directory has the following entries:

Error recorded: Invalid pageid/pageName.  No DB record found.

It could be that your custom element has a field "pageID" - which will cause this error.

General Chooser Field Type does not render

If your General Chooser Field is not rendering correctly, go to Firebug and look for any "Red" error "Net" calls. If you see the following error:

Cannot invoke method controller on an object of type coldfusion.runtime.Struct with named arguments.

Make sure that the Bean Name you placed into your GC properties dialog matches with your actual GC.cfc file

Remember to reset the ADF after making any changes to GC files.