The table below describes problems and possible causes and numbered solutions. Cause and solution descriptions are listed below. Make sure all files are installed inside the MapTron1207 folder as described in sections 2.2 and 2.3 before diagnosing a problem. The index.htm and diagnostics.htm files will be used solve problems. Do not turn off diagnostics, diagnostics must remain on for troubleshooting.
The most common problem is missing files or incorrect file paths. Check for correct file paths in the HTML web page first. The system diagnostics will show incorrect XML file paths. The use if relative file paths is strongly recommended, all instructions and examples in this manual use relative paths. |
| Troubleshooting Table |
| Ref | Problem | Cause | Solutions |
|---|
| A |
Web page(s) outside the MapTron1207 folder does not show the embedded application.
Sample web page and diagnostics page inside the MapTron1207 folder has the same problem.
|
a, b |
1, 2 |
| B |
Web page(s) outside the MapTron1207 folder does not show the embedded application.
Sample web page and diagnostics page inside the MapTron1207 folder show the area for the embedded application.
|
b |
3 |
| C |
Web page(s) outside the MapTron1207 folder shows the area reserved for the embedded application, however, nothing appears. The application loading indicator with spinning wheel does not show at startup.
Sample web page and diagnostics page inside the MapTron1207 folder show the area for the embedded application. The application loads.
|
c |
3 |
| D |
Web page(s) inside / outside the MapTron1207 folder loads application, however, nothing seems to happen. No modules load. |
a, d, e |
4, 5 |
| E |
Application loads and modules load correctly. Search does not produce results. |
f, g |
5, 6 , 7 |
| F |
System does not activate. Demonstration mode still shows logo. |
d, e ,h |
5, 9 |
| G |
System activates for superdomain, however, does not activate for domain starting with www (or vice versa). |
e |
8 |
| H |
Changes or corrections made to XML is not affecting the system as expected. |
h |
9 |
|---|
| Cause |
|---|
- Missing file(s) or improper file name(s) in the MapTron1207 folder.
- Web page HTML code has incorrect path to MapTron1207.js file.
- Web page HTML code has incorrect path to MapTron1207.swf file.
- There is an XML error.
- Missing XML instructions.
- Location records did not load.
- Location record(s) have missing attributes (fields).
- Web browser has cached the XML. Data is pulled from local file instead of server.
|
| Solutions |
- When embedding the application, set the border_width greater than zero. The border will show where the application would appear on the web page. See section 2.4 for web page editing instructions.
- Make sure all files in the product package are installed inside the MapTron1207 folder in the server. See section 2.2 and 2.3 for organization and installation instructions.
- Fix file path reference(s) in web page. Make sure file names are correct.
- Check the the file MapTron1207.xml is in the MapTron1207 folder.
- Use system diagnostics to find and isolate problem. First check for XML parse errors.
- Use the diagnostics to retrieve SYS_INFO. Inspect the results. The SYS_INFO will quantify locations loaded.
- Use the diagnostics to DUMP_LOCATIONS. Inspect the results.
- Activation requires two <activate> instructions. One for the superdomain and one for the subdomain www. See section 3.2 for activation instructions.
- Try a super-refresh of web browser by pressing the [shift] key while clicking the refresh button. Empty browser cache and restart browser if persistent.
|
|
| Table 5.2a Troubleshooting |
|
