transition-bibliographique / poc-fne

Preuve de concept basée sur Wikibase pour le "Fichier National d'Entités" (Abes/BNF). Projet réalisé en 2019.
http://www.abes.fr/Autorites-et-referentiels/Projet-FNE-Fichier-National-d-Entites
4 stars 1 forks source link
fne

PoC FNE basé sur Wikibase

Ce dépôt n'est plus maintenu depuis fin 2019 : il a permis de réaliser une preuve de concept basé sur le logiciel wikibase dans le but de construire l'application national FNE dans laquelle la BnF et l'Abes co-produiront leurs entités

Preuve de concept de modélisation de données d’autorité pour un outil de production mutualisée "Fichier National d'Entités" (ABES-BNF) basé sur Wikibase (réalisé en 2019).

Proof of concept of an authority control data model (Fichier national d’entités) for a mutual data production tool (ABES-BNF) based on Wikibase (done in 2019).

Installation

Pré-requis

NodeJS version 8 ou supérieure installée sur le serveur. Peut être installé via une image Docker

Veiller également à ce que le serveur Wikibase soit actif via la commande docker ps ou bien le lancer via la commande docker-compose up à exécuter à la racine du dossier wikibase.

Copier le répertoire

git clone https://github.com/abes-esr/poc-fne/

Installer les dépendences

cd poc-fne
npm install

Utilisation

Lancer des scripts

Les scripts sont référencés dans le fichier package.json et executables via la commande npm run [nom du script] [arguments]

exemple:

npm run extract ./echantillons/BNF_echantillon_donnes_ALL.xml

Détails des scripts

Extrait, tranforme et charge une ou plusieurs notices dans Wikibase.

exemple:

# Extrait, tranforme et charge les données BNF, en gardant les logs de chargement dans etl-bnf.log
# et les logs d'erreurs dans etl-bnf.err
npm run etl-notices ./echantillons/BNF_echantillon_donnes_ALL.xml > etl-bnf.log 2> etl-bnf.err
# idem pour l'ABES
npm run etl-notices ./echantillons/ABES_echantillon_donnees_ALL.xml  > etl-abes.log 2> etl-abes.err

Extrait une notice (fichier .xml) dans un fichier NDJSON dans le même dossier que la notice .xml. Utile principalement pour des besoins de développement.

exemple:

npm run extract echantillons/PaulVidal_BnF_13949089.txt
# > /path/to/poc-fne/echantillons/PaulVidal_BnF_13949089.json was created.

Lance les tests unitaire et d'intégration via MochaJS, en passant par la commande NodeJS npm test (et non npm run test)

exemple:

npm test