Skip to content
Klaus Rettinghaus edited this page Feb 9, 2017 · 15 revisions

CSV2CMI

About

CSV2CMI is a little program to transform a table of letters (given as .csv) into the CMI format. The CMI format is the underlying data format for the web service ‘correspSearch’ which facilitates searching across diverse distributed letter repositories.

It's intended for printed (print only) editions and catalogues of letters.

Usage

You have to name your columns as follows:

  • name of the sender: "sender"
  • name of the addressee: "addressee"
  • IDs of the named persons/organisations: "senderID" and "addresseeID"
  • the date, when the letter has been sent: "senderDate"

You may provide places as additional information:

  • where a letter has been sent: "senderPlace" (with the appropriate "senderPlaceID" as proper GeoNames URL)
  • where a letter has been received: "addresseePlace" (with the appropriate "addresseePlaceID" as proper GeoNames URL)

If your letters are printed across different editions, add an "edition" column and put in there the bibliographic records. Numbering of letters should be stated in a additional column named "key". Alternatively you may enter in this column a link to the edited letter on the web. It uses authority control information to differentiate between persons and organisations and tags them with the appropriate element. If no ID is provided persName is used as default. If a date is put within brackets it sets @cert to 'medium', for persName, orgName, and placeName alike @evidence is set.

Check, that your table is using UTF8-encoding!

Metadata for the resulting file can be given in the configuaration file csv2cmi.ini.

Known limitations:

  • only a single date can be set
  • a config file must be present

License

This program is available under The MIT License (MIT)

Clone this wiki locally