CSV Import is a module for Omeka S and will allow users to import Entities from a simple CSV (comma separated value) file, and then map the CSV column data to Entity. Each row in the file represents metadata for a single Entity.
Furthermore, it’s possible to import directly files in formats TSV (tab separated value), a simpler and more efficient format, and ODS (OpenDocument Spreadsheet, the ISO standard office format for spreadsheets, managed by LibreOffice and a lot of other tools) directly.
Most often, the import will create new Omeka S items. It is also possible to import item sets, media and users, and other modules can add other import types. It’s possible to import mixed resources in one file too.
See the Omeka S user manual for user documentation.
CDASH Modification:
For applications that involve importing multiple batches of items and media, field mappings may be saved as a JSON file and re-loaded. Mappings are set up and tested using the manual mappings form. Once validated, the JSON array of mappings can be copied from the Job Details report and saved as a local file that can subsequently be loaded via the import form.
To save and re-use the import config, go to Past Imports, Click Job Details, and copy the JSON array that appears between the heading for Args and Log. Paste these into a JSON file, this would be a plain text file with a JSON suffix. Subsequently, this JSON file can be added on the initial import form.
Download the Development branch from this repo. Your module folder needs to be named CSVImport. For reference, you can look at the Omeka team's module.
To install CSV Import from the source, go to the root of the module, and run composer install. Users using the pre-packaged downloads from the Releases page or the omeka.org module directory don't need to worry about this step.
See general end user documentation for Installing a module.
To be able to import ods, the php extensions zip and xml should be installed (default in most cases).
Use it at your own risk.
It’s always recommended to backup your files and your databases and to check your archives regularly so you can roll back if needed.
See online issues on the Omeka forum and the module issues page on GitHub.
The Corporation for Digital Scholarship distributes the Omeka source code under the GNU General Public License, version 3 (GPLv3). The full text of this license is given in the license file.
This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
Current maintainers:
- Omeka Team
- Daniel Berthereau (see Daniel-KM on GitHub)
- CSVImport is Copyright © 2015-present Corporation for Digital Scholarship, Vienna, Virginia, USA http://digitalscholar.org
The Omeka name is a registered trademark of the Corporation for Digital Scholarship.
Third-party copyright in this distribution is noted where applicable.
All rights not expressly granted are reserved.
- Copyright Daniel Berthereau, 2017-2019