Exporters

LODEX a plusieurs formats d'export, et on peut choisir de les proposer ou non à l'utilisateur. Pour être affiché, un exporter doit être présent dans le tableau exporters.

Les exporters fournis par LODEX sont les suivants:

  • N-Quads : nquads
  • N-Quads étendus : extendednquads
  • CSV : csv
  • TSV : tsv
  • Turtle : turtle
  • ATOM : atom
  • JSON-LD : jsonld
  • JSONLD (Compact) : jsonldcompacted
  • Sitemap (pour le référencement) : sitemap
  • Widget (I-Frame) : widget

Exporters étendus

Les exporters étendus ne sont utiles quand un champ est de format ISTEX Query.

N-Quads extended

L'exporter «N-Quads étendus» renvoie les résultats de la requête dans l'API ISTEX. Ils sont formatés en N-Quads.

Un graphe nommé, utile lors de l'import dans un triple store, est ajouté aux triplets (TODO: vérifier que c'est encore vrai).

Le graphe nommé est formé à partir de la valeur de la variable d'environnement EZMASTER_PUBLIC_URL.

Remarque : si vous n'utilisez pas ezMaster, définissez la propriété graph dans config.istexquery:

...
"istexQuery" : {
    "graph" : "http://yoururl.com/graph"
...

Dans le fichier de configuration config.json vous pouvez configurer l'export:

...
    "istexQuery" : {
       "labels": "",
       "linked": "language",
       "context": {
          "language": "dcterms:language",
          "doi": "bibo:doi"
       }
    }
}

Labels

Si labels est vide, tous les champs du format Istex Query seront exportés (TODO: à expliciter, ce n'est pas clair). Vous pouvez aussi sélectionner les champs ISTEX de cette manière:

"istexQuery" : {
    "labels": "istex_query1,istex_query3,istex_query5",
    ...

Note: This is lodex's columns labels, not output in the istex API. (TODO: à vérifier)

Context

Dans la propriété context, vous pouvez déclarer les champs de l'API ISTEX que vous voulez exporter, comme doi ou language. Vous pouvez préciser le propriété sémantique à utiliser pour chacun d'eux, en utilisant un préfixe (prefix:property) ou une URI complète.

...
"istexQuery" : {
    "labels": "",
    "context": {
        "language": "dcterms:language",
        "doi": "bibo:doi",
        "rebBibs.host.publicationDate": "http://purl.org/dc/terms/issued"
        }
    }
}

La liste des préfixes utilisables dans LODEX est visible sur Github, mais voilà la liste correspondant aux version 8.17+:

Lier les ressources LODEX et les documents ISTEX

Dans la configuration de l'exporter (nommée istexQuery), il faut ajouter la propriété sémantique liant la ressource LODEX contenant la requête aux documents ISTEX correspondants.

Pour ce faire, on utilise la propriété linked, qui pointe le champ (du context) contenant la propriété à utiliser.

"istexQuery" : {
    "labels": "",
    "linked": "LINK",
    "context": {
        "language": "dcterms:language",
        "doi": "bibo:doi",
        "LINK": "dc:example"
    }
}

Dans cet exemple, la propriété LINK a été déclarée comme étant celle à utiliser pour lier les ressources aux documents.

Script d'export

L'export peut prendre très longtemps, et il est plus aisé d'utiliser un script bash ou powershell plutôt qu'un navigateur web.

Une bonne solution, sous bash ou powershell 3.0, est d'utiliser la commande wget:

wget -O file -c lodex.url/api/export/nquads

‘-c’ ‘--continue’ : option wget pour redémarrer le téléchargement et écraser le fichier existant quand l'export LODEX retourne une erreur.

La liste des exporters est disponible au début de cette section.

results matching ""

    No results matching ""