Nitobi
Customer Login
Services
Products
About
Blogs
Contact
Home -> Product Knowledgebase Order Online | Free Trial Downloads

Nitobi Product Knowledgebase

Troubleshooting your Combo Implementation


Setting up your Combobox implementation should go smoothly. However, like all components, there are places where things can go wrong. Here are specific instructions for troubleshooting common problems.

The Combo doesn't appear or wont initialize.

Namespace isn't defined.

The html page where the grid tag appears must contain the NTB namespace. put this in the tag at the top of the page. Eg:

<html xmlns:ntb>

JavaScript component isn't loading.

For some reason, the nitobi.combo.js component might not be loading. Is it referenced correctly?

nitobi.loadComponent(); isn't being called.

When the page is loaded, nitobi.loadComponent() must be called. In your tag, use the onLoad property to do this, either directly, or through a JavaScript function. Eg:

<body onload="nitobi.loadComponent('myComboID');">

Improperly defined Combo Tag

An incorrectly defined HTML Combo tag may cause the combo to not appear. Consult the included demos for an example of a properly formed combo tag.

Combo tag Properties using wrong cAsE

Something of vital importance when defining the combobox is the cAsE of combo properties in the HTML combo tag.

Consult the documentation for correct capitalization of combo properties.

The Combo appears distorted or is behaving strangely.

Missing or incorrectly Referenced Style Sheet

This is probably due to the stylesheet being incorrectly referenced. Did you copy the styles into your application folder? Here is an example of a correct CSS reference appearing in the tag of your page:

<LINK class=BodyText rel=nofollow href="styles/basicgrey/combo.css" type=text/css rel=stylesheet>

Close tags not used

If your combobox doesn't render properly in Firefox/Mozilla/Netscape etc but does in IE, you may not be closing all of your tags properly. Here is an example.

<ntb:ComboTextBox></ntb:ComboTextBox>

is valid but

<ntb:ComboTextBox />

is invalid.

The Combo has no data in it.

Combo columns not bound to data columns

Every column in the combobox must reference (with the attribute DataFieldIndex) a column of data in the datasource. Eg:

<ntb:ComboColumnDefinition DataFieldIndex=0></ntb:ComboColumnDefinition> 

In this example, the column is bound to the first data column (XML field "a").

There is a problem with the getHandler.

To see if the getHandler is working correctly, try calling directly in your browser. If your getHandler is gethandler.asp, simply call it in your browser window and then View Source. You should see a properly formatted XML stream like this:

<root fields="client|service|quantity" keys="client|service|quantity">
<e xk="1" a="3" b="security" c="5299.22" fld="" />
<e xk="2" a="2" b="catering" c="30.00" fld="" />
<e xk="3" a="2" b="security" c="889.00" fld="" />
<e xk="4" a="2" b="security more" c="999.00" fld="" />
<e xk="5" a="1" b="catering" c="20.00" fld="" />
</root>

If not, you will probably get a server error. Check your file permissions and troubleshoot the script as you would any other. Refer to the server-side XML API documentation included with the Combo.

Related Articles

View Printable Version

Comments:


Name:

Type the text you see above:

Comments:


Knowledgebase

To be notified of new articles when they're available, subscribe to our RSS feed.

Support Resources

Take advantage of our knowledgebase of product tutorials and tips, and our support forums!

Search Site


Sign up for our Newsletter:

Get industry articles and Nitobi company news in your inbox every couple of months — here's a sample!

Email:




Site RSS Feed  | All contents are (c) Copyright 2006, Nitobi Software Inc. All rights Reserved