FAQ"

From Documentation
Line 3: Line 3:
 
When you first order ZK, we will provide you (your company) a document called “Delivery” which states the product (edition), licensed seats, and the number of support hours your company has purchased. The same information will normally be included in the invoice as well.
 
When you first order ZK, we will provide you (your company) a document called “Delivery” which states the product (edition), licensed seats, and the number of support hours your company has purchased. The same information will normally be included in the invoice as well.
 
If you are new to the team, please ask for “Delivery” or the relevant invoice internally. If you are uncertain, please email [email protected] with your invoice or certificate number and we will send you the details again.
 
If you are new to the team, please ask for “Delivery” or the relevant invoice internally. If you are uncertain, please email [email protected] with your invoice or certificate number and we will send you the details again.
 +
 +
How do I request Professional Support?
 +
Instructions are listed in the "Delivery" document as well. Basically if your package includes Remote Support service, you can send an email directly to <[email protected]>to request for professional support. Each email will be turned into a support ticket in our support portal, and our support engineer will get back to you via email as soon as there’s an update.
 +
To respond to the ticket, you can either log into the support portal and reply/comment on the ticket. Or, simply reply to the same thread through email without logging into the support system. The benefit of logging into the system is that you can get an overview of all questions asked by members of your company, and can log additional information such as version number and browser versions.
 +
 +
To login to the support portal you will need to create an account based on your email address. If you are unsure of your password, please use “forget password” to retrieve the password.
 +
 +
How do I know how many hours I have and how many are left? What happens if I run out of support hours?
 +
The number of Remote Support hours included in your package is outlined in the “Delivery” document or your invoice. The time our support engineers spent on your ticket will be deducted from the total number of support hours you have.
 +
When there is a limited number of hours remaining in your package, we will send you a notification e-mail. You can then purchase more hours if you find our support service helpful. Newly purchased hours will be effective for a one-year period.
 +
 +
Reporting a ZK Bug
 +
If the issue is a bug, you can contact us through the same support window <[email protected]> mentioned above. If you have already posted an issue in tracker.zkoss.org, please do contact support and specify the tracker you created so that we can handle the issue in high priority. Many issues are being reported from time to time and as we do not want to miss your ticket, please do contact support and let us know.
 +
 +
If an issue has been confirmed as a ZK bug, we will try to fix it in the coming version based on the Release Cycle. If you need to address the issue immediately, please inform the support engineer so that we can try to provide you with a workaround or a patch, before the next official version is available.
 +
 +
During the process, we may inform you of a Freshly Build which is used for testing & developing only. It can help us both to verify the fix earlier and avoid future surprises in the official release. Freshly Builds have not been tested and are not licensed.
 +
 +
In general, bug fixes for ZK products are free of charge for Professional and Enterprise licensed customers. However, if you are asking a patch/fix specifically for a non-active branch or for a custom package, such patch/fix will be considered billable.
 +
 +
Release Cycle
 +
Major branch (the latest official branch, as of today Dec. 2015, 8.0.x ) is released on a 3-month cycle. As an official release, the code has been tested and licensed.
 +
If it is not the major active branch, please consult with us about the release schedule of the desired version.
 +
In general, the code is frozen for testing two weeks before the release date. If you intend to do a major release, please share with us your plan as early as possible so that we can try to adjust our schedule as much as possible to best fit your plan.
 +
 +
Freshly Build vs Official Releases
 +
Freshly files (such as zk-8.0.1-FL-2015-12-09) are nightly builds that contain fresh fixes and are built automatically through our system. However freshly files have not been officially tested yet and are not meant for production use. For production use, please use official releases such as 8.0.0 or 7.0.6.1.
 +
 +
Updates, Upgrades and Compatibility
 +
It is recommended that you always use the latest version of a branch. For example, if you are with ZK 7, the latest version is normally the last version available in the format of 7.0.x or 7.0.x.y in the premium download page or PE/EE maven repository. Note that maintenance releases are normally provided to PE/EE customers and ZOL users only. 
 +
We always try to maintain the best compatibility within the same branch so upgrading within the same branch should require minimum effort.
 +
 +
