Documentation

Exporter le catalogue

CSV en douze tables, LIDO 1.1, CIDOC CRM, export complet de la bibliothèque, paquet pour Obscura Vault, et la règle de confidentialité.

La section Exports produit l’export complet de la bibliothèque, le paquet pour Obscura Vault et trois formats :

  • Export complet — toute la bibliothèque et toutes ses données, en formats ouverts, dans un dossier ou une archive ZIP (voir Export complet de la bibliothèque) ;
  • Paquet pour Obscura Vault — une sauvegarde, un export complet sans images et la liste des originaux, à confier à Obscura Vault pour archivage (voir Paquet pour Obscura Vault) ;
  • CSV — pour un tableur, ou pour réimporter dans un autre catalogue ;
  • LIDO 1.1 (XML) — pour un musée ou un portail de collections ;
  • CIDOC CRM (Turtle) — pour une institution qui travaille en données liées.

L’export complet, le paquet pour Vault et l’export CSV sont inclus sans licence : vos données sortent toujours dans un format ouvert. Les exports LIDO et CIDOC CRM demandent une licence Obscura Catalog ; sans elle, Catalog le dit avant même de demander où enregistrer (voir Licence et offre gratuite).

Les cartes de la section sont rangées en deux groupes, sur toute la largeur de la fenêtre : Notices des œuvres (CSV, LIDO, CIDOC, puis, sous Options de ces exports, les cartes Documents joints et Notices LIDO et CIDOC), puis Toute la bibliothèque (l’export complet et le paquet pour Vault). Le nombre de colonnes suit la largeur : deux dans une fenêtre étroite, trois à 1 440 points ; sur un grand écran, les deux groupes se placent côte à côte. Les cartes d’une même rangée ont la même hauteur, leurs boutons alignés en bas.

La section Exports : rappel de confidentialité, carte CSV, cartes LIDO et CIDOC

Chaque export porte sur toutes les œuvres du catalogue, quel que soit leur statut (brouillons compris), moins ce que la règle de confidentialité retient. Pendant un export, une barre de progression s’affiche ; vous pouvez l’arrêter : « Export arrêté. Aucun fichier partiel n’est gardé. » Tout s’écrit d’abord dans un dossier caché, à côté de la destination, et n’apparaît qu’une fois complet : un export arrêté, ou en échec (un disque plein), ne laisse ni table, ni copie de document, ni note de justification, et rien n’est noté au journal des exports confidentiels. À la fin, Afficher dans le Finder ouvre les fichiers écrits.

Export complet de la bibliothèque

Export complet de la bibliothèque, la première carte du groupe Toute la bibliothèque, ou Fichier › Exporter tout…, écrit toute la bibliothèque et toutes ses données en formats ouverts, dans un dossier « Export complet ––», ou une archive ZIP du même nom : de quoi la relire sans Obscura Catalog, la confier à une institution ou la garder en archive. La sauvegarde (Réglages › Sauvegarde) copie la base telle quelle, pour la restaurer ; l’export complet sort les données dans des formats que tout logiciel lit, il ne se restaure pas.

  1. Choisissez le Séparateur des tables et les options (ci-dessous). Fichier › Exporter tout… reprend les options de la carte.
  2. Exporter tout…, choisissez le dossier où l’écrire (Catalog dit le nom qu’il y créera), puis Exporter ici.
Dossier ou fichierContenu
LISEZMOI.txtce que contient l’export, ses conventions, et chaque fichier avec son nombre de lignes et ses colonnes, en français puis en anglais (README.txt, l’anglais d’abord, quand Catalog est en anglais)
manifest.jsonla version de Catalog, la date, les options, le nombre d’enregistrements de chaque sorte, et chaque fichier avec sa taille, son empreinte SHA-256 et, pour une table, son nombre de lignes
catalogue/les douze tables de l’export CSV (voir CSV), plus agents.csv (les agents que citent les enregistrements exportés : identité, dates, rôles et identifiants d’autorité VIAF, ULAN, Wikidata, ISNI, ORCID ; jamais la note interne, ni la mention Personne vivante) et attributions.csv (une ligne par attribution d’une œuvre exportée, acceptée ou écartée, avec sa certitude, son argument et sa source)
bibliotheque/folders.csv (les dossiers importés), files.csv (chemin, taille, SHA-256, dimensions, date de prise de vue, appareil, objectif, GPS, et file_number, le « n° de fichier » qu’un fichier peut porter de son côté, qui n’est pas le n° d’inventaire d’une œuvre), metadata.csv (titre, description, auteur, droits, mots-clés et mots-clés hiérarchiques, note en étoiles, marque, étiquette), indexation.csv (qui, quoi, où, quand, comment, pourquoi), tags.csv, collections.csv (avec les règles des collections intelligentes, en JSON), collection_files.csv, relations.csv (RAW + JPEG, dérivés, doublons…), versions.csv, work_files.csv (les fichiers de chaque œuvre et l’image de référence), documents.csv, analysis.csv (la légende, les objets et le texte lus par l’analyse)
thesaurus/le thésaurus en SKOS (thesaurus.rdf) et en CSV (thesaurus.csv, réimportable par la section Thésaurus)
documents/les fichiers des documents joints : documents/<identifiant du document>/<nom du fichier>
images/sur option, les images
lido/lido.xml, cidoc/cidoc.ttlsur option, les notices LIDO et le CIDOC CRM

Les tables sont en UTF-8 avec BOM ; elles se relient par leurs identifiants (asset_id, work_id, document_id) et par le numéro de catalogue ; leurs chemins sont relatifs à la racine de l’export. Les valeurs des listes y sont écrites par leur code, le même quelle que soit la langue de l’interface : celles de la bibliothèque (marque pick ou reject, étiquette red, yellow…, type de relation) comme celles du catalogue (voir Les codes des valeurs). Les colonnes de chaque table suivent les mêmes engagements que l’export CSV (voir Ce qui ne changera pas).

Options

  • Copier les images : chaque fichier de la bibliothèque est copié dans images/<dossier>/<chemin dans le dossier>, son arborescence gardée. Son empreinte SHA-256, calculée pendant la copie, est comparée à celle que la bibliothèque a notée à l’import. Un original illisible (disque débranché, fichier déplacé) n’est pas copié ; un original modifié depuis l’import est copié tel qu’il est. La colonne image_status de files.csv (copied, differs, missing) et manifest.json les nomment, et Catalog le dit à la fin. Avant de commencer, Catalog vérifie que le disque a la place nécessaire.
  • Ajouter les notices LIDO 1.1 et Ajouter le CIDOC CRM : les fichiers des exports LIDO et CIDOC (voir plus bas), qui demandent la même licence ; leurs documents renvoient à documents/.
  • Ajouter les noms donnés aux visages : bibliotheque/faces.csv, les noms des personnes de la section Visages et les fichiers où elles figurent. Les empreintes des visages, qui sont des données biométriques, ne sont jamais exportées, ni la position d’un visage dans l’image, avec ou sans cette option ; les empreintes des photos similaires non plus.
  • Archive ZIP plutôt qu’un dossier : un seul fichier .zip, écrit une fois le dossier vérifié.
  • Inclure les enregistrements confidentiels : comme pour le CSV (voir Inclure les enregistrements confidentiels), avec une justification, consignée dans EXPORT-CONFIDENTIEL.txt à la racine de l’export et dans le Journal des exports confidentiels (format « Export complet »), pour cet export seul.

Ce qui reste confidentiel

La règle de confidentialité s’applique à tout l’export. Par défaut, en sont exclus les œuvres confidentielles, les événements de provenance confidentiels (et leurs ventes aux enchères), les interventions de conservation confidentielles, le coût de toutes les interventions, les documents confidentiels et les relations avec une œuvre confidentielle ; avec une œuvre confidentielle, les fichiers qui ne sont liés qu’à elle, ou qu’à d’autres œuvres exclues, restent aussi : leurs lignes, métadonnées, indexation, tags, documents et images. Une photo qui est une vue d’exposition montrant une œuvre confidentielle est traitée comme les fichiers de cette œuvre : retenue avec eux. Une vue qui montre une œuvre à la reproduction exclue garde sa ligne, jamais son image, même avec le confidentiel. Un fichier lié à une œuvre exportée sort avec elle ; un fichier lié à aucune œuvre sort. Une étiquette, un nom de visage ou une collection qui ne tient qu’à des fichiers retenus reste avec eux : tags.csv, faces.csv et collections.csv ne le nomment pas (une collection intelligente dont la règle porte sur une telle étiquette non plus, ni un groupe de collections qui ne contient qu’elles) ; une étiquette ou une collection qui ne tient à aucun fichier sort. Les agents de agents.csv sont ceux que citent les enregistrements exportés (auteurs et énonciateurs des attributions, tireurs des tirages, lieux et commissaires des expositions, éditeurs des publications, parties des événements de provenance publiables et maisons de leurs ventes, intervenants des interventions de conservation exportées, ayants droit) : tout agent nommé par une table de catalogue/ y a sa ligne. Une partie qui n’apparaît que dans un événement confidentiel n’y figure pas, ni le détenteur d’un tirage, ni un agent marqué Confidentiel (aucune table ne le nomme alors). Avec Inclure les enregistrements confidentiels, tout le répertoire des agents y figure. LIDO et CIDOC n’ont jamais le confidentiel, même quand l’export l’inclut. Les notes internes ne sortent jamais.

