Difference between revisions of "User:Jimmyshiau"

From Documentation
Line 3: Line 3:
  
 
[[File:ZK_MeetRpoblem01.png]]
 
[[File:ZK_MeetRpoblem01.png]]
 
+
==Provide general information and reproducible samples==
:Please provide the following information in addition to the screenshot:
+
:Please provide the following information:
 
:#ZK version (EX: ZK 5.0.7.1 PE).
 
:#ZK version (EX: ZK 5.0.7.1 PE).
 
:#Browser and Browser version (EX: Firefox 3.6).
 
:#Browser and Browser version (EX: Firefox 3.6).
Line 12: Line 12:
 
:#If your case happens only in your specific environment, it is recommended to provide a virtual machine as a copy of your actual environment.
 
:#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:
+
: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.
 
:Code snippet is not as useful as runnable samples when debugging an issue. Please follow these tips to create runnable samples.
 
:*Use [http://books.zkoss.org/wiki/ZK_Jet ZK Jet] extracting ZK 5 widget tree to a ZUL file (i.e., snapshot the browser into a ZUL file)
 
:*Use [http://books.zkoss.org/wiki/ZK_Jet ZK Jet] extracting ZK 5 widget tree to a ZUL file (i.e., snapshot the browser into a ZUL file)
Line 25: Line 25:
 
</client-config>
 
</client-config>
 
</source>
 
</source>
* Using Firefox with [http://getfirebug.com/ firebug] (enable firebug by press F12) to snapshot the following images, then mail to zk support team.
+
* As Firefox has a very useful tool Firebug, it is recommended to log your issue with [http://getfirebug.com/ firebug] (Hot-key: F12) and snapshot the following images, then send to zk support team.
 
{| border="1px" | width="100%" | cellspacing="0"
 
{| border="1px" | width="100%" | cellspacing="0"
 
|-
 
|-
Line 52: Line 52:
  
 
== If you cannot reproduce it with Firefox ==
 
== 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 ===
 
=== Chrome ===
 
*Enable "Developer tools" by press F12
 
*Enable "Developer tools" by press F12

Revision as of 09:08, 6 September 2011

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.

ZK MeetRpoblem01.png

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

ZK MeetRpoblem FF01.png


2. Response

ZK MeetRpoblem FF02.png

Client side error

ZK MeetRpoblem FF03.png


  • Click the link (the blue text) then go to the line of error.

ZK MeetRpoblem FF04.png

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

ZK MeetRpoblem Chrome01.png


2. Response

ZK MeetRpoblem Chrome02.png

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.

ZK MeetRpoblem Chrome03.png

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

ZK MeetRpoblem IE01.png

  • Change Document mode to emulate IE6,7

ZK MeetRpoblem IE02.png

Quirks Mode: IE6
Internet Explorer 7 Standards: IE7