Importing and Exporting Topics

Overview

You can export consumer groups as a file to the local directory or batch import topics to ROMA Connect using a local file.

Prerequisites

• Before importing a topic, ensure that the integration application to which the topic belongs has been created. Otherwise, create an integration application first.
• Before importing a topic, check whether a duplicate topic name exists in the instance to which the topic is to be imported. If there are duplicate topic names, the topic will fail to be imported.
• Ensure that the quota of topics meets the requirements before importing the topics.
• If the description of a topic contains a newline character, the newline character is escaped to \n in the exported CSV file of the topic. Therefore, if you import topics using such exported CSV files, manually modify the escape character \n back to a newline character.
• The file to be imported can contain a maximum of 100 topics. Otherwise, the topics cannot be imported.
• Do not edit the exported CSV file in Excel. Otherwise, the file cannot be used to import topics. To edit an exported file and then import it, export the file in XLSX or XLS format for editing.
• Topics that are not bound to any integration application cannot be exported.

Importing Topics

1. Log in to the ROMA Connect console. On the Instances page, click View Console next to a specific instance.
2. In the navigation pane on the left, choose Message Queue Service > Topic Management. On the page displayed, click Import.
3. In the dialog box displayed, select a local topic file and import it.
4. After the import is successful, you can view the imported topics in the topic list.

Exporting Topics

1. Log in to the ROMA Connect console. On the Instances page, click View Console next to a specific instance.
2. In the navigation pane on the left, choose Message Queue Service > Topic Management.
3. Export topics.
   • Specified topics: Select the topics to be exported and choose More > Export to export a topic file to the local directory.
   • Exporting all topics: Click Export All to export a topic file to the local directory.
4. In the displayed dialog box, select the format of the file to be exported and export the topic file to the local directory.
   • Topics can be exported to XLSX, XLS, and CSV files. If the topic data contains commas (,), do not export the data to a CSV file because the CSV file will not be parsed properly.
   • In the exported file, the Type field indicates the permission type of the topic's integration application. 1 indicates that the integration application is the one to which the topic belongs. 2 indicates that the integration application has the publish permission for the topic while 3 indicates the subscribe permission.
     For example, Topic1 belongs to App1 and has been granted permission for App2. Then the records of Topic1 are as follows:

     • If App1 is configured with the publish and subscribe permissions, there are three Topic1 records about App1 in the exported file, and the values of Type are 1, 2, and 3, respectively.
     • If App1 is configured only with the publish or subscribe permission, there are two Topic1 records about App1 in the exported file, and the values of Type are 1 and 2, or 1 and 3.
     • If App2 is configured with the publish and subscribe permissions, there are two Topic1 records about App2 in the exported file, and the values of Type are 2 and 3, respectively.
     • If App2 is configured only with the publish or subscribe permission, there is one Topic1 record about App2 in the exported file, and the value of Type is 2 or 3.