C.1 Procedure for migrating plugins developed in old versions
By migrating I/O Plugins and Suspend/Resume Plugins developed in an old version (version 09-50 or later), you can use them in Navigation Platform. To migrate such plugins:
-
See 4.1 Creating template plugins and create a new template plugin.
Apply the values specified in version 09-50 or later to the plugin information property file of the new template.
- Values you must apply:
-
The value specified for the userplugin.id key
The value specified for the userplugin.name key
The value specified for the userplugin.server.controller.ioaction.type key
For details about the storage location of the plugin information property file for plugins of version 09-50 or later, see the manual used for development.
-
Overwrite the new template plugin files with the files of version 09-50 or later.
Table C‒1: List of files for overwriting (common) No.
Files of version 09-50 or later
Copy destination folder
Copy is required if:
1
Files directly under Navigation-Platform-installation-directory\pluginSDK\plugin\plugin-name\WEB-INF\lib
Navigation-Platform-installation-directory\pluginSDK\plugin\plugin-name\WEB-INF\lib
The file to be loaded to Application Class Loader is added.
2
Files directly under Navigation-Platform-installation-directory\usrlib\app#1
3
Files directly under Navigation-Platform-installation-directory\usrlib\sys#2
Navigation-Platform-installation-directory\usrlib\sys
The file to be loaded to System Class Loader is added.
4
Files directly under the path specified for the add.class.path key added by the developer to the option definition file for J2EE servers (usrconf.cfg)#2
5
Navigation-Platform-installation-directory\pluginSDK
\base\dd\META-INF\cosminexus.xml#1
Navigation-Platform-installation-directory\pluginSDK\plugin\plugin-name\dd\META-INF
Resource adapter settings are added.
6
portal-project\WEB-INF\web.xml#1
Navigation-Platform-installation-directory\pluginSDK\plugin\plugin-name\WEB-INF
-
For I/O Plugins, further overwrite the files listed below in the new template plugin files.
Table C‒2: List of files for overwriting (I/O Plugin) No.
Files of version 09-50 or later
Copy destination folder
Note
1
Files directly underNavigation-Platform-installation-directory\pluginSDK\plugin\plugin-name\images
Navigation-Platform-installation-directory\pluginSDK\plugin\plugin-name\images
Copy all the files even if there are more old version files than new template plugin files.
2
Navigation-Platform-installation-directory\pluginSDK\plugin\plugin-name\WEB-INF\conf\ioaction.xml
Navigation-Platform-installation-directory\pluginSDK\plugin\plugin-name\WEB-INF\conf
Apply the contents of the old version file by editing the file of the same name in the copy destination folder, rather than copying the old file to overwrite the new one.
Note that the URL specified for the iconURL tag is different from that of old versions.
- The value specified for the iconURL tag in old versions
-
"/plugin-name/images/file-name"
- The value specified for the new iconURL tag
-
"/ucnpPlugins/plugin-name/images/file-name"
-
For migration from 09-60
The button type specified for the diableButtonType tag allows you to distinguish between transfer by buttons and direct transfer. If you want the same operation as that in 09-60, specify true for the legacy attribute.
3
Navigation-Platform-installation-directory\pluginSDK\plugin\plugin-name\WEB-INF\src\Java-package\controller\I/O-action-controller.java
Navigation-Platform-installation-directory\pluginSDK\plugin\plugin-name\WEB-INF\src\Java-package\controller
Change the character code to UTF-8 while retaining the file contents, and then overwrite the file.
-
For Suspend/Resume Plugins, further overwrite the files listed below in the new template plugin files.
Table C‒3: List of files for overwriting (Suspend/Resume Plugin) No.
File of version 09-50 or later
Copy destination folder
Note
1
Navigation-Platform-installation-directory\pluginSDK\plugin\plugin-name\WEB-INF\src\Java-package\controller\I/O-action-controller.java
Navigation-Platform-installation-directory\pluginSDK\plugin\plugin-name\WEB-INF\src\Java-package\controller
Change the character code to UTF-8 while retaining the file contents, and then overwrite the file.
-
If the plugin uses a resource adapter, see 4.4 Adding database connection processing and then add resource adapter settings.
-
Build, deploy, and then debug the plugin in the same way as for creating a new plugin.