PERMISSION REQUIRED
VIEW_QUESTION_LIST and EDIT_SETTINGS (USE_API for services APIs only).
Only one instance of BulkTopicExporter can be in progress at a time. Any subsequent requests to start one will fail.
To start the operation through the API, a POST can be made to /services/v2/topic/bulkExport.json. If there is not currently a bulk export operation in progress, then the call will return 202 – Accepted.
NOTE
Only one bulk operation can be in progress at a time. Any subsequent requests made while an operation is in progress will result in a 403 - Forbidden error.
When bulkExport/status.json indicates that the operation is complete, then calling GET on /services/v2/topic/bulkExport.json will return the bulk export csv file.
The BulkTopicExporter will query the topics for the site including deleted topics and merged topics. The csv file will have the following format with entries for all nodes at the beginning and then entries for child and merged node relationships following:
| Master Node | Target Node | Action | Description | Icon | Locale (Future Use) | Synonym (Future Use) | Last Updated by User | Date of Last Update |
|---|---|---|---|---|---|---|---|---|
| Topic | Create | Description | User | Timestamp | ||||
| ParentTopic1 | Create | Description | User | Timestamp | ||||
| ParentTopic2 | Create | Description | User | Timestamp | ||||
| ChildTopic1 | Create | Description | User | Timestamp | ||||
| ChildTopic2 | Create | Description | User | Timestamp | ||||
| DeletedTopic | Create | Description | User | Timestamp | ||||
| MergedTopic | Create | Description | User | Timestamp | ||||
| MergedIntoTopic | Create | Description | User | Timestamp | ||||
| DeletedTopic | Delete | Description | User | Timestamp | ||||
| ParentTopic1 | ChildTopic1 | Child | ||||||
| ParentTopic2 | ChildTopic2 | Child | ||||||
| ParentTopic3 | ChildTopic3 | Child | ||||||
| MergedIntoTopic | MergedTopic | Merge |
In the above formatted data, ParentTopic1 has 2 children and ChildTopic1 has two parents.
All fields in the output will be contained in double quotes to allow for embedded commas and double quotes in the values. If the value contains a double quote, then the double quote will have to be escaped. For example, the value:
Here is a “quote” string, with a comma
will appear as follows in the csv:
“Here is a “”quote”” string, with a comma”