benbober commented 5 years ago

Expliciter le comportement de l’extension (contrôles bloquants et non bloquants, différents niveaux de contraintes, d’alertes, de suggestions)
Pointer vers les discussions de la communauté (tickets, discussion sur les listes,…) permettant de connaître les orientations futures

Le ticket est clos quand l’ensemble des points listés est réalisé et qu’il est possible de créer des contraintes sur les propriétés présentes dans la wikibase du POC.

jum-s commented 5 years ago

A noter, les Wikibase Quality extensions n'existe plus, elles ont été récemment fusionnées dans une seule extension : WikibaseQualityConstraints / repo gh

gotnc commented 4 years ago

Comme discuté hier, le ticket sera traité après les autres, ce qui de fait "timeboxera" le temps qui y sera consacré.

maxlath commented 4 years ago

Installation

L'extension WikibaseQualityConstraints a été installée en suivant ces étapes :

rebuild de l'image wikibase après prise en compte de ce commit et redémarrage de wikibase (sans avoir supprimé les volumes, donc on conserve les entités préexistantes)
adaptation de la documentation de l'installation de l'extension à notre cas particulier, avec exécution des commandes suivantes :
```
# Depuis le container wikibase
```

mise à jour des tables mysql

php maintenance/update.php --quick

création des propriétés et éléments nécessaire à la modélisation des contraintes

et écrasement des valeurs déclarées en dur dans

extensions/WikibaseQualityConstraints/extension.json en ajoutant les identifiants fraîchement

générés à LocalSettings.php

php extensions/WikibaseQualityConstraints/maintenance/ImportConstraintEntities.php | tee -a LocalSettings.php

installation de jq si manquant

apt-get install jq

pour pouvoir facilement customisé la valeur du endpoint SPARQL

cat extension.json | jq '.config.WBQualityConstraintsSparqlEndpoint.value = "https://poc-fne-query.abes.fr/proxy/wdqs/bigdata/namespace/wdq/sparql"' > extension.json.updated mv extension.json.updated extension.json


* `docker-compose restart wikibase` pour prendre en compte ces nouvelles valeurs
* [Ajout de 2 contraintes à la propriété ISNI (`P1`)](https://poc-fne.abes.fr/wiki/Property:P1) (en s'inspirant de son [homologue sur Wikidata](https://www.wikidata.org/wiki/Property:P213#P2303))
* Mise à jour de BlazeGraph ([même méthode que précédemment](https://github.com/abes-esr/poc-fne/issues/206#issuecomment-532304836))

## Résultats

### Dans les déclarations
L'ajout de [contraintes sur la propriété ISNI (`P1`)](https://poc-fne.abes.fr/wiki/Property:P1) déclenche l'affichage d'un avertissement depuis les éléments où la contrainte de valeur unique n'est pas respecté. [Exemple sur `Q3407`](https://poc-fne.abes.fr/wiki/Q3407#P1)
![Q3407](https://user-images.githubusercontent.com/1596934/67238019-b30a4f80-f44c-11e9-84b4-b8e872c88d5d.jpg)

### Page `Special:ConstraintReport`
On retrouve ce même avertissement sur la page la page listant les violations de contraintes sur cet élément : https://poc-fne.abes.fr/wiki/Special:ConstraintReport/Q3407

![Q3407_constraints](https://user-images.githubusercontent.com/1596934/67238148-f238a080-f44c-11e9-8995-d67c96c4a41a.jpg)

### Rapport de base de donnée
Sur Wikidata, la page de discussion des propriétés intégre une [section documentation](https://www.wikidata.org/wiki/Property_talk:P213#Documentation) semblant être généré de manière automatique via un template, dans laquelle figure un lien vers la page (`Wikidata:Database_reports/Constraint_violations` pour la propriété en question](https://www.wikidata.org/wiki/Wikidata:Database_reports/Constraint_violations/P213) : ces 2 éléments sont absent de l'installation, je cherche à comprendre ce qu'il faut faire pour que ces pages aussi soient générées

Edit: ces pages sont maintenus par des bots, l'un d'eux étant [DeltaBot](https://github.com/Pascalco/DeltaBot/blob/master/constraints.py)

transition-bibliographique / poc-fne

Installer WikibaseQualityConstraints #208