
L’import de données dans Omeka Classic ou Omeka S, à l’aide du module CSVImport pose parfois quelques difficultés. Ce module exige un nombre de champs correct, des doubles guillemets pour encadrer les colonnes, de même qu’un encodage Unicode UTF-8 sans BOM (Bit Ordering Mark / Indicateur d’ordre des octets) du fichier d’import. Comment alors transcoder un tableau Excel au format Windows en un fichier CSV UTF-8 compatible ?
Il est conseillé d’abandonner provisoirement Excel. Ce logiciel encode par défaut en Windows 1252, extension de ISO/CEI 8859-1, autrement dit Latin-1 ou Europe occidentale. Le transcodage en UTF-8 ne se passe pas très bien avec Excel. Mauvaise gestion des doubles guillemets et du nombre de champ. Vous pouvez avantageusement utiliser pour cette tâche Open Office, ou bien Libre Office Calc. Ouvrez votre tableau, sauvegardez vos données dans Fichier > Enregistrer sous > Texte CSV. Puis sélectionnez « Éditer les paramètres du filtre« , on remplit UTF-8 ainsi que les séparateurs de champ et de texte adéquats. Les données sont alors encodées de manière correcte. L’encodage est spécifié Unicode UTF-8, le séparateur de champs : la virgule (Comma en anglais) et de textes (« ). Et voilà !

Un exemple de données à importer se trouve dans le répertoire /plugins/CsvImport/csv_files. Des tests sont possibles avec le fichier test_automap_columns_to_elements.csv. Des mots clés et fichiers du web sont ainsi importés :
Dublin Core:Title, Dublin Core:Creator, Dublin Core:Description, tags, file
"Walden", "Henry David Thoreau", "A man seeks simplicity.", "book, classic, New England", "http://upload.wikimedia.org/wikipedia/commons/2/25/Walden_Thoreau.jpg, http://upload.wikimedia.org/wikipedia/commons/b/ba/Henry_David_Thoreau.jpg"
"The Count of Monte Cristo", "Alexandre Dumas", "A man seeks revenge.", "book, classic, France", "http://upload.wikimedia.org/wikipedia/commons/c/c3/Edmond_Dant%C3%A8s.JPG"
"Narrative of the Life of Frederick Douglass", "Frederick Douglass", "A man seeks freedom.", "book, classic, Maryland", "http://upload.wikimedia.org/wikipedia/commons/f/f5/Sketchofdouglass.jpg"
Le formalisme de la première ligne (Dublin Core:Title) peut être suivi. Cette convention de nommage des colonnes rend plus aisée la seconde étape. L’appariement (mapping) entre les colonnes du tableau et les métadonnées spécifiées dans Omeka devient automatique. Les champs répétés (tags dans l’exemple) sont placés entre guillemets, séparés par une virgule. Le champs « Files » rend possible l’import direct d’images ou de PDFs.

Liens
- Manuel utilisateur avec Omeka Classic : Lien
- Omeka S, import en lot d’items géolocalisés avec le plugin Mapping, doc en anglais : Lien
Paramétrage d’Omeka Classic en cas de dysfonctionnement de CsvImport
Il est possible que le chargement d’un fichier n’aboutisse pas avec Omeka Classic. Le logiciel indique alors « En attente » ou « Queued » et le script en arrière plan n’est pas déclenché. La modification du fichier « /application/config/config.ini » permet de résoudre la question de deux manières possibles.
1. Réglage de jobs.dispatcher.longRunning
Le réglage longrunning du jobs dispatcher est passé sur « Adapter_synchronous ». Lien
jobs.dispatcher.longRunning = "Omeka_Job_Dispatcher_Adapter_Synchronous"
2. Chemin de PHP-CLI spécifié
Il est à la place possible de spécifier le chemin du PHP-CLI dans « background.php.path ».
background.php.path = "/shared/php/7.0/current/bin/php"
Très bon import de vos fichiers CSV !