User:Jimmyshiau

How to report an ZK issue

When you encounter an issue in ZK, following this document can help you to provide the support team with informative data, thus speedup the resolving time. Here is a sample screenshot of an error. However with only a screenshot, it is difficult for the support team to find enough clues and provide timely support. Please follow the tips and instructions below when submitting your issue.

Provide general information and reproducible samples

Please provide the following information:

1. ZK version (EX: ZK 5.0.7.1 PE).
2. Browser and Browser version (EX: Firefox 3.6).
3. Servers (EX: JBoss 6).
4. A sample with the steps so that the support team can reproduce the issue.
5. If it is not easy to come out a sample, you can provide an URL so that the support team can access to and try to debug with it. When providing this URL, remember to turn on the js debug in your zk.xml.
6. If your case happens only in your specific environment, it is recommended to provide a virtual machine as a copy of your actual environment.

Tips for creating samples:

Code snippet is not as useful as runnable samples when debugging an issue. Please follow these tips to create runnable samples.

• Use ZK Jet extracting ZK 5 widget tree to a ZUL file (i.e., snapshot the browser into a ZUL file)
• Replace you DB data with 'dummy data' and make it a runnable sample.

If you cannot provide a reproducible sample

• Snapshot the error, request and response with Browser. remember to turn on the js debug in your zk.xml

<client-config>
	<debug-js>true</debug-js>
</client-config>

• As Firefox has a very useful tool Firebug, it is recommended to log your issue with firebug (Hot-key: F12) and snapshot the following images, then send to zk support team.

Server side error	1. Request 2. Response
Client side error	Click the link (the blue text) then go to the line of error.

If you cannot reproduce it with Firefox

Some issues are browser-dependent. If the issue does not happen in your Firefox, please follow the instructions below and provide the support team with corresponding debug information.

Chrome

• Enable "Developer tools" by press F12

Server side error	1. Request 2. Response
Client side error	Click the error icon in the right-bottom corner. Click the link (test.zul:22) then go to the line of error.

IE

• Due to IE6, 7 cannot check error line, we need to reproduce with IE8 or 9.
• Enable "Developer tools" by press F12

Client side error

• Change Document mode to emulate IE6,7

Quirks Mode: IE6

Internet Explorer 7 Standards: IE7