Readme

If you are looking for documentation on the UserVitals API, Widgets or Single Sign On visit developers.uservitalshq.com instead.

Import Tool

The uservitals import tooling can be used for uploading feedback from other systems such as Canny, Productboard, and many more, including your own spreadsheets.

npx @uservitals/import

Importers

Canny CSV

Canny posts can be imported into a UserVitals team from your Canny board CSV export file.

Following fields are supported:

• Title - Story title
• Details - Used as story description
• Status - Used as story status. All canny statuses are suppported.
• Author Name - Used as creator of the story
• Author Email - Used as creator of the story
• Labels - Added as tags to story
• Category - Assigned as a category to story.

Productboard CSV

Productboard features and notes can be imported into a UserVitals team from your Productboard board CSV export file.

The following fields are supported for features:

• name - Story title
• description - Used as story description
• state_name - Used as story status. State will default to 'Open' if status is not compatible with UserVitals.
• feature_type - Story category
• owner_name - Ignored

The following fields are supported for notes:

• note_title - Message title
• note_text - Message content
• state - Unprocessed will be converted to 'Unreviewed', all other states will be converted to 'Reviewed'
• creator_email - Assigned as the creator of the message
• creator_name - Assigned as the creator of the message
• user_email - Assigned to the contact of the message
• user_name - Assigned to the contact of the message
• source_url - Assigned to the sourceUrl of the message

Generic CSV

Generic CSV files can be imported into a UserVitals team from your CSV export file.

The following format is supported:

• Text - Used as the insight text
• Type - Used as the insight type
• Submitter Name - Assigned as the creator of the insight
• Submitter Email - Assigned as the creator of the insight
• Contact Name - Assigned as the contact of the insight
• Contact Email - Assigned as the contact of the insight
• Name - Used as the story name
• Description - Used as the story description
• Private Description - Used as the story private description
• Status - Used as the story status
• Visibility - Used as the story visibility.'VISIBLE' and 'HIDDEN' are supported
• Labels - Added as labels to the story. They can be comma separated

Generic Changelog CSV

Changelogs can be imported into a UserVitals team from a generic CSV file

The following format is supported:

• content - Used as the changelog content
• title - Used as the changelog title
• labels - Used as the changelog labels, can be comma separated

Trello JSON import

Stories can be imported into a UserVitals team from a Trello board.

The following format is supported:

• desc - Used as the story content
• cardName - Used as the story title
• listName - Used as the story listName

Export the JSON from your Trello board.

1. Click "Show menu"
2. Select "Print and export"
3. Select "Export as JSON" and save the JSON file.
4. Run this importer and select the Trello (JSON export) option

Our importer will allow for custom column mapping of Trello columns to UserVitals roadmap statuses. As well support for importing Trello labels on cards.

AnnounceKit JSON import

Changelogs can be imported into a UserVitals team from an AnnounceKit changelog.

The following format is supported:

• summary - Used as the changelog content
• title - Used as the changelog title
• tags - Used as the changelog labels, can be comma separated

Export the JSON from your AnnounceKit changelog.

1. Select an AnnounceKit changelog you would like to import
2. add "/jsonfeed.json" to the end of your Announcekit Changelog url.
3. Right Click and Select "Save as"
4. Save the file in an easy to reach location.
5. Run this importer and select the AnnounceKit (JSON export) option

Beamer JSON import

Changelogs can be imported into a UserVitals team from a Beamer api key.

The following format is supported:

• contentHtml - Used as the changelog content
• title - Used as the changelog title
• category - Used as the changelog labels, can be comma separated

Export the posts from your Beamer changelog.

1. Click "Settings"
2. Select "API" and create a new API key
3. Copy the key to your clipboard
4. Run this importer and select the Beamer (JSON export) option

Headway RSS import

Changelogs can be imported into a UserVitals team from a Headway RSS url.

The following format is supported:

• description - Used as the changelog content
• title - Used as the changelog title
• category - Used as the changelog labels, can be comma separated

Export the posts from your Headway changelog.

1. Select a Headway changelog you would like to import
2. add "/rss" to the end of your Headway Changelog url.
3. Copy the url to your clipboard
4. Run this importer and select the Headway (RSS export) option

License

Licensed under the MIT License.