Progression, arrêt, vérification

Une barre dit l’étape (lecture de la bibliothèque, copie des documents, copie des images, écriture des tables, vérification, compression) et son avancement ; Arrêter abandonne l’export sans rien laisser. Catalog lit toute la bibliothèque en une seule lecture cohérente : ce que vous modifiez pendant l’export n’y entre pas à moitié, et vous pouvez continuer à travailler. Il écrit dans un dossier caché à côté de la destination, relit chaque fichier contre le manifeste (taille et empreinte, aucun fichier en trop ni en moins), puis lui donne son nom : un export à moitié écrit n’apparaît jamais. Un second export du même jour prend le nom suivant (« … (2) »). À la fin, Afficher dans le Finder montre le dossier ou l’archive.

Pour vérifier une copie reçue, shasum -a 256 <fichier> (dans le Terminal) donne l’empreinte à comparer à celle de manifest.json.

Paquet pour Obscura Vault

Paquet pour Obscura Vault, la carte à côté de l’export complet, ou Fichier › Préparer un paquet pour Vault…, prépare de quoi confier la bibliothèque à Obscura Vault, qui l’archive, en contrôle la fixité et en garde une copie hors site. Catalog et Vault ne partagent ni base ni réglages : le paquet est le seul échange entre les deux. Préparer un paquet est inclus sans licence, comme l’export complet.

La carte Paquet pour Obscura Vault : rappel de sensibilité, options de l’export, copie des originaux, confidentiel justifié

  1. Choisissez le Séparateur et les options (ci-dessous). Fichier › Préparer un paquet pour Vault… reprend les options de la carte.
  2. Préparer un paquet…, choisissez le dossier où l’écrire (Catalog dit le nom qu’il y créera), puis Enregistrer ici.
  3. Dans Obscura Vault, importez ce dossier, ou l’archive ZIP.

Ce que contient un paquet

Un dossier « Paquet Catalog ––», ou une archive ZIP du même nom :

Dossier ou fichierContenu
package.jsonle manifeste du paquet : son identifiant, celui de la bibliothèque, la date, la version de Catalog, si l’export inclut le confidentiel, les totaux des originaux, et chaque fichier du paquet avec sa taille et son empreinte SHA-256 ; Vault vérifie tout le paquet avec cette seule liste
backup/une sauvegarde de la bibliothèque, comme celles de Réglages › Sauvegarde (voir Sauvegarder et restaurer la bibliothèque) : la base, les documents joints, les PDF des certificats émis, les réglages et backup.json ; de quoi restaurer la bibliothèque
export/un export complet sans les images (voir Export complet de la bibliothèque), avec son manifest.json et son LISEZMOI.txt ; de quoi relire le catalogue sans Obscura Catalog. Les vues de l’exposition n’y sont pas encore : ni exhibition_views.csv, ni vue en LIDO ou en CIDOC (elles ne font pas encore partie du contrat avec Vault ; la sauvegarde les contient)
originals.csvles originaux que décrit l’export, un par empreinte SHA-256 : taille, nom du fichier, où la bibliothèque les trouve sur ce Mac (chemin et identifiant du disque) et, s’il a été intégré, le chemin de sa copie dans originals/
originals/seulement si vous cochez Copier les originaux dans le paquet : une copie de chaque original, nommée par son empreinte (voir Copier les originaux dans le paquet)

Par défaut, les originaux eux-mêmes ne sont pas copiés dans le paquet : ils y sont désignés par leur empreinte, celle calculée à l’import, jamais par leur chemin. Vault rapproche chaque empreinte de ses archives ; ceux qu’il n’a pas encore, il les lit là où la bibliothèque les trouve, et ne les archive que si l’empreinte lue est la bonne. Un original déplacé, modifié depuis l’import ou sur un disque débranché est dit « absent » par Vault, sans erreur. Les fichiers retenus par l’export et leurs versions y figurent ; les documents joints non : ils sont déjà dans backup/ et export/.

Catalog écrit d’abord la sauvegarde, puis lit l’export sur cette sauvegarde : les trois parties décrivent le même état de la bibliothèque, et vous pouvez continuer à travailler pendant ce temps.

Options

  • Séparateur, Ajouter les notices LIDO 1.1 et Ajouter le CIDOC CRM (licence, demandée au moment de préparer le paquet), Ajouter les noms donnés aux visages : les options de l’export complet, pour l’export du paquet. Celui-ci n’a jamais les images.
  • Archive ZIP plutôt qu’un dossier : un seul fichier .zip, dont la racine est le dossier du paquet, écrit une fois le paquet vérifié.
  • Copier les originaux dans le paquet (décochée par défaut) : voir ci-dessous.
  • Inclure les enregistrements confidentiels dans l’export : comme pour l’export complet, avec une justification, consignée dans export/EXPORT-CONFIDENTIEL.txt et dans le Journal des exports confidentiels (format « Paquet pour Vault »), pour ce paquet seul.

Copier les originaux dans le paquet

Cochez Copier les originaux dans le paquet quand le Vault qui recevra le paquet n’a pas accès aux disques des originaux : un autre Mac, ou un paquet transporté sur un disque. Catalog copie alors tous les originaux que liste originals.csv dans le dossier originals/ du paquet, chacun une seule fois même s’il figure plusieurs fois dans la bibliothèque, sous son empreinte (originals/<deux premiers caractères>/<empreinte>, sans extension ; son nom reste dans originals.csv).

  • Taille. Le paquet prend alors la taille des originaux, en plus du reste : plusieurs centaines de gigaoctets pour un fonds photographique. Avant de commencer, Catalog vérifie que le disque de destination a cette place, et refuse sinon sans rien écrire ; il la revérifie juste avant la copie.
  • Vérification. Chaque original est relu et son empreinte calculée pendant la copie. Une copie n’est intégrée que si son empreinte est exactement celle notée à l’import ; la colonne embedded_path d’originals.csv n’est renseignée que pour elle, et Vault la vérifie à son tour.
  • Non intégré. Un original modifié depuis l’import (retouché, réenregistré) n’a plus les octets que la bibliothèque cite : sa copie est supprimée. Un original introuvable (disque débranché, fichier déplacé) n’est pas copié. Une version antérieure d’un fichier n’a pas de copie à intégrer : Catalog n’en garde pas les octets. Ces originaux restent dans originals.csv, avec leur indice de source : Vault pourra encore les lire là où ils sont, s’il y a accès.
  • Fin. Catalog dit combien d’originaux sont intégrés et, s’il y en a, combien ne le sont pas et pourquoi : « 120 originaux intégrés au paquet ; 3 non intégrés : modifiés depuis l’import (2), introuvable (1). »

La copie est une étape de la progression (« Copie des originaux… », en octets) ; Arrêter l’abandonne sans rien laisser.

Ce qu’un paquet ne contient jamais

  • la clé de signature des certificats, ni sa sauvegarde chiffrée : elle reste dans le trousseau du Mac, et sa sauvegarde sous votre garde ;
  • la session du compte et la licence ;
  • les vignettes et les aperçus, que Catalog recalcule ;
  • les copies des originaux, sauf si vous cochez Copier les originaux dans le paquet ;
  • les empreintes des visages et des photos similaires, en dehors de la base elle-même, dans backup/.

Un paquet est sensible

La sauvegarde (backup/) est la base entière : elle contient toujours les enregistrements confidentiels, les montants de la provenance et les notes internes, quelles que soient les options. La case Inclure les enregistrements confidentiels dans l’export ne décide que de l’export.

originals.csv dit aussi comment vos dossiers sont organisés. Ne confiez un paquet qu’à Obscura Vault ou à un disque que vous contrôlez ; Vault le traite comme une donnée sensible (chiffré au repos et hors site, rien de son contenu dans ses journaux). La carte le rappelle avant toute option.

Progression, arrêt, fin

