Section 3.8: Exporting and Importing Configuration Data

Exporting Data | Importing Data | XML Schema Validation and Documentation

TouchTerm supports a standard XML format which can be used to be import and export configuration data. This makes it easy to:

• Back up your configuration data: simply Export All Data to back up all of your configuration information.
• Install official Add-Ons from our site, or from other users in the TT community.
• Share and exchange Keypads or Profiles with other TT users or the TT user community.
• Use a text editor on your desktop or laptop to more quickly and efficiently set up complicated configurations.
• Support importing connection information using a script to generate a TT Pro data file.

Exporting Data

(Back to Top)

Use the Actions in the "Import/Export" for performing import and export functions. There are specific actions for exporting your Saved Connections, a single Configuration Profile, or a single Keypad. You can also use the Export All Data action to export all of your TT Pro configuration data.

All of these Actions will copy the exported TT Pro data file to the Clipboard. You can use the E-Mail Actions to send the data file in E-mail, or else use a text editor in your terminal session to paste the contents of the data file into a new text file.

Importing Data

(Back to Top)

There are two main ways to import TT Pro data: from a data file directly, or from a special URL set up with a TT Pro data file.

For the first method, you'll need to have the TT Pro data file available on one the remote hosts you connect with using TouchTerm. After connecting to the host, use the cat command (or something similar) to display the entire contents of the TT Pro file in the terminal session. Then, use the Copy and Paste mechanism to copy the contents of the data file to the Clipboard. Finally, use the Import Clipboard Data action to import the data into TouchTerm.

The second method is much easier, but also requires that the proper URL be set up, as is done for example on our Add-Ons page. These use the "ttprodata://" URL scheme, which is recognized by TT Pro and then used to automatically download and import the associated data file. Simply navigate to any "ttprodata://" URL directly from your device to have TT Pro import the associated data file.

In either case, please note that when configuration data are imported, any conflicting names will cause the existing versions to be overwritten. For example, if you already have a Keypad named "My Keypad", and then import a data file with a Keypad named "My Keypad", then the newly imported Keypad will replace the old one.

Especially for this reason, be sure that you trust the source of any TT Pro data file before importing it! All downloads from our Add-Ons page will be guaranteed to be safe, but be wary of any files shared from other users. In theory, it shouldn't be possible to do any harm or access any secure information by simply importing a data file, but it's always best to be on the safe side.

XML Schema Validation and Documentation

(Back to Top)

The TouchTerm Pro XML Data format is documented by an XML schema. With this schema, you can use any number of XML validation tools to ensure your data files are in the proper format before importing them into TT Pro. (There's also an online validation tool available.) The schema has also been coverted into a reference page for use when hand-editing TT Pro data files.