Extending onCue

Troubleshooting - why doesn't my XML Qbit work?

We are working on improving the error reporting for user XML Qbits, but, for now, we're afraid Qbit debugging is a bit of a black art!

If you have been using your own web page and text, go back and try the examples exactly as they are written.

If you have already been following the examples precisely go back and check all the XML files to make sure you have them exactly as in the example and check that the icon files are exactly where they should be.

If you can get a simple case working start adding your own text, etc, bit by bit until it stops working. This will probably make it obvious what is wrong.

If things still don't work, go through the following checklist:

onCue doesn't start at all

in this case there is probably something seriously wrong in one of the XML files, probably myqbits.xml - double check them all.

onCue starts OK -> look in the Qbits section of the onCue preferences dialogue box

the description of your Qbit appears in the onCue preferences, but no icon

Check that your icon file is in the right place, check the name of your icon in the XML file and check that your icon is really in GIF or JPEG format (if you can look at it using a web browser it is OK).

there is no description or icon in the onCue preferences

This means onCue hasn't recognised your Qbit, because something is wrong in your XML Qbit file or myqbits.xml.

everything looks fine in the onCue preferences

This suggests something is wrong in the 'recognition' part of your Qbit. If you are using keywords, remember that onCue only recognises the exact keyword (not punctuation, etc.). Try copying the word exactly. If you want to recognise more general patterns, or punctuation, try using regular expressions (see have an aQtive intranet).

If you are using the regular expression mechanism for more complex Qbits, then you will need to check this in some detail.

you've checked everything and it still doesn't work

Check out our developers pages, for bug reports, fixes, helpful hints, etc., or email us at developers@aqtive.com.

Recipes to extend onCue

• go to specific web pages on given keywords
• add links to Internet searches and services
• aQtivate your own web site with onCue
• have an aQtive Intranet!