Une barre dit l’étape (sauvegarde de la bibliothèque, lecture de la sauvegarde, écriture de l’export, copie des originaux si vous l’avez demandée, liste des originaux, vérification du paquet, compression de l’archive) et son avancement ; Arrêter abandonne le paquet sans rien laisser. Catalog écrit dans un dossier caché à côté de la destination, relit tout le paquet comme Vault le relira (chaque fichier contre package.json : taille et empreinte, aucun fichier en trop ni en moins), puis lui donne son nom : un paquet à moitié écrit n’apparaît jamais. Avant de commencer, il vérifie que le disque a la place nécessaire, originaux à copier compris. Un second paquet du même jour prend le nom suivant (« … (2) ») ; chaque paquet est complet, avec son propre identifiant.

À la fin, Catalog dit le nombre d’originaux désignés et leur volume sur leurs disques, la taille du paquet, combien d’originaux sont intégrés si vous l’avez demandé (et pourquoi les autres ne le sont pas) et, s’il y en a, les originaux écartés d’originals.csv parce que l’empreinte ou la taille que la bibliothèque a enregistrée pour eux est endommagée : Vault refuserait tout le paquet pour une seule de ces lignes. Afficher dans le Finder montre le dossier ou l’archive.

Restaurer depuis Vault

Vault rend le dossier du paquet tel quel. Pour retrouver la bibliothèque :

  1. Copiez le dossier backup/ du paquet là où vous voulez la bibliothèque, et donnez-lui un nom (« Bibliothèque restaurée », par exemple) : Catalog écrit dans la bibliothèque qu’il ouvre, et le paquet rendu doit rester intact.
  2. Fichier › Ouvrir une bibliothèque…, puis choisissez ce dossier (voir Déplacer la bibliothèque, tenir plusieurs bibliothèques) : Catalog redémarre sur elle, avec ses œuvres, ses agents, sa provenance, ses documents joints, ses certificats émis et ses réglages.
  3. Les originaux absents du Mac se restaurent depuis Vault, par leur empreinte. Remis à leur emplacement d’origine (colonne source_path d’originals.csv), ils sont retrouvés par la bibliothèque, et la marque Manquant disparaît.

L’export (export/) ne se restaure pas : il sert à relire le catalogue sans Catalog.

La règle de confidentialité

Les œuvres et événements confidentiels sont exclus de tout export ; seuls le CSV, l’export complet et le paquet pour Vault permettent de les inclure, sur justification, pour un seul export. Les notes internes ne sortent jamais.

L’export du tableau des œuvres (Exporter ce tableau…, voir Le tableau des œuvres) suit la même règle et offre la même option, justifiée et notée au journal (format « CSV »).

Sont confidentiels :

  • une œuvre marquée Enregistrement confidentiel (voir Identification) ;
  • un événement de provenance confidentiel : c’est le cas par défaut, et toujours tant qu’une partie est une personne vivante ; son montant est gardé, et n’entre que dans provenance.csv d’un export qui inclut le confidentiel (voir Provenance) ; sa vente aux enchères le suit ;
  • les montants d’une vente aux enchères marquée Montants confidentiels, même quand son événement est publiable : la vente sort, sans ses estimations, son adjudication, sa devise ni le montant de son événement ;
  • une intervention de conservation marquée Confidentielle (voir Conservation) ;
  • un document marqué Confidentiel, ou qui prouve un événement confidentiel, ou qui documente une intervention confidentielle (voir Documents joints) ;
  • un agent marqué Confidentiel (voir Agents confidentiels) : à quelque rôle qu’il soit cité, il est absent de LIDO, de CIDOC, des rapports et des certificats (ni nom, ni identifiant, ni rôle), l’enregistrement qui le cite sortant comme si aucun agent n’était renseigné, sans que le lieu saisi en texte libre (d’une exposition, d’un événement) prenne sa place ; le CSV et Exporter ce tableau… ne le nomment qu’avec le confidentiel.

Les notes internes ne figurent dans aucun export, quelles que soient les options : celles des œuvres, des tirages, des agents, des interventions de conservation, des lignes de droits et des documents de l’œuvre, ainsi que la note d’une relation entre œuvres. La localisation et le prix d’un tirage non plus ; son détenteur actuel ne sort que dans la colonne current_holder de prints.csv, avec le confidentiel, et le prêteur d’un objet exposé que dans la colonne lender de exhibitions.csv, avec le confidentiel. Le récolement ne sort dans aucun export. L’historique des modifications d’une notice non plus : il ne sort que dans la sauvegarde de la bibliothèque (celle d’un paquet pour Vault comprise), sans valeur confidentielle.

CSV

Exporter le catalogue en CSV : une ligne par œuvre, plus des fichiers joints, reliés par le numéro de catalogue.

  1. Choisissez le Séparateur : Virgule (RFC 4180) ou Point-virgule (Excel, locale française). L’écran part du séparateur de Réglages › Exports (Séparateur par défaut… y mène).
  2. Au besoin, cochez Inclure les enregistrements confidentiels (ci-dessous).
  3. Exporter…, choisissez un dossier, puis Exporter ici. Catalog y crée un nouveau dossier « Export CSV ––» (« … (2) » s’il existe déjà) et y écrit l’export : il ne touche jamais aux fichiers déjà présents, ni à ceux d’un export précédent, et le compte rendu donne le nom du dossier.

Catalog écrit douze fichiers, en UTF-8 avec BOM (Excel les ouvre directement). Les valeurs des listes (statut, existence, précision d’une date, type d’édition, statut d’un tirage, types de document, de relation, de transaction, licences…) y sont écrites par leur code (extant, draft, limited…), jamais par leur libellé : un même fonds exporté avec Catalog en français ou en anglais donne des fichiers identiques. La table Les codes des valeurs donne le libellé de chaque code en français et en anglais.

FichierUne ligne par…Colonnes
works.csvœuvrecatalogue_number, variant, inventory_number, title, alternate_titles, subtitle, work_type, technique, support, series, genre, date_text, date_start, date_end, date_precision, place, summary, statement, existence, status, attribution, rights_statement, completeness, published_at, former_numbers, original_titles, translated_titles, former_titles, creation_circumstances, artistic_project, capture_medium, capture_format, history, analysis, condition, condition_description, storage_locations, state_rank, reproduction_exclusion, date_argument
prints.csvtiragecatalogue_number, print_number, inventory_number, edition_kind, edition_size, copy_number, process, paper, toning, image_mm, sheet_mm, mount_mm, mounting_material, framed, frame_description, printed_year, print_period, printer, signature, signature_location, signed_at, signed_place, inscriptions, condition, status, signature_text, current_holder, frame_mm
exhibitions.csvœuvre exposéecatalogue_number, exhibition_title, venue, city, start_date, end_date, item_number, print_number, organizer, lender
publications.csvcitationcatalogue_number, short_reference, full_reference, pages, figure, plate, citation_kind, isbn, doi, print_number, publication_kind, poster, web
provenance.csvévénement de provenancecatalogue_number, date, date_precision, event, transaction, from, to, location, amount, currency, confidential, print_number
documents.csvdocument d’une œuvre, d’un de ses tirages ou d’un de ses fichierscatalogue_number, work_id, asset_id, file, document_id, kind, title, original_name, sha256, file_size, confidential, export_path, print_number, date, reference
relations.csvrelation entre deux œuvrescatalogue_number, relation, related_catalogue_number, related_title
sales.csvvente aux enchères d’un événement de provenancecatalogue_number, print_number, auction_house, sale_title, sale_date, lot_number, outcome, estimate_low, estimate_high, hammer_price, premium_included, currency, confidential, amounts_confidential
conservation.csvintervention de conservationcatalogue_number, print_number, kind, date, date_precision, conservator, description, condition, document_id, reference, cost, currency, confidential
rights.csvdroit d’une œuvrecatalogue_number, line, holder, licence, licence_terms, restrictions, expires_on, expiry_precision
valuations.csvvaleur d’un tirage ou palier de prix d’une édition, seulement avec le confidentiel justifiécatalogue_number, print_number, edition, first_copy, last_copy, kind, amount, currency, date, date_precision, source, detail, appraiser, document_id
exhibition_views.csvœuvre visible sur une vue d’une exposition où elle est accrochéecatalogue_number, exhibition_title, start_date, end_date, position, asset_id, file, sha256, print_number

catalogue_number est le n° de catalogue de l’œuvre, inventory_number le n° d’inventaire de l’œuvre (dans works.csv) ou du tirage (dans prints.csv), vide quand il n’y en a pas (voir N° de catalogue et n° d’inventaire).

