Documentation Import It

Import It est un module pour Omeka S. Il permet aux administrateurs d’importer de manière répétée dans Omeka S depuis des sources externes.

L’idée est de définir une source une fois dans Omeka S, puis d’importer depuis cette source régulièrement, ce qui peut être fait manuellement ou automatiquement (en utilisant des tâches planifiées par exemple).

C’est utile pour les sources qui sont mises à jour régulièrement.

Pré-requis

  • Omeka S >= 4.1.0

  • PHP >= 8.0

Selon les sources utilisées, il peut y avoir d’autres pré-requis

Sources supportées

Import It prend en charge pour l’instant un seul type de source (d’autres seront ajoutés plus tard).

D’autres modules peuvent ajouter la prise en charge d’autres types de sources.

Journaux

Import It n’utilise pas le mécanisme par défaut de journalisation, car les imports produisent souvent beaucoup de messages et cela peut ralentir les imports. Cela peut aussi faire grossir la table job rapidement.

À la place, chaque import a son propre fichier de journalisation. De cette manière, ils peuvent être gérés par les outils habituels de rotation de logs (ex: logrotate).

Ils peuvent néanmoins être visualisés (ou téléchargés) depuis l’interface d’administration (jusqu’à leur rotation).

Par défaut, les fichiers de journaux sont stockés dans OMEKA_PATH/logs/importit. Cela peut être modifié en ajoutant le code suivant dans config/local.config.php:

'importit_logger' => [
    'dir' => '/var/log/importit', // Make sure that Omeka have write permissions on this directory
],

Démarrer l’import depuis la ligne de commande

Pour démarrer un import depuis la ligne de commande (utile pour lancer des imports périodiquement), exécuter la commande suivante:

$OMEKA_PATH/modules/ImportIt/script/import.php --user-id <user-id> --source-id <source-id>

<user-id> est l’ID de l’utilisateur Omeka S. L’import sera exécuté en tant que cet utilisateur.

<source-id> est l’ID de la source Import It.

Table des matières