MindTouch Connector
Intro
MindTouch is a document content management system that helps you organize your documentation so users can easily find it. Use Domo's MindTouch connector to retrieve page ratings, user and group listings, site activity reports, and more. To learn more about the MindTouch API, visit their page (https://success.mindtouch.com/Soluti..._Documentation).
You connect to your MindTouch account in the Data Center. This topic discusses the fields and menus that are specific to the MindTouch connector user interface. General information for adding DataSets, setting update schedules, and editing DataSet information is discussed in Adding a DataSet Using a Data Connector.
Prerequisites
To connect to your MindTouch account and create a DataSet, you must have the following:
-
The domain for your MindTouch instance (e.g. mycompany.mindtouch.com)
-
The username for your MindTouch account
-
Server API Token Key
-
Server API Token Secret
To learn how to obtain your Server API Token Key and Secret, visit Get A Server API Token.
Connecting to Your MindTouch Account
This section enumerates the options in the Credentials and Details panes in the MindTouch Connector page. The components of the other panes in this page, Scheduling and Name & Describe Your DataSet, are universal across most connector types and are discussed in greater length in Adding a DataSet Using a Data Connector.
Credentials Pane
This pane contains fields for entering credentials to connect to your MindTouch account. The following table describes what is needed for each field:
Field |
Description |
---|---|
Domain | Enter the domain for your MindTouch instance (e.g. mycompany.mindtouch.com) |
Username | Enter your MindTouch username. |
Server API Token Key | Enter your MindTouch Server API Token Key. For more information, see Prerequisites. |
Server API Token Secret | Enter your MindTouch Server API Token Secret. For more information, see Prerequisites. |
Once you have entered valid MindTouch credentials, you can use the same account any time you go to create a new MindTouch DataSet. You can manage connector accounts in the Accounts tab in the Data Center. For more information about this tab, see Managing User Accounts for Connectors.
Details Pane
This pane contains a primary Reports menu, along with various other menus which may or may not appear depending on the report type you select.
Menu |
Description |
||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Report |
Select the MindTouch report you want to run. The following reports are available:
|
||||||||||||||||||||||||||||||
Filter | Select whether to retrieve all pages or only those that have been rated. | ||||||||||||||||||||||||||||||
Report Date Type | Select whether to retrieve data for a specific date or relative number of days back. | ||||||||||||||||||||||||||||||
Specific Date | Select the date you want to retrieve data for. | ||||||||||||||||||||||||||||||
Days Back | Enter the number of days back you want to retrieve data for. |
Other Panes
For information about the remaining sections of the connector interface, including how to configure scheduling, retry, and update options, see Adding a DataSet Using a Data Connector.