Dans prints.csv, framed vaut 1 pour un tirage encadré et frame_description donne alors sa note d’encadrement ; signature_location, signed_at et signed_place disent où, quand et en quel lieu il est signé. Dans exhibitions.csv, publications.csv et provenance.csv, print_number est le numéro du tirage exposé, cité ou concerné, vide quand c’est l’œuvre sans préciser le tirage. current_holder nomme le détenteur actuel du tirage, un agent de agents.csv, seulement quand l’export inclut les enregistrements confidentiels, vide sinon. frame_mm donne les dimensions encadrées (420 × 520, 420 × 520 × 30 avec la profondeur). La localisation, le prix et la note interne d’un tirage ne figurent dans aucune colonne. Dans exhibitions.csv, organizer nomme l’organisateur de l’exposition ; lender, le prêteur de l’objet exposé, seulement quand l’export inclut les enregistrements confidentiels, vide sinon. L’import des expositions ignore ces deux colonnes pour l’instant.

valuations.csv n’a de lignes que dans un export qui inclut le confidentiel, sur justification : les valeurs d’un tirage sont toujours confidentielles. Une ligne par valeur, historique compris, avec le print_number du tirage ; une ligne par palier de prix d’une édition, print_number vide, l’édition (edition, sa séquence) et ses exemplaires (first_copy, last_copy). kind vaut production, public_price, insurance ou estimate (valeur estimée) ; source est le canal d’un prix public (gallery, studio, fair, other), la source d’une valeur d’assurance (artist, gallery, expert, insurer, other) ou d’une valeur estimée (artist, gallery, expert, other) ; detail ce que couvre une valeur de production ; appraiser l’évaluateur d’une valeur d’assurance ou estimée, un agent de agents.csv ; document_id son justificatif, une ligne de documents.csv. Jamais la note interne.

Les autres titres ont une colonne par type : alternate_titles (sans type), original_titles, translated_titles, former_titles, plusieurs titres séparés par |, la langue après un @ final (Night piece@en). former_numbers donne les anciens numéros, la source entre parenthèses (42 (Catalogue 1985) | N-7). storage_locations donne les emplacements de l’œuvre, le type entre parenthèses, par son code (Boîte 12 (box) | LaCie (hardDrive)) : une information interne, écrite seulement quand l’export inclut les enregistrements confidentiels, vide sinon ; LIDO et CIDOC ne la portent jamais. signature_text est le texte de la signature d’un tirage, distinct des inscriptions ; poster et web valent 1 quand l’œuvre est reproduite sur une affiche ou en ligne.

Dans relations.csv, chaque relation entre deux œuvres (voir Relations) figure une seule fois. relation vaut related (œuvre liée), variant (variante), commonNegative (même négatif), sameSession (même séance), state (autre état de la même image) ou preparatory : l’œuvre de catalogue_number est alors l’œuvre préparatoire de celle de related_catalogue_number ; les autres relations se lisent dans les deux sens. La note d’une relation n’y figure jamais, ni une relation avec une œuvre confidentielle, sauf dans un export qui inclut le confidentiel.

Dans sales.csv, chaque vente aux enchères (voir Ajouter ou modifier un événement) d’un événement de provenance.csv, et d’aucun autre : la vente d’un événement confidentiel n’y est qu’avec le confidentiel, confidential valant alors 1. outcome vaut sold (adjugé), unsold (invendu) ou withdrawn (retiré) ; les estimations et l’adjudication sont dans la devise de la vente (currency), le point pour décimale ; premium_included vaut 1 quand l’adjudication comprend les frais acheteur, et reste vide sans adjudication. sale_date est vide quand la vente a la date de son événement. amounts_confidential (la dernière colonne) vaut 1 pour une vente marquée Montants confidentiels, 0 sinon : sans le confidentiel, ses estimations, son adjudication, premium_included et currency sont alors vides, comme amount et currency de son événement dans provenance.csv.

Dans conservation.csv, chaque intervention de conservation (voir Conservation) de l’œuvre ou d’un tirage (print_number) : kind vaut restoration, incident ou conditionReport, condition (l’état constaté) excellent, good, fair, poor ou unknown ; document_id est un document de documents.csv. Une intervention confidentielle n’y est qu’avec le confidentiel ; le coût (cost, currency) n’est écrit que dans un export qui inclut le confidentiel, même pour une intervention publique ; la note interne jamais. Dans works.csv, condition et condition_description donnent l’état d’une œuvre sans tirage (vides sans état enregistré) ; celui d’un tirage est dans prints.csv.

Dans rights.csv, chaque ligne des droits d’une œuvre exportée (voir Droits), dans leur ordre (line : 1, 2…) : holder est l’ayant droit (un agent), licence vaut allRightsReserved, ccBy, ccBySa, ccByNd, ccByNc, ccByNcSa, ccByNcNd, cc0, publicDomain, other ou unknown, licence_terms donne ses conditions, restrictions les restrictions de reproduction, expires_on l’échéance et expiry_precision sa précision. Les droits sortent avec leur œuvre (ceux d’une œuvre confidentielle seulement avec le confidentiel), jamais leur note interne. La mention de droits libre reste la colonne rights_statement de works.csv.

Dans exhibition_views.csv, une ligne par œuvre visible sur une vue de l’exposition (voir Les vues de l’exposition), seulement pour une exposition où l’œuvre, ou l’un de ses tirages, est accrochée, comme exhibitions.csv la liste : l’exposition par son titre et ses dates ; position, la place de la vue dans la bande de l’exposition, à partir de 1 (une vue retirée peut laisser un écart) ; la photo par asset_id, file (son chemin, tel qu’importé) et sha256, comme bibliotheque/files.csv ; print_number, le tirage visible, vide quand c’est l’œuvre sans préciser le tirage. Une vue qui montre une œuvre confidentielle (la photo la montre), ou dont la photo n’est liée qu’à des œuvres confidentielles, n’y figure qu’avec le confidentiel justifié, et chacune est comptée au journal des exports confidentiels ; une vue qui montre une œuvre à la reproduction exclue n’y figure jamais (la photo la reproduit).

Dans works.csv, state_rank est le rang de l’état de l’œuvre (2 pour « État II », vide sans rang), reproduction_exclusion le code du motif d’une reproduction exclue (vide quand elle ne l’est pas) et date_argument la justification de la datation (voir Notice scientifique) ; l’import CSV des œuvres les ignore pour l’instant.

works.csv se réimporte tel quel par l’import CSV (voir Importer un inventaire CSV), n° d’inventaire compris ; exhibitions.csv et publications.csv aussi, avec leurs rattachements et leurs citations. L’import lit les codes, et aussi les libellés en français et en anglais qu’écrivaient les versions antérieures à 0.19 : un fichier déjà exporté se réimporte.

Les formules neutralisées

