From Documentation

(Difference between revisions)
Jump to: navigation, search
(How to Run a Sample Maven Project)
(Provide general information and reproducible samples)
Line 12: Line 12:
=== Please provide the general information: ===
=== Please provide the general information: ===
-
# ZK version and edition (e.g. ZK 9.0.1 PE).
+
# the complete server-side error or the client-side error (if any)
-
# Browser and its version (e.g. Firefox 60).
+
# complete exception stack trace (if any)
# A runnable sample
# A runnable sample
# Precise and clear steps to reproduce the issue
# Precise and clear steps to reproduce the issue
-
# If it is hard to create a sample, you can provide an URL so that the support team can access it. When providing this URL, remember to [https://www.zkoss.org/wiki/ZK%20Configuration%20Reference/zk.xml/The%20client-config%20Element/The%20debug-js%20Element | turn on the js debug] in your zk.xml.
+
# ZK version and edition
 +
#: e.g. ZK 9.0.1 PE
 +
# Browser and its version
 +
#: e.g. Firefox 60
 +
# If it is hard to create a sample, you can provide an URL so that the support team can access it. When providing this URL, remember to [https://www.zkoss.org/wiki/ZK%20Configuration%20Reference/zk.xml/The%20client-config%20Element/The%20debug-js%20Element turn on the js debug] in your zk.xml.
# Application servers (e.g. JBoss 6, if it's necessary).
# Application servers (e.g. JBoss 6, if it's necessary).
# 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.
Line 25: Line 29:
# Use [http://zkfiddle.org zkfiddle]
# Use [http://zkfiddle.org zkfiddle]
-
# Zip your maven project with pom.xml and include necessary source code. Remember to [https://www.zkoss.org/wiki/ZK%20Configuration%20Reference/zk.xml/The%20client-config%20Element/The%20debug-js%20Element turn on the js debug] in your zk.xml.
+
# Zip your maven project with pom.xml and include necessary source code
# Provide zul and its related Java source
# Provide zul and its related Java source
# Provide a public URL that we can visit
# Provide a public URL that we can visit

Revision as of 06:42, 20 May 2020








Contents

Getting prompt and efficient support from ZK

When you encounter an issue in ZK, following this document can help you to provide the support team with informative data, thus speeding up the investigation and get prompt and efficient feedback. 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 general information:

  1. the complete server-side error or the client-side error (if any)
  2. complete exception stack trace (if any)
  3. A runnable sample
  4. Precise and clear steps to reproduce the issue
  5. ZK version and edition
    e.g. ZK 9.0.1 PE
  6. Browser and its version
    e.g. Firefox 60
  7. If it is hard to create a sample, you can provide an URL so that the support team can access it. When providing this URL, remember to turn on the js debug in your zk.xml.
  8. Application servers (e.g. JBoss 6, if it's necessary).
  9. If your case happens only in your specific environment, it is recommended to provide a virtual machine as a copy of your actual environment.


A runnable example is the best for us

You can:

  1. Use zkfiddle
  2. Zip your maven project with pom.xml and include necessary source code
  3. Provide zul and its related Java source
  4. Provide a public URL that we can visit

Tips for creating a reproducible example

  • Clone the original zul with the issue, remove irrelevant components
  • You could move your Java codes (mostly event listeners) into <zscript>
  • Replace your database data with static sample data in order to run without a database.

If you cannot provide a reproducible sample

Snapshot the error, request and response with Browser. Remember to turn on js debug in your zk.xml
<client-config>
	<debug-js>true</debug-js>
</client-config>

Please follow the instructions below and provide the support team with corresponding debug information.

Chrome

  • Enable "Developer tools" by 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 lower right corner.
  • Click the link (test.zul:22) then go to the line where the error occurred.

ZK MeetRpoblem Chrome03.png

IE

  • As there are less tools in IE6 and 7, it is recommended to reproduce and log the debug info with IE8 or 9.
  • With IE8 or later, enable "Developer tools" by F12
Client side error

ZK MeetRpoblem IE01.png

  • Change Document mode to emulate IE6,7 if the issue happens only in these versions

ZK MeetRpoblem IE02.png

Quirks Mode: IE6
Internet Explorer 7 Standards: IE7


How to Run a Sample Maven Project

In order to get rid of all your project's environment effect and narrow down problems, we send you a sample maven project that reproduces a case. To run the project, you need to download maven and setup first.

  1. Run your command line interface
  2. switch to the sample project's root folder that has a pom.xml
  3. Start jetty server with the command below
    mvn jetty:run
  4. Visit the project's pages with your browser

If you don't know the zul's path or the path is incorrect, just visit http://localhost:8080. A browser will show a link with the correct context path:

JettyRoot.png

Click the link and it will list folders then you can navigate to find the zul.

ListFolder.png

How to get Browser Performance Profile

By Chrome developer tool

By Firefox developer tool

By Edge developer tool



Copyright © Potix Corporation. This article is licensed under GNU Free Documentation License.