ZK is a very innovative framework where we try to include new technologies, simpler solutions, better codes in new versions. This means some older technologies would be deprecated or removed in order to produce a lighter and more concise product. Upgrading to another major version would sometimes require more effort. In case of any doubt in upgrading to a major version, we recommend that you reference Upgrade Note or consult with [email protected].

Revision as of 06:44, 14 December 2015

FAQ for customers

What is my current ZK Package?

When you first order ZK, we will provide you (your company) a document called “Delivery” which states the product (edition), licensed seats, and the number of support hours your company has purchased. The same information will normally be included in the invoice as well. If you are new to the team, please ask for “Delivery” or the relevant invoice internally. If you are uncertain, please email [email protected] with your invoice or certificate number and we will send you the details again.

How do I request Professional Support? Instructions are listed in the "Delivery" document as well. Basically if your package includes Remote Support service, you can send an email directly to <[email protected]>to request for professional support. Each email will be turned into a support ticket in our support portal, and our support engineer will get back to you via email as soon as there’s an update. To respond to the ticket, you can either log into the support portal and reply/comment on the ticket. Or, simply reply to the same thread through email without logging into the support system. The benefit of logging into the system is that you can get an overview of all questions asked by members of your company, and can log additional information such as version number and browser versions.

To login to the support portal you will need to create an account based on your email address. If you are unsure of your password, please use “forget password” to retrieve the password.

How do I know how many hours I have and how many are left? What happens if I run out of support hours? The number of Remote Support hours included in your package is outlined in the “Delivery” document or your invoice. The time our support engineers spent on your ticket will be deducted from the total number of support hours you have. When there is a limited number of hours remaining in your package, we will send you a notification e-mail. You can then purchase more hours if you find our support service helpful. Newly purchased hours will be effective for a one-year period.

Reporting a ZK Bug If the issue is a bug, you can contact us through the same support window <[email protected]> mentioned above. If you have already posted an issue in tracker.zkoss.org, please do contact support and specify the tracker you created so that we can handle the issue in high priority. Many issues are being reported from time to time and as we do not want to miss your ticket, please do contact support and let us know.

If an issue has been confirmed as a ZK bug, we will try to fix it in the coming version based on the Release Cycle. If you need to address the issue immediately, please inform the support engineer so that we can try to provide you with a workaround or a patch, before the next official version is available.

During the process, we may inform you of a Freshly Build which is used for testing & developing only. It can help us both to verify the fix earlier and avoid future surprises in the official release. Freshly Builds have not been tested and are not licensed.

In general, bug fixes for ZK products are free of charge for Professional and Enterprise licensed customers. However, if you are asking a patch/fix specifically for a non-active branch or for a custom package, such patch/fix will be considered billable.

Release Cycle Major branch (the latest official branch, as of today Dec. 2015, 8.0.x ) is released on a 3-month cycle. As an official release, the code has been tested and licensed. If it is not the major active branch, please consult with us about the release schedule of the desired version. In general, the code is frozen for testing two weeks before the release date. If you intend to do a major release, please share with us your plan as early as possible so that we can try to adjust our schedule as much as possible to best fit your plan.

Freshly Build vs Official Releases Freshly files (such as zk-8.0.1-FL-2015-12-09) are nightly builds that contain fresh fixes and are built automatically through our system. However freshly files have not been officially tested yet and are not meant for production use. For production use, please use official releases such as 8.0.0 or 7.0.6.1.

Updates, Upgrades and Compatibility It is recommended that you always use the latest version of a branch. For example, if you are with ZK 7, the latest version is normally the last version available in the format of 7.0.x or 7.0.x.y in the premium download page or PE/EE maven repository. Note that maintenance releases are normally provided to PE/EE customers and ZOL users only. We always try to maintain the best compatibility within the same branch so upgrading within the same branch should require minimum effort.

ZK is a very innovative framework where we try to include new technologies, simpler solutions, better codes in new versions. This means some older technologies would be deprecated or removed in order to produce a lighter and more concise product. Upgrading to another major version would sometimes require more effort. In case of any doubt in upgrading to a major version, we recommend that you reference Upgrade Note or consult with [email protected].