This document provides answers to the frequently asked questions (FAQ) and Troubleshooting tips for the IBIS-PH Query System's module development. The first section lists the FAQs, while the last section gives a general decision tree that can be used to help locate and diagnose the problem.
FAQ
This section discusses some of the frequently asked questions on module development.
What do I name my file? This section discusses some of the frequently asked questions on module development.
What sub directory/folder should I put my file in? This section discusses some of the frequently asked questions on module development.
How do I test my just created module? This section discusses some of the frequently asked questions on module development.
How do I check that my module is the correct structure and well formed? This section discusses some of the frequently asked questions on module development.
How do I get my module included on the menu or as part of the module set? This section discusses some of the frequently asked questions on module development.
How do I remove a non related step for a measure? This section discusses some of the frequently asked questions on module development.
How do I remove a non related question/answer set for a measure? This section discusses some of the frequently asked questions on module development.
How do I remove a group by dimension choice for a measure? This section discusses some of the frequently asked questions on module development.
I'm done with my module now what am I supposed to do with it? This section discusses some of the frequently asked questions on module development.
Trouble Shooting
This section discusses the process of determining where the problem is. This assumes you have a working PC with Internet Explorer 6.0+ or Netscape Navigator 6.0+ also properly working.
Can you bring up your module page on your PC?
URL: http://localhost/Query?module=my_module_name&measure=the_measure_name
Where you need to substitute the "my_module_name" and "the_measure_name" values.
No.
Is Tomcat running?
Yes.
Try http://localhost/.
Page not found.
Tomcat and/or the ibisph-view system has a problem. Call the system administrator or Garth.
Home page displayed.
Does your module name match exactly your module's filename which should be in the
tomcat/webaspps/ibisph-view/xml/query/module directory?
Yes
Does your measure name exactly match a measure name contained within your module xml file? This value should be in one of the /QUERY/MODULE/MEASURES/MEASURE/NAME elements.
Yes
Is your document well formed? See the FAQs on how this is tested.
No
Fix the issues and test again
Yes
Is tomcat throwing an exception (bunch of text displayed in the Tomcat output window). Look at the first few lines of the exception error and sometimes this gives line number of offending XML code.
Was Tomcat exception helpful?
Yes
Fix and try again.
No
Take a screen shot of the exception and email/call system
administrator - Garth.
No.
Start the Tomcat service and try again.
End of document