Un tableur exécute une cellule qui commence par = comme une formule : un titre reçu d’un laboratoire ou d’un catalogue Lightroom qui contiendrait =HYPERLINK(…) s’ouvrirait comme un lien, ou pire. Dans tous les CSV qu’écrit Catalog (l’export CSV, les tables de l’export complet et du paquet pour Vault, « Exporter ce tableau… », le thésaurus en CSV), une cellule de texte qui commence par =, +, @, une tabulation ou un retour à la ligne reçoit donc une apostrophe devant ('=HYPERLINK(…)) ; de même une cellule qui commence par - sans être un nombre (-12 et -3.5 restent tels quels). Le tableur affiche alors le texte tel qu’il a été saisi. Les colonnes de montants, de dimensions et de codes ne sont jamais touchées.

L’import CSV retire cette apostrophe, dans ces seuls cas : un fichier exporté puis réimporté rend exactement les textes d’origine (voir Importer un inventaire CSV).

Ce qui ne changera pas

Ces fichiers sont un format durable : un tableur, un script ou un autre logiciel qui les lit continuera de les lire avec les versions suivantes d’Obscura Catalog. À partir de la 1.0 :

  • l’ordre des colonnes de chaque fichier est figé, tel que les tableaux ci-dessus le donnent, ainsi que leurs noms. Une nouvelle colonne ne s’ajoute qu’en fin de ligne ; aucune colonne n’est renommée, déplacée ni retirée. (En 0.16, inventory_number avait été insérée en troisième position de works.csv et prints.csv : cela ne se reproduira pas.) Un programme qui lit les colonnes par leur nom ne voit aucune différence ; un programme qui les lit par leur position doit seulement ignorer les colonnes en trop au bout de la ligne ;
  • les codes des valeurs ne changent pas : un code ne prend jamais un autre sens et n’est jamais renommé ; une valeur nouvelle, si une liste en reçoit une, arrive avec un code nouveau ;
  • une cellule de texte qui ressemble à une formule commence par une apostrophe (voir Les formules neutralisées), que l’import retire : un ajout de la 0.19.1, qui ne change ni l’ordre, ni les noms, ni les codes des colonnes ;
  • les tables sans import sont en « export seul » : prints.csv, provenance.csv, relations.csv, sales.csv, conservation.csv, rights.csv, documents.csv et exhibition_views.csv, comme agents.csv et attributions.csv de l’export complet, ne se réimportent pas en 1.0 ; ces données se saisissent dans la notice. Un import viendra plus tard, comme un ajout, sans changer leurs colonnes.

Inclure les enregistrements confidentiels

Pour un export destiné à un usage précis (un assureur, un ayant droit), cochez Inclure les enregistrements confidentiels. Catalog prévient : « Les fichiers contiendront des enregistrements confidentiels : parties, transactions, prix. Quiconque reçoit les fichiers peut les lire. »

Une justification est alors obligatoire. Catalog écrit, à côté des douze fichiers, EXPORT-CONFIDENTIEL.txt, qui consigne la date, le nombre d’œuvres exportées et la justification. Les tables, les copies des documents et cette note apparaissent ensemble, une fois l’export complet ; l’entrée du journal est écrite à ce moment-là, jamais pour un export arrêté ou en échec.

L’option ne vaut que pour un seul export : elle est décochée, et la justification effacée, dès l’export terminé.

Le champ s’intitule « Justification (consignée dans le journal d’audit) » : la justification est écrite dans EXPORT-CONFIDENTIEL.txt, qui accompagne les fichiers, et dans le Journal des exports confidentiels de la bibliothèque, dans Réglages › Confidentialité. Chaque export qui a inclus les enregistrements confidentiels y figure, du plus récent au plus ancien : sa date, son format, sa justification, le dossier où il a été écrit, le nombre d’œuvres exportées et ce qu’il a laissé sortir de confidentiel, chaque catégorie pour ce qu’elle est : œuvres, événements de provenance, documents, valeurs, détenteurs, prêteurs, emplacements, interventions de conservation (confidentielles, ou avec leur coût) et agents confidentiels (chacun une fois). Les entrées écrites par une version antérieure ne comptent pas les emplacements, les interventions ni les agents (« Exporter ce tableau… » comptait alors un détenteur comme un événement de provenance). Le journal suit la bibliothèque dans ses sauvegardes et ne se modifie pas. Si Catalog ne peut pas l’écrire, l’export reste écrit, avec sa note, et Catalog le dit.

Source, URI et langue des notices LIDO et CIDOC

La carte Notices LIDO et CIDOC dit, avant tout export, avec quoi les deux formats seront écrits ; ils se modifient dans Obscura Catalog › Réglages… › Exports, où mène Réglages des notices… (Enregistrer les applique, Rétablir les abandonne). Ces réglages appartiennent à la bibliothèque : ils sont enregistrés à côté de sa base (export-settings.json), et la suivent dans ses sauvegardes et ses déplacements.

  • Source des notices (nom du fonds) : l’institution ou le fonds qui publie les notices, écrit dans chaque notice LIDO (recordSource) et en tête du fichier CIDOC. Vide, c’est le nom de l’espace de travail. Une ligne, 200 caractères au plus.
  • URI de base : l’adresse sous laquelle Catalog forme les URI des œuvres (<base>work/<numéro de catalogue>), des tirages (<base>print/<numéro du tirage>), des acteurs et des lieux. Renseignez le domaine du fonds, en https:// (par exemple https://data.mon-fonds.org/catalogue/) : sans lui, les URI sont provisoires (https://catalogue.obscura.local/) et ne désignent rien hors de ce Mac. Une fois l’adresse renseignée, chaque notice LIDO d’œuvre et de tirage porte aussi l’URI de l’objet (objectPublishedID de type URI), la même que dans le CIDOC : les deux exports désignent le même objet de la même façon. Catalog refuse une adresse qui n’est pas en http:// ou https://, ou qui contient une espace, ?, #, un identifiant (@) ou un domaine accentué ; le / final est ajouté. Ne changez plus l’adresse une fois les données publiées : une URI changée désigne une autre ressource.
  • Langue des notices : la langue déclarée des notices (xml:lang en LIDO, étiquettes de langue en CIDOC) et des libellés que Catalog écrit lui-même (l’édition d’un tirage, en français ou en anglais). Par défaut, la langue de l’interface. Une œuvre dont la langue du titre est renseignée garde cette langue pour sa notice.

LIDO 1.1

Exporter en LIDO 1.1 (XML)… propose d’enregistrer <nom du catalogue>-lido.xml.

LIDO est le format d’échange des musées et des portails de collections. Catalog écrit une notice par œuvre et par tirage : identification, création avec l’auteur de l’attribution acceptée et ses identifiants d’autorité, expositions, acquisitions de la provenance, fichiers liés. Le document suit le schéma officiel LIDO 1.1. Chaque notice est sourcée par le nom du fonds (voir plus haut) et déclare son profil (voir Versions des profils). Les attributions acceptées des autres rôles (tireur, collaborateur, assistant, retoucheur, imprimeur, éditeur) sont des acteurs de l’événement de création, après l’auteur : un eventActor chacun, son rôle en roleActor (printer, collaborator, assistant, retoucher, press printer, publisher) et, sauf certitude, son qualificatif (attributed to…). Une attribution anonyme ou non acceptée n’y figure pas, ni son argument. Le tireur d’un tirage, renseigné dans le tirage, figure dans la production de sa notice.

La notice d’une œuvre porte aussi sa bibliographie (une relatedWorkSet de relation documented in par citation : la ligne bibliographique, la référence complète, le tirage cité et le passage cité, avec l’ISBN, l’ISSN ou le DOI de la publication) et, pour une œuvre qui n’est pas existante, son état (perdue, détruite… : objectDescriptionSet de type existence). La notice d’un tirage porte sa signature (une inscriptions de type signature : signé ou tamponné, emplacement, date et lieu), son état (objectDescriptionSet de type condition, avec la note d’état), et les expositions et acquisitions qui ne concernent que lui ; celles de l’œuvre restent dans la notice de l’œuvre.

Les ventes aux enchères des événements publiables sont des événements de type Provenance, de méthode auction : le nom de la vente (eventName), la maison de vente (eventActor, rôle auction house), la date (celle de l’événement quand la vente n’en a pas), le lot et l’issue (eventDescriptionSet de types lot et outcome), dans la notice de l’œuvre ou du tirage concerné. Jamais une estimation ni une adjudication.

Les interventions de conservation publiques sont des événements de type Restoration (une restauration) ou Event (non-specified) (un incident, un constat d’état), nommés d’après leur type (eventName) : l’intervenant (eventActor, rôle conservator), la date, la description et l’état constaté (eventDescriptionSet, le second de type condition), dans la notice de l’œuvre ou du tirage concerné. L’état d’une œuvre sans tirage est, comme celui d’un tirage, un objectDescriptionSet de type condition. Jamais le coût, la note ni le document d’une intervention.

Les droits sont dans rightsWorkWrap, dans la notice de l’œuvre et dans celle de chacun de ses tirages (un tirage reproduit l’œuvre aux mêmes conditions) : la mention de droits libre en premier (creditLine), puis un rightsWorkSet par ligne de droits : la licence (rightsType, son URI Creative Commons ou RightsStatements.org en conceptID et son nom, « CC BY-NC 4.0 », « In Copyright » ; ses conditions en second terme, ou seules pour une autre licence), l’échéance (rightsDate, latestDate), l’ayant droit (rightsHolder, son nom et ses identifiants VIAF, ULAN, Wikidata), les restrictions de reproduction (creditLine). Jamais la note interne.

Le n° de catalogue est l’identifiant de la notice de l’œuvre (lidoRecID, et objectPublishedID une fois l’œuvre publiée), le numéro du tirage celui de la notice du tirage. Le n° d’inventaire d’une œuvre ou d’un tirage, quand il y en a un, sort en repositoryWrap/repositorySet/workID de type inventory number : le numéro seul, jamais le nom ni l’adresse du détenteur. Les anciens numéros sortent dans un repositorySet de type former, un workID de type former number chacun, la source en lido:label. Les autres titres sont des titleSet alternate, typés original title, translated title ou former title, leur langue en xml:lang ; l’historique et l’analyse, des objectDescriptionSet de type history et analysis ; les circonstances et le projet, des eventDescriptionSet de la création ; le film ou capteur et le format, des termMaterialsTech typés ; le texte de la signature d’un tirage, une inscriptionTranscription de son inscriptions de type signature, avant la description. Les relations avec d’autres œuvres sont des relatedWorkSet, avant la bibliographie : l’autre œuvre par son n° de catalogue (objectID de type local, l’identifiant de sa propre notice) et son titre, la relation en relatedWorkRelType (related to, variant of, same negative as, same sitting as, other state of, preparatory for, prepared by), jamais la note de la relation ni une œuvre confidentielle.

Les états d’une image (voir Relations) : chacune des deux œuvres nomme l’autre par une relation other state of, et le rang d’une œuvre, quand il est saisi, est son displayState (« État II », dans la langue des notices), dans displayStateEditionWrap. Le rang de l’autre état est dans la notice de celle-ci. L’organisateur d’une exposition est un acteur de l’événement d’exposition, après le lieu : un eventActor de rôle organizer, avec ses identifiants d’autorité. Le prêteur d’un objet exposé n’y figure jamais (il est confidentiel), ni les dimensions encadrées, ni la justification de la datation, ni le motif d’une reproduction exclue ; une œuvre à la reproduction exclue n’a pas de ressource image dans sa notice.

Les vues de l’exposition où l’œuvre est visible (voir Les vues de l’exposition) sont des ressources de la notice de l’œuvre, après ses images : un resourceSet par vue, la photo par son identifiant (resourceID de type local) et son empreinte (resourceID de type SHA-256), son chemin (linkResource), resourceRelType installation view, et une resourceDescription de type exhibition qui nomme l’exposition par le titre de son événement dans la notice. Seulement les vues d’une exposition où l’œuvre, ou l’un de ses tirages, est accrochée ; aucune qui montre une œuvre confidentielle ou une œuvre à la reproduction exclue, aucune dont la photo n’est liée qu’à des œuvres confidentielles.

Les enregistrements confidentiels en sont toujours exclus.

CIDOC CRM

Exporter en CIDOC CRM… propose d’enregistrer <nom du catalogue>-cidoc.ttl.

CIDOC CRM est l’ontologie de référence du patrimoine culturel. Catalog en exporte un profil volontairement restreint à douze classes, correctement rempli plutôt qu’approximatif, ses URI formées sous l’URI de base du fonds. Le fichier déclare son profil en tête (<> owl:versionInfo "obscura-catalog/cidoc-crm/2.1", voir Versions des profils) :

ClassePour
E22 Human-Made Objectl’œuvre et chaque tirage
E65 Creationla création de l’œuvre (la prise de vue)
E12 Productionla fabrication de chaque tirage
E8 Acquisitionchaque transfert de propriété communicable de la provenance
E39 Actorphotographes, tireurs, parties de la provenance, organisateurs d’expositions… : un par fiche de l’annuaire
E52 Time-Spanquand les événements ont eu lieu
E53 Placeoù ils ont eu lieu
E31 Documentun document de l’œuvre, d’un de ses tirages ou d’un de ses fichiers (voir Documents joints), une publication et chacune de ses citations
E7 Activityune exposition où l’œuvre, ou l’un de ses tirages, a été montrée ; une vente aux enchères ; une intervention de conservation
E30 Rightla mention de droits de l’œuvre
E55 Typele rôle d’une attribution ou de l’organisateur d’une exposition, la sorte de similitude entre deux œuvres
E36 Visual Iteml’image d’une vue de l’exposition (photo d’accrochage)

La création est P14 carried out by l’auteur accepté et les attributions acceptées des autres rôles (tireur, collaborateur, assistant, retoucheur, imprimeur, éditeur). Le rôle de chacun passe par un nœud PC14 carried out by (P01i is domain of), qui nomme l’acteur (P02 has range) et son rôle (P14.1 in the role of), un E55 Type décrit une fois : <base>type/role/photographer, …/printer, …/collaborator, …/assistant, …/retoucher, …/press-printer, …/publisher. Une attribution anonyme, non acceptée ou d’un agent confidentiel n’y figure pas.

Chaque acteur a pour URI l’identifiant de sa fiche dans l’annuaire, <base>actor/<identifiant>, et son nom pour étiquette (rdfs:label) : deux homonymes restent deux acteurs, et renommer un agent ne change pas son URI. Les lieux gardent une URI formée sur leur nom (<base>place/paris).

Une exposition (<base>exhibition/<identifiant>) est décrite une fois, avec son titre, ses dates et son lieu, et P16 used specific object nomme chaque œuvre, ou le tirage exposé, qu’elle a montrés. Son organisateur la réalise (P14 carried out by), son rôle donné par un nœud PC14 carried out by (P14.1 in the role of <base>type/role/organizer) ; jamais le prêteur. La bibliographie : chaque citation est un E31 Document (<base>citation/<identifiant>) qui porte la ligne bibliographique, le passage cité (P3 has note), P70 documents vers l’œuvre ou le tirage cité et P106i forms part of vers la publication (<base>publication/<identifiant>, sa référence complète et ses identifiants). Une acquisition qui ne concerne qu’un tirage transfère le titre de ce tirage (P24). Les relations avec d’autres œuvres : une variante et une œuvre du même négatif P130 shows features of l’autre œuvre, et un nœud PC130 shows features of dit laquelle des deux par P130.1 kind of similarity (<base>type/similarity/variant ou <base>type/similarity/same-negative) ; deux états de la même image de même, avec <base>type/similarity/state, et le rang d’une œuvre parmi les états est une note de l’œuvre (P3 has note « state: 2 ») ; une œuvre liée ou de la même séance rdfs:seeAlso ; une œuvre préparatoire P15i influenced la création de l’œuvre qu’elle a préparée, qui porte P15 was influenced by. Ni la note d’une relation, ni une œuvre confidentielle.

Une vue de l’exposition (<base>view/<identifiant>) est un E36 Visual Item, décrit une fois, après les expositions : il P138 represents l’exposition (son E7 Activity) et chaque objet visible sur la vue, l’œuvre ou le tirage visible ; une note installation view (P3 has note) dit ce qu’il est, l’empreinte de la photo est sa skos:notation. P138 represents plutôt que P62 depicts : P62 part d’un objet physique (E24), et la vue est une image, pas un tirage d’elle. Aucun chemin : CIDOC ne porte pas d’image. Seulement les vues d’une exposition où l’œuvre est accrochée ; jamais une vue qui montre une œuvre confidentielle ou une œuvre à la reproduction exclue, ni une photo liée seulement à des œuvres confidentielles.

Une vente aux enchères d’un événement publiable, sans classe de plus : un E7 Activity (<base>work/<n° de catalogue>/sale/<n>, une note auction) qui P16 used specific object l’œuvre ou le tirage proposé, P14 carried out by la maison de vente, avec le nom de la vente, le lot (« lot 42 ») et l’issue (sold, unsold, withdrawn) en P3 has note, et sa période. Jamais une estimation ni une adjudication.

Une intervention de conservation publique, sans classe de plus : un E7 Activity (<base>work/<n° de catalogue>/conservation/<n>, son type en rdfs:label : restoration, incident, condition report) qui P12 occurred in the presence of l’œuvre ou le tirage concerné, P14 carried out by l’intervenant, avec la description et l’état constaté (condition: good) en P3 has note, et sa période. Jamais le coût, la note ni le document. L’état courant d’une œuvre ou d’un tirage n’a pas de classe dans le profil : il est dans LIDO et le CSV.

Les droits d’une œuvre : chaque ayant droit une fois, P105 right held by sur l’œuvre (le raccourci que le CRM donne pour un droit détenu), et chaque ligne en P3 has note (« rights: CC BY-NC 4.0; holder: …; restrictions: …; expires: 2071 »). La mention de droits libre est un E30 Right (<base>work/<n° de catalogue>/rights, la mention en rdfs:label) auquel l’œuvre est soumise (P104 is subject to). Jamais la note interne.

Versions des profils LIDO et CIDOC

Ce que Catalog écrit en LIDO et en CIDOC suit un profil versionné, que chaque fichier déclare : lido:applicationProfile (obscura-catalog/lido/1.2) dans chaque notice LIDO, owl:versionInfo (obscura-catalog/cidoc-crm/2.1) en tête du Turtle. Chaque format a sa version. Un ajout (un élément, une propriété, un rôle, un type) donne une version mineure : un outil qui lit la précédente lit toujours ce qu’il connaît. Un changement qui se lirait autrement (un élément déplacé, renommé ou retiré, une URI formée autrement, un sens changé) donne une version majeure, annoncée dans les notes de version.

  • LIDO 1.0 → 1.1 (0.20.0) : un ajout. Les états d’une image (other state of, displayState) et l’organisateur d’une exposition (organizer).
  • CIDOC 1.0 → 2.0 (0.20.0) : un changement de lecture. L’URI d’un acteur vient de l’identifiant de sa fiche, plus de son nom (<base>actor/henri-x devient <base>actor/<identifiant>) : en 1.0, deux homonymes ne faisaient qu’un acteur, et renommer un agent changeait son URI. S’y ajoutent les états (<base>type/similarity/state, la note « state: 2 ») et l’organisateur d’une exposition. Un outil qui a gardé les URI de la 1.0 rapproche les acteurs par leur nom et leurs identifiants d’autorité.
  • LIDO 1.1 → 1.2 : un ajout. Les vues de l’exposition, ressources installation view de la notice de l’œuvre.
  • CIDOC 2.0 → 2.1 : un ajout. Les vues de l’exposition, une classe de plus (E36 Visual Item) et une propriété (P138 represents).

Le n° de catalogue d’une œuvre et le numéro d’un tirage sont des skos:notation sans type ; un n° d’inventaire est une skos:notation typée <base>notation/inventory-number, pour ne jamais le confondre avec eux, un ancien numéro une skos:notation typée <base>notation/former-number. Les autres titres sont des skos:altLabel dans leur langue ; l’historique et l’analyse, des crm:P3_has_note de l’œuvre ; les circonstances, le projet, le film ou capteur et le format, des crm:P3_has_note de la création.

Les enregistrements confidentiels et les notes internes en sont toujours exclus.

Documents joints

Les documents de l’œuvre et de ses tirages (onglet Documents de la notice, voir Documents), puis ceux des fichiers liés à l’œuvre (voir Documents joints) entrent dans les trois exports avec l’œuvre : un document joint à un fichier lié à deux œuvres figure sous chacune.

FormatCe qui est exporté
CSVdocuments.csv : une ligne par document (voir le tableau ci-dessus) ; pour un document de l’œuvre, asset_id et file sont vides, print_number nomme le tirage, date et reference sont les siennes
LIDOune ressource de la notice de l’œuvre (resourceSet), ou de celle du tirage pour un document de tirage : identifiant, empreinte SHA-256, référence (resourceID de type reference), type (correspondence, invoice, exhibition sheet, archival document, certificate of authenticity, condition report, document), relation documentation, titre, date (resourceDateTaken)
CIDOC CRMun E31 Document relié à l’œuvre, ou au tirage, par P70 documents : titre, type, date et référence (P3 has note), empreinte SHA-256

La note interne d’un document de l’œuvre ne sort jamais.

Confidentialité. Un document est confidentiel :

  • quand sa case Confidentiel est cochée (dans l’onglet Documents de la notice, ou dans Modifier… du fichier, voir Documents joints) ; elle l’est d’office pour une nouvelle facture, qui porte des prix et des parties ;
  • quand il sert de preuve à un événement de provenance confidentiel, quelle que soit sa case, tant que l’événement l’est : publier la preuve publierait l’événement ;
  • quand il sert de preuve à un événement dont la vente porte Montants confidentiels, quels que soient son type et sa case, tant que la case de la vente est cochée : un bordereau d’adjudication porte les montants qu’elle retient ;
  • quand il est le document d’une intervention de conservation confidentielle, quelle que soit sa case, tant que l’intervention l’est ;
  • quand il est le justificatif d’une valeur d’un tirage (une expertise, un bordereau d’assurance), quelle que soit sa case, tant qu’il la justifie : une valeur est toujours confidentielle ;
  • les documents d’une œuvre confidentielle ne sortent pas plus qu’elle.

Les autres documents sortent avec leur œuvre, une facture décochée comprise. Les documents confidentiels n’entrent que dans le CSV (et les tables de l’export complet ou d’un paquet), avec Inclure les enregistrements confidentiels (colonne confidential à 1) ; jamais dans LIDO ni CIDOC.

Les fichiers eux-mêmes. Par défaut, un export décrit les documents (titre, type, taille, empreinte SHA-256) sans copier leurs fichiers : l’empreinte permet au destinataire de vérifier le fichier que vous lui transmettez à part. Cochez Copier les fichiers des documents à côté de l’export (carte Documents joints) pour les joindre :

  • CSV : dans le dossier documents/<identifiant du document>/<nom du fichier> à côté des tables ; la colonne export_path de documents.csv donne ce chemin ;
  • LIDO et CIDOC : dans un dossier <nom du fichier>-documents/ à côté du fichier enregistré (<nom du fichier>-documents (2)/ quand ce dossier existe déjà : un export ne mêle jamais ses copies à celles d’un autre) ; la notice LIDO le désigne (linkResource), le CIDOC aussi (rdfs:seeAlso, URI relative au fichier Turtle).

Ce sont les copies gardées par la bibliothèque (dossier Documents/) qui sont copiées, celles des documents de l’œuvre comme celles des fichiers ; l’export complet les copie toujours dans documents/. Un document dont la copie manque est décrit sans fichier, et le compte rendu de l’export le dit.

Les codes des valeurs

La valeur de chaque liste, telle que les fichiers CSV l’écrivent (le code), et son libellé dans les écrans. L’import CSV lit le code comme les libellés, en français et en anglais, majuscules et accents ignorés.

Précision d’une date — works.date_precision, provenance.date_precision, conservation.date_precision, rights.expiry_precision

CodeFrançaisEnglish
dayJourDay
monthMoisMonth
yearAnnéeYear
decadeDécennieDecade
circaVersCirca
rangeIntervalleRange
unknownInconnueUnknown

Existence de l’œuvre — works.existence

CodeFrançaisEnglish
extantExistanteExtant
lostPerdueLost
destroyedDétruiteDestroyed
unknownLocationLocalisation inconnueLocation unknown
notTracedNon retrouvéeNot traced

Statut de la notice — works.status

CodeFrançaisEnglish
draftBrouillonDraft
inReviewEn relectureIn review
validatedValidéeValidated
publishedPubliéePublished
withdrawnRetiréeWithdrawn

Certitude d’une attribution — works.attribution (l’attribution acceptée), attributions.certainty

CodeFrançaisEnglish
certainCertaineCertain
attributedAttribuéeAttributed
studioAtelier deStudio of
disputedContestéeDisputed
rejectedRejetéeRejected
unknownInconnueUnknown

Rôle d’une attribution — attributions.role

CodeFrançaisEnglish
photographerPhotographePhotographer
printerTireurPrinter
collaboratorCollaborateurCollaborator
assistantAssistantAssistant
retoucherRetoucheurRetoucher
pressPrinterImprimeurPress printer
publisherÉditeurPublisher

État de conservation — works.condition, prints.condition, conservation.condition

CodeFrançaisEnglish
excellentExcellentExcellent
goodBonGood
fairMoyenFair
poorMauvaisPoor
unknownNon évaluéNot assessed

Motif d’une reproduction exclue — works.reproduction_exclusion (vide : la reproduction n’est pas exclue)

CodeFrançaisEnglish
rightsDroits non obtenusRights not obtained
artistChoiceChoix de l’auteur ou des ayants droitArtist’s or estate’s choice
holderRequestDemande du détenteurHolder’s request
otherAutre motifOther reason

Type d’emplacement — works.storage_locations (entre parenthèses : Boîte 12 (box))

CodeFrançaisEnglish
hardDriveDisque durHard drive
binderClasseurBinder
boxBoîteBox
drawerTiroirDrawer
shelfÉtagèreShelf
otherAutreOther

Type d’édition — prints.edition_kind

CodeFrançaisEnglish
uniqueŒuvre uniqueUnique work
limitedÉdition limitéeLimited edition
openÉdition ouverteOpen edition
artistProofÉpreuve d’artisteArtist proof
printersProofÉpreuve de tireurPrinter’s proof
exhibitionCopyExemplaire d’expositionExhibition copy
horsCommerceHors commerce (HC)Hors commerce (HC)

Période du tirage — prints.print_period

CodeFrançaisEnglish
vintageTirage d’époqueVintage print
laterTirage postérieurLater print
modernTirage moderneModern print
posthumousTirage posthumePosthumous print
unknownPériode inconnueUnknown period

Signature — prints.signature

CodeFrançaisEnglish
signedSignéSigned
stampedTamponnéStamped
estateStampTimbre de la successionEstate stamp
unsignedNon signéUnsigned
unknownNon renseignéeNot recorded

Statut du tirage — prints.status

CodeFrançaisEnglish
inStockEn stockIn stock
soldVenduSold
consignedEn dépôtConsigned
loanedEn prêtOn loan
giftedDonnéGifted
lostPerduLost
destroyedDétruitDestroyed

Type de citation — publications.citation_kind

CodeFrançaisEnglish
mentionMentionMention
reproductionReproductionReproduction
discussionDiscussionDiscussion
catalogueEntryNotice de catalogueCatalogue entry

Type de publication — publications.publication_kind

CodeFrançaisEnglish
monographMonographieMonograph
catalogueCatalogue d’expositionExhibition catalogue
groupCatalogueCatalogue collectifGroup catalogue
periodicalPériodiquePeriodical
newspaperJournalNewspaper
essayEssaiEssay
thesisThèseThesis
webWebWeb
otherAutreOther
scientificArticleArticle scientifiqueScholarly article
posterAffichePoster

Événement de provenance — provenance.event

CodeFrançaisEnglish
createdCréée / entrée à l’atelierCreated / entered studio
movedDéplacementMoved
storedMise en réserveStored
exhibitedExpositionExhibited
loanedPrêtLoaned
returnedRetourReturned
soldVente / acquisitionSold / acquired
restoredRestaurationRestored
acquiredAcquisitionAcquired
giftedDonationGifted
bequeathedLegsBequeathed
depositedMise en dépôtDeposited
otherAutreOther

Type de transaction — provenance.transaction

CodeFrançaisEnglish
purchaseachatpurchase
giftdonationgift
bequestlegsbequest
exchangeéchangeexchange
loanprêtloan
depositdépôtdeposit
unknowninconnuunknown

Type de document — documents.kind (et bibliotheque/documents.csv)

CodeFrançaisEnglish
correspondenceCorrespondanceCorrespondence
invoiceFactureInvoice
exhibition_sheetFiche d’expositionExhibition sheet
archiveArchivesArchives
external_certificateCertificat externeExternal certificate
condition_reportConstat d’étatCondition report
otherAutreOther

Type de relation — relations.relation

CodeFrançaisEnglish
relatedŒuvre liéeRelated work
variantVarianteVariant
commonNegativeNégatif communCommon negative
sameSessionMême séanceSame sitting
preparatoryŒuvre préparatoirePreparatory work
stateÉtatState

Issue d’une vente — sales.outcome

CodeFrançaisEnglish
soldAdjugéSold
unsoldInvenduUnsold
withdrawnRetiréWithdrawn

Type d’intervention — conservation.kind

CodeFrançaisEnglish
restorationRestaurationRestoration
incidentIncidentIncident
conditionReportConstat d’étatCondition report

Licence — rights.licence

CodeFrançaisEnglish
unknownLicence non préciséeLicence not stated
allRightsReservedTous droits réservésAll rights reserved
ccByCC BY 4.0 (attribution)CC BY 4.0 (attribution)
ccBySaCC BY-SA 4.0 (partage dans les mêmes conditions)CC BY-SA 4.0 (share alike)
ccByNdCC BY-ND 4.0 (pas de modification)CC BY-ND 4.0 (no derivatives)
ccByNcCC BY-NC 4.0 (pas d’utilisation commerciale)CC BY-NC 4.0 (non-commercial)
ccByNcSaCC BY-NC-SA 4.0 (pas d’utilisation commerciale, partage dans les mêmes conditions)CC BY-NC-SA 4.0 (non-commercial, share alike)
ccByNcNdCC BY-NC-ND 4.0 (pas d’utilisation commerciale, pas de modification)CC BY-NC-ND 4.0 (non-commercial, no derivatives)
cc0CC0 (aucun droit réservé)CC0 (no rights reserved)
publicDomainDomaine publicPublic domain
otherAutre licence ou contratOther licence or contract

Type de valeur — valuations.kind

CodeFrançaisEnglish
productionValeur de productionProduction value
public_pricePrix publicPublic price
insuranceValeur d’assuranceInsured value
estimateValeur estiméeEstimated value

Source ou canal d’une valeur — valuations.source

CodeFrançaisEnglish
galleryGalerieGallery
studioAtelierStudio
fairFoireFair
artistArtisteArtist
expertExpertExpert
insurerAssureurInsurer
otherAutreOther

Type d’agent — agents.kind

CodeFrançaisEnglish
personPersonnePerson
organisationOrganisationOrganisation

Rôle d’un agent — agents.roles (plusieurs, séparés par |)

CodeFrançaisEnglish
artistArtisteArtist
printerTireurPrinter
galleryGalerieGallery
museumMuséeMuseum
collectorCollectionneurCollector
curatorCommissaireCurator
labLaboratoireLaboratory
publisherÉditeurPublisher
auctionHouseMaison de ventesAuction house
foundationFondationFoundation
expertExpertExpert
otherAutreOther

En résumé : ce qui sort, et ce qui reste

ExportSortSort seulement avec « Inclure les enregistrements confidentiels » et une justificationNe sort jamais
CSV (douze tables)les œuvres non confidentielles, quel que soit leur statut ; leurs tirages, expositions, vues d’exposition, citations, relations, droits ; les événements de provenance publiables, montant compris, et leurs ventes aux enchères, estimations et adjudication comprises, sauf celles marquées Montants confidentiels ; les interventions de conservation publiques, sans leur coût ; les documents non confidentielsles œuvres confidentielles et tout ce qui les concerne ; les événements de provenance confidentiels (montant compris) et leurs ventes ; les montants d’une vente marquée Montants confidentiels ; le détenteur actuel d’un tirage ; les interventions confidentielles ; le coût de toutes les interventions ; les documents confidentiels ; les relations avec une œuvre confidentielleles notes internes ; la note d’une relation ; la localisation d’un tirage ; l’historique des modifications
LIDO 1.1, CIDOC CRMles œuvres et tirages non confidentiels, avec leurs expositions, leur bibliographie, leurs relations, leurs droits, les acquisitions et les ventes aux enchères des événements publiables, les interventions publiques et les documents non confidentiels, sans aucun montant (ni prix, ni estimation, ni adjudication, ni coût)rien : ces formats n’ont pas l’optiontout le confidentiel, les agents confidentiels, les montants, les notes internes, le détenteur actuel, le prêteur d’un objet exposé, l’historique des modifications
Export completles tables du CSV, plus agents.csv et attributions.csv, les tables de la bibliothèque, le thésaurus, les fichiers des documents ; sur option, les images, LIDO, CIDOC et les noms donnés aux visagesce que le CSV sort avec l’option, plus les fichiers liés seulement à des œuvres confidentielles (lignes, métadonnées, documents, images) et tout le répertoire des agentsles notes internes ; les empreintes des visages et des photos similaires, la position des visages ; la mention Personne vivante ; l’historique des modifications ; le confidentiel dans LIDO et CIDOC
Paquet pour Vaultune sauvegarde (backup/) qui contient tout, confidentiel, montants, notes internes et historique compris ; un export complet sans images ; la liste des originaux ; sur option, les copies des originauxdans l’export du paquet (export/), comme pour l’export completla clé de signature des certificats, la session du compte et la licence, les vignettes et les aperçus
Exporter ce tableau (Œuvres)les colonnes affichées des œuvres non confidentielles ; le dernier détenteur et le nombre d’événements calculés sur les événements publiablesles œuvres confidentielles, le dernier détenteur tiré d’un événement confidentiel, et l’auteur ou le dernier détenteur qui est un agent confidentiella vignette et les notes internes

Les rapports et les certificats suivent la même règle sans option : rien de confidentiel ne s’y imprime, ni un agent confidentiel, ni aucun montant (voir Rapports et Ce que contient le certificat).

Bon à savoir

  • L’export complet reprend les douze tables de l’export CSV à l’identique : un script écrit pour l’un lit l’autre. L’export d’un paquet pour Vault en a onze : les vues d’exposition n’y sont pas encore.
  • Chaque export CSV a son propre dossier daté : deux exports dans le même dossier ne se mélangent pas, et un export public n’hérite jamais des documents ni de la note d’un export confidentiel précédent.
  • La langue de l’interface ne change rien aux fichiers de l’export CSV et de l’export complet : les valeurs y sont des codes (voir Les codes des valeurs).
  • Les exports LIDO et CIDOC sont rédigés dans la langue réglée dans Réglages › Exports, la langue de l’interface par défaut (voir Source, URI et langue).
  • Les documents confidentiels (une facture, par défaut) ne sortent qu’avec le confidentiel, dans le CSV, l’export complet ou l’export d’un paquet (voir Documents joints).
  • Les identifiants d’autorité des agents (VIAF, ULAN, Wikidata, ISNI, ORCID) rendent les exports LIDO et CIDOC bien plus utiles à une institution : renseignez-les (voir Les agents).
  • Un événement de provenance est confidentiel tant que vous ne décochez pas « Confidentiel » dans son éditeur : il ne figure alors ni dans LIDO ni dans CIDOC, et n’apparaît dans provenance.csv que si vous incluez le confidentiel. Publiable, il y entre ; son montant ne figure que dans provenance.csv (voir Provenance).