Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Any search results can be exported to a csv file by clicking on “Export Current Search to CSV” at the top of the search results list. Try to make your search as specific as possible before exporting. Particularly consider whether you need to work with both asset and item metadata. Their different metadata profiles mean that your data will have more columns if you include both in the export. This may cause unnecessary post-export cleanup work. If you do need to work with both, it is likely worthwhile to export them separately.

Image Modified


To download the file, click the link that appears at the top of the page. If it has disappeared, click on “CSV Exports” under the “Manage'' dropdown on the navigation bar at the top of the page. This will take you to a page listing all of the exports you have recently done. Exports are logged in Hyacinth so you can download them again later if you need to (very helpful if you accidentally overwrite data; the export is a snapshot of the records before changes were made).

...

Warning

There is one major exception to this assumption. Make sure you understand the implications of editing field blocks as explained herebelow. Not keeping field blocks intact is the easiest way to accidentally overwrite data during remediation.

Recognizing field blocks in CSV exports

If a field contains a colon (:), that means that the field is a part of a field block. If you update one of the fields in the block, you must include all the fields in the block in the import spreadsheet or Hyacinth will assume the other fields in the block have null value. This can cause you to lose data as empty columns overwrite existing data. For example, here is a field block of parent publication fields. You can tell they are in a block because they have the same prefix ("parent_publication-1:").

  • parent_publication-1:parent_publication_doi
  • parent_publication-1:parent_publication_issue
  • parent_publication-1:parent_publication_page_end
  • parent_publication-1:parent_publication_page_start
  • parent_publication-1:parent_publication_title-1:parent_publication_title_sort_portion
  • parent_publication-1:parent_publication_volume

Field blocks are also recognizable in the Hyacinth web UI by their presentation:

Image Added

If you would like to update information in one of these fields using a spreadsheet created by csv export, DO NOT delete the other columns that are a part of your block. Leave the existing data in the other columns and include all the columns in your import spreadsheet.

Questions?

If you are uncertain about anything, it is much better to ask than to plow ahead. Send questions to hyacinth-support@library.columbia.edu. Don't worry whether the question is big or small. Someone will gladly help you.