Migrating Datacap Navigator custom panels to Datacap 9.0 Feature Pack 2 or later

Starting with IBM® Datacap Version 9.0 Feature Pack 2, Datacap Navigator custom panels are stored in a new location.

About this task

In Datacap Version 9.0 and Feature Pack 1, Datacap Navigator custom panels were stored in the following folder:

\IBM\WebSphere\AppServer\profiles\AppSrv01\installedApps\node_name\ navigator.ear\navigator.war\dcpanels\application_name\

In Feature Pack 2, Datacap Navigator custom panels are stored in the following folder:

Datacap_installation_folder\application_name\navigatorpanel\panels

If you created custom panels in Datacap Version 9.0 or Feature Pack 1 and want to use them in 9.0 Feature Pack 2 or later, you must move your panels to the new location and create an XML file that names the custom panels.

Procedure

To migrate Datacap Navigator custom panels to Datacap Version 9 Feature Pack 2 or later:

Copy the custom panel (JSON file) that you want to migrate from this location:
\IBM\WebSphere\AppServer\profiles\AppSrv01\installedApps\node_name\ navigator.ear\navigator.war\dcpanels\application_name\
Paste the custom panel file into this folder:
Datacap_installation_folder\application_name\navigatorpanel\panels
Remove the *.json file extension from your custom panel file name. For example, if the name of your custom panel file is MyPanel.json, change the file name to MyPanel.
Using a text editor, create an XML file that names the custom panel. For example, if the name of your custom panel is MyPanel, create an XML file with the following content:
```
<Panels>
   <Panel name="MyPanel" />
</Panels>
```
Name the file panels.xml and save it in the following folder, on the same level as the panels folder:
Datacap_installation_folder\application_name\navigatorpanel\

Important:
Ensure that the name of your custom panel is specified in the same way in the panels folder, in the panels.xml file, and in the Name field on the Datacap Navigator Administration View > Panel page.