Migrate a Project from an Earlier Version of Kony Studio or Visualizer

You can import projects into Quantum Visualizer that were originally created using Kony Studio and earlier versions of Quantum Visualizer.

If your project was created using a version of Kony Studio older than 6.0, you first must import it into Kony Studio 6.0 (with the latest hotfix) and then you can import it into Quantum Visualizer.

To migrate your application to Quantum Visualizer, do the following: 

  1. If your application is built in Kony Studio versions prior to 6.0, import your application to Kony Studio 6.0 GA version (with the latest hotfix applied).
    It is recommended that you take a backup of your project before importing it into Quantum Visualizer.
  2. After importing to Kony Studio 6.0 GA, do the following:
    1. Right-click on the project and select Utilities.
    2. From the options available, select Upgrade the project to the current version.
    3. A confirmation message appears. Click OK.
  3. Once the project is upgrade, export your application.
  4. Import the application to Quantum Visualizer. To do so, on the File menu (the Project menu in Quantum Visualizer), click Import.
  5. Do one of the following:
    • If your project is located in a standard project folder structure (i.e. has not been zipped up as an archive (.zip) file), click the Browse button for Select project root, navigate to the root folder of the project you want to import, and then click OK.
    • If you are importing an archive (.zip) file, click Select archive file, click its Browse button, navigate to the root folder of the project you want to import, and then click OK.
  6. In the case of a Quantum Visualizer project, to convert designer actions to developer actions, select Copy 'Designer Actions' to 'Developer Actions'. Be aware that in doing so, any developer actions that the project contains are overwritten.
  7. In the case of a Kony Studio project, to import its services to Quantum Fabric, select Import services into Quantum Fabric. In Quantum Visualizer, all services are managed through Quantum Fabric. Importing them adds them to the Quantum Fabric workspace.
  8. Click Finish. Quantum Visualizer imports the project.

    For projects imported from Kony Studio, all deprecated widgets found in the upgrade process are deleted from the application.

    • Duplicate widgets are renamed automatically.
    • Duplicate skins are renamed automatically.
    • Reserved keywords are renamed automatically.
    • You can find all changes in a log file located in the project root folder. For example, <ApplicationName>_upgradeLog.log. If there were no changes in the application, the log file will not be created.
    • You must take necessary action on any of the issues in the warning section in the log file.
  9. In the Migration Report dialog box, click Save.  Locate and open the migration report, open the project in Kony Studio and, using the migration report to guide you, fix the issues. After all the issues are fixed, export the application from Kony Studio. Then in Quantum Visualizer, attempt to import the project again.

Important Considerations

The following are the important things to consider while migrating a project created in Kony Studio to Quantum Visualizer.

  • If your project was originally created using Quantum Visualizer 2.5 that was then imported into Kony Studio 6.5, and you import it into the latest version of Quantum Visualizer, the action sequences are not imported.
  • If yours is a Kony Visualizer 2.5 or earlier project, importing it updates it so that it can take advantage of all the features of Quantum Visualizer, but your earlier version of Quantum Visualizer you will no longer be able to open it.
  • If the app that you are migrating from Kony Studio or an earlier version of Quantum Visualizer was configured with custom connectors, you need to migrate them to Quantum Fabric as a consolidated service definition (CSD). For more information, see Migrate a Consolidated Service Definition to Quantum Fabric in the Quantum Fabric Console User Guide.
  • Ensure that you import the splash image when importing projects from Kony Studio. Importing the splash image will fix any inconsistencies related to Flex and VBox properties.
  • Refresh of model files will take place if Import service to Quantum Fabric is selected while migrating the app. If Import service to Quantum Fabric is cleared at time of migration and later the import to Quantum Fabric is performed then the refresh of sync client code will not happen automatically. In this case, right-click Quantum Fabric in Project Explorer and select Refresh Sync Client Code option.