This section is designed for users coming from ZK Spreadsheet (ZSS). Please make sure to back-up your current project before upgrading.
Drop-in Upgrade (Evaluation Only)
This approach can quicky turn your existing ZSS application to Keikai applicaiton without modifying your source. Note that this is for evaluating purpose only as it does not cover all Keikai features. To officially migrate your existing ZSS application to Keikai, please read the next section: How to migrate from ZSS.
The steps for quick try are:
- download keikai-zss-legacy-all-[VERSION].zip
- extract the zip.
It produces 2 sub folders:
- put your zss application war under the same folder
- go to the folder and run
If it succeeds, the repacked, new WAR with the same name will be put under the same folder. Your original WAR will be renamed to
WAR_FILE_NAME.backup. Just run the repacked WAR file – it is a Keikai App already!
(Note: This approach renames Keikai jar file in bytecode level at run-time by jarjar which is not recommended in the production environment.)
How to Migrate from ZSS
It is very easy to migrate your existing ZSS project to Keikai, just need to handle the following changes:
replace all ZSS related JAR with Keikai related JAR. Reference POM
API Package Change
Only the package names are changed, all method names are backward compatible. You just need to replace the old import statements with new ones. It’s better to use your IDE keyboard shortcut to quickly replace import statments.
- Old package name (
- New package name (
- Method names are unchanged.
License Path Change
This is for paying customer only. Please refer to Applying License Key.
Sheet Tab Context Menu is Hidden by Default
Keikai adds a new attribute
showSheetTabContextMenu. If you want to show the context menu on a sheet tab you need to specify as follows:
<spreadsheet showSheetbar="true" showSheetTabContextMenu="true"/>
Custom Function Prefix Change
The prefix now should be
<?xel-method prefix="keikai" name="CHAIN" ...?> <?taglib uri="/WEB-INF/tld/function.tld" prefix="keikai" ?>
The following configurations also change in Keikai, but you can keep your original one since Keikai still reads the old configuration.