Difference between revisions of "User:Jimmyshiau"

From Documentation
 
(9 intermediate revisions by 2 users not shown)
Line 1: Line 1:
=How to report an ZK issue=
+
=Debug=
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.
+
====[[User:Jimmyshiau/Debug_Client_Error | Debug Client Error]]====
  
[[File:ZK_MeetRpoblem01.png]]
+
=Component Reference=
==Provide general information and reproducible samples==
+
====[[User:Jimmyshiau/Comp_Ref_Listbox | Listbox]]====
:Please provide the following information:
+
====[[User:Jimmyshiau/Comp_Ref_Listbox_v2 | Listbox v2]]====
:#ZK version (EX: ZK 5.0.7.1 PE).
+
====[[User:Jimmyshiau/Comp_Ref_Grid | Grid]]====
:#Browser and Browser version (EX: Firefox 3.6).
+
====[[User:Jimmyshiau/Comp_Ref_Combobox | Combobox]]====
:#Servers (EX: JBoss 6).
+
====[[User:Jimmyshiau/Comp_Ref_Window | Window]]====
:#A sample with the steps so that the support team can reproduce the issue.
+
====[[User:Jimmyshiau/Comp_Ref_InputElement | InputElement]]====
:#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 [[#Cannot extracting the issue to a reproducing sample | turn on]] the js debug in your zk.xml.
 
:#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:
+
=Developer's Reference=
:Code snippet is not as useful as runnable sample. Please follow these tips to create runnable samples.
+
== MVC ==
:*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)
+
===Controller===
:*'''Replace''' you DB data with 'dummy data' and make it a runnable sample.
+
====[[User:Jimmyshiau/Dev_Ref_MVC_Controller_Composer | Composer]]====
 +
== MVVM ==
 +
====[[User:Jimmyshiau/Dev_Ref_MVVM_Data_Binding | Data Binding]]====
  
==If you cannot provide a reproducible sample==
+
=Layout=
:Snapshot the ''error'', ''request'' and ''response'' with Browser. Remember to''' turn on''' js debug in your zk.xml
+
====[[User:Jimmyshiau/ZK_Container_Size | ZK Container]]====
<source type="xml">
 
<client-config>
 
<debug-js>true</debug-js>
 
</client-config>
 
</source>
 
: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"
 
|-
 
!style="width:100px"|
 
!|
 
|-
 
| Server side error
 
|
 
'''1. Request'''
 
  
[[File:ZK_MeetRpoblem_FF01.png]]
+
=Etc=
----
+
====[[User:Jimmyshiau/Etc_Id_Generator |Id Generator]]====
 
 
'''2. Response'''
 
 
 
[[File:ZK_MeetRpoblem_FF02.png]]
 
|-
 
|Client side error
 
|
 
[[File:ZK_MeetRpoblem_FF03.png]]
 
----
 
 
 
*Click the link (the blue text) then go to the line of error.
 
[[File: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
 
{| border="1px" | width="100%" | cellspacing="0"
 
|-
 
!style="width:100px"|
 
!|
 
|-
 
| Server side error
 
|
 
'''1. Request'''
 
 
 
[[File:ZK_MeetRpoblem_Chrome01.png]]
 
----
 
 
 
'''2. Response'''
 
 
 
[[File: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.
 
[[File: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
 
{| border="1px" | width="100%" | cellspacing="0"
 
|-
 
!style="width:100px"|
 
!|
 
|-
 
| Client side error
 
|
 
[[File:ZK_MeetRpoblem_IE01.png]]
 
|}
 
 
 
*Change '''Document mode''' to emulate IE6,7
 
[[File:ZK_MeetRpoblem_IE02.png]]
 
:'''Quirks Mode''': IE6
 
:'''Internet Explorer 7 Standards''': IE7
 

Latest revision as of 03:18, 30 November 2012