What is Roundtrip?

Last Updated: Jul 18, 2017 12:14PM PDT
In Mukurtu CMS, Roundtrip refers to the suite of tools that allow you to import and export your content from your Mukurtu site. You can use roundtrip to import and export both media and metadata, and can select at a granular level which content to work with. All of the roundtrip tools are accessible through the administrator dashboard, and are available to Mukurtu Administrators. The roundtrip tools all use CSV spreadsheets for metadata, and zip archives for media assets – your content is never locked into proprietary formats or workflows with Mukurtu CMS, and you are free to manage it as needed.
 
As of Mukurtu CMS 2.0.7 the list of roundtrip tools include:
  • Import Digital Heritage Metadata: used to create new, or update existing digital heritage items. Media assets that are already uploaded can be linked to items, but this tool only uploads a metadata spreadsheet, not media assets.
  • Import Digital Heritage Community Records: used to create new, or update existing community records on existing digital heritage items. Media assets that are already uploaded can be linked to items, but this tool only uploads a metadata spreadsheet, not media assets.
  • Import Dictionary Words: used to create new, or update existing dictionary words. Media assets that are already uploaded can be linked to items, but this tool only uploads a metadata spreadsheet, not media assets.
  • Import Dictionary Word Entries: used to create new, or update existing additional dictionary entries on existing dictionary words. Media assets that are already uploaded can be linked to items, but this tool only uploads a metadata spreadsheet, not media assets.
  • Import Digital Heritage Metadata from Zip Archive: used to create new, or update existing digital heritage items, media assets, communities, and cultural protocols. This can be used to rebuild the exact contents of one site in a new installation.
  • Export Digital Heritage Metadata: used to export digital heritage items and media assets. Exported content can then be edited and re-imported, used as a backup, or shared elsewhere.

 
Mukurtu CMS uses CSV spreadsheets with UTF-8 character encoding. Some spreadsheet tools do not properly implement UTF-8 encoding. We have tested several tools and can recommend the following:
  • Google Sheets on Windows and macOS
  • LibreOffice on Windows and macOS
  • Apache Open Office on Windows and macOS
  • Excel on Windows (note that if a spreadsheet is incorrectly encoded in Excel, and then re-saved with UTF-8 encoding, despite showing the correct setting, the file may not actually be properly encoded. If this happens, copying and pasting the content into another tool such as Google Sheets usually corrects the encoding.)
Excel on macOS does NOT properly encode UTF-8 files, and will not work properly.
If you have tested other tools and platforms, please let us know so we can update this article.
Please note that the "Import Images/Audio/Video/Files" tools on the dashboard are not intended to be used for updating media metadata. The best way to edit media metadata is through the web interface, or by exporting content, then importing an updated spreadsheet. These tools will likely be removed from the dashboard in a future release.