Import tag definitions with DBLoad

When you import the contents of a file with DBLoad, all tag definitions are imported into the Tagname Dictionary of the selected InTouch application.

If the import fails, a message appears describing the reason for the failure. The error messages are written to the Logger.

Import tag definitions into an InTouch application

1. Close WindowMaker and WindowViewer.

2. Back up the application whose Tagname Dictionary will be loaded with tag definitions from an import file.

3. Start Application Manager.

4. Select the application from the list whose Tagname Dictionary will receive the imported tag definitions.

5. On the File menu, in the Data group, select DBLoad.

   A message appears requesting confirmation that you backed up the InTouch application.

6. Select Yes to confirm the application is backed up.

   The CSV File to Load From dialog box appears.

   

7. In the Name of CSV Load file box, locate and select the file you want to import.

8. Select OK.

   The next step varies based upon whether DBLoad imports new or existing tag definitions to the Tagname Dictionary.

   • If you are importing new tag definitions, the new tag data is loaded into the application’s Tagname Dictionary. A message appears confirming the data was successfully loaded and merged.

   • If you are importing existing tag definitions, the import stops if the :mode keyword is set to :mode=ask and the import file contains duplicate tags. You are shown options to handle the duplicate tags or you can cancel the import. For more information about keyword options, see Set the operating mode for dictionary import files.

Known Limitation with Importing Tag Definitions using DBLoad Utility

The DBLoad utility may fail to import files or show performance issues when importing huge tag count newtag.tag files of file size exceeding 2 GB.

Limitations:

•   DBLoad may fail to import huge tag count file, if newtags.tag file size exceeds 2GB limit.

•   DBLoad will hit performance issues while importing huge tag count CSV file.

Workaround:

Use the following registry entry to avoid importing tags to newtags.tag file, and instead import to the Tagname.x file.

9. Open the Registry Editor.

10. Navigate to HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Wonderware\InTouch\Installation.

11. Right-click on the Installation folder in the navigation pane, or anywhere in the main area, select New, and select DWORD value.

12. Rename the newly created file as DisableWriteToNewTag.

13. Set “DisableWriteToNewTag” key to 1.

14. Now, import tags using DBLoad from CSV file, and the import will be successful.

The effect of different values of DisableWriteToNewTag registry key on the import functionality is listed below:

Note: For InTouch HMI version 2023 onwards, the registry key DisableWriteToNewTag is not present by default, and the DBLoad Utility skips importing to the newtags.tag file.