# 3. Outils d'indexation # Préambule des outils d'indexation Les outils d’indexation d’Archimage regroupent un ensemble de scripts permettant de synchroniser, mettre à jour et enrichir certaines données utilisées dans la plateforme. Ces outils ont pour objectif de faire le lien entre Archimage et d’autres plateformes ou référentiels utilisés par l’École française d’Athènes. Ils permettent notamment d’importer ou de mettre à jour des entités externes, puis de les associer aux fiches documentaires d’Archimage. Ils participent ainsi à l’interopérabilité de la plateforme et à la cohérence des données diffusées. [![image.png](https://doc-archimage.efa.gr/uploads/images/gallery/2026-07/scaled-1680-/image.png)](https://doc-archimage.efa.gr/uploads/images/gallery/2026-07/image.png)
---
## 1. Rôle des outils d’indexation Les outils d’indexation ne servent pas uniquement à ajouter des mots-clés ou des valeurs dans des listes. Ils permettent de maintenir des liens entre Archimage et plusieurs sources de données externes ou complémentaires : - les missions ; - les publications ; - les mots-clés ; - les auteurs ; - les DOI. Ces entités peuvent ensuite être utilisées dans les fiches documentaires, dans les formulaires de recherche, dans les exports de métadonnées ou dans les liens vers d’autres plateformes. Archimage n’est donc pas seulement une base de notices isolées. La plateforme s’appuie sur des données structurées et interconnectées afin de faciliter la recherche, la diffusion et la réutilisation scientifique des informations.
---
## 2. Principe général Le fonctionnement général des outils d’indexation repose sur trois étapes. ### 2.1 Récupération des données Les scripts récupèrent des données depuis une source interne ou externe. Selon le cas, cette source peut être : - une autre plateforme de l’EFA ; - une API ; - un export JSON ; - un export ONIX ; - un référentiel d’autorités ; - une table ou un fichier de travail. L’objectif est de disposer dans Archimage d’une copie exploitable des entités nécessaires à l’indexation.
---
### 2.2 Mise à jour des entités Les scripts mettent ensuite à jour les données déjà présentes dans Archimage. Cette mise à jour peut consister à : - créer de nouvelles entités ; - compléter des entités existantes ; - corriger des informations ; - mettre à jour des identifiants externes ; - conserver un lien avec la source d’origine ; - éviter les doublons lorsque cela est possible. L’objectif n’est pas de remplacer le travail documentaire, mais de fournir aux gestionnaires d’Archimage des données fiables, homogènes et réutilisables.
---
### 2.3 Liaison avec les fiches Archimage Une fois les entités disponibles dans Archimage, elles peuvent être associées aux fiches documentaires. Ces liens permettent par exemple : - d’associer une fiche à une mission ; - de rattacher un document à une publication ; - d’indexer une notice avec des mots-clés ; - de lier une notice à un auteur ; - de générer ou mettre à jour un DOI ; - d’améliorer les exports de métadonnées ; - de faciliter la recherche publique ou interne. Ces liens rendent les fiches plus riches et plus interopérables. # Missions L’outil d’indexation des missions permet d’importer et de mettre à jour dans Archimage les informations relatives aux missions scientifiques en renseignant le fichier config.php sur une URL de l’API JSON utilisée pour les missions. ``` ParamManager::getInstance()->add("MISSIONS_API",""); ``` Ces missions proviennent d’une source externe ou d’une autre plateforme de l’établissement. Elles sont ensuite stockées dans Archimage afin de pouvoir être associées aux fiches documentaires. Exemple de JSON : ```json [ { "id": "7", "identifiant": "2013_A_00001", "code": "A10", "code_year": "A10_2014", "intitule": "SIG d'Amathonte", "site": "Amathonte - Agios Tychonas", "section": "ANTIQUITÉ", "date": 2014, "chercheur_id": "159", "chercheur_label": "Cannavo, Anna", "rapport_url": "" } ] ``` L’objectif est de relier les documents conservés dans Archimage aux missions dans le cadre desquelles ils ont été produits, utilisés ou documentés. La table Missions peut être également complétée via l'outil de gestion des bases de données, si une source externe n'est pas possible. --- ## 1. Rôle de l’indexation des missions L’indexation des missions permet de créer un lien entre une fiche Archimage et une mission scientifique. Ce lien peut ensuite être utilisé pour : - contextualiser un document ; - retrouver tous les documents liés à une mission ; - faciliter la recherche par mission ; - enrichir les exports de métadonnées ; - créer des liens entre Archimage et d’autres plateformes de l’EFA. Une mission n’est donc pas seulement une valeur textuelle ajoutée dans une fiche. Elle constitue une entité structurée, avec ses propres informations : code, année, intitulé, site, section, responsable et éventuellement un lien vers un rapport. --- ## 2. Structure des données d’une mission Chaque mission importée dans Archimage est composée de plusieurs champs. Exemple de données : ```text id | identifiant | code | code_year | intitule | site | section | date | chercheur_id | chercheur_label | rapport_url 1 | 2013_A_00001 | A10 | A10_2014 | SIG d'Amathonte | Amathonte - Agios Tychonas | ANTIQUITÉ | 2014 | 159 | Cannavo, Anna | 2 | 2013_A_00002 | C32 | C32_2014 | Salle hypostyle | Délos | ANTIQUITÉ | 2014 | 162 | Moretti, Jean-Charles | ``` --- ## 3. Description des champs
ChampDescription
`id`Identifiant interne de la mission dans Archimage.
`identifiant`Identifiant unique de la mission provenant de la source externe.
`code`Code court de la mission.
`code_year`Code de la mission complété par l’année, utilisé pour identifier plus précisément la mission.
`intitule`Intitulé ou titre de la mission.
`site`Site ou lieu principal concerné par la mission.
`section`Section scientifique ou administrative associée à la mission.
`date`Année de la mission.
`chercheur_id`Identifiant du chercheur ou responsable associé à la mission.
`chercheur_label`Nom affiché du chercheur ou responsable de la mission.
`rapport_url`URL éventuelle du rapport de mission ou d’une ressource liée.
--- ## 4. Identifiant de mission Le champ `identifiant` permet de conserver le lien avec la source d’origine. Exemple : ```text 2013_A_00001 ``` Cet identifiant est important car il permet de reconnaître une même mission lors des mises à jour successives. Lorsqu’un script d’indexation est relancé, Archimage peut s’appuyer sur cet identifiant pour savoir si la mission existe déjà ou si elle doit être créée. --- ## 5. Code et code annuel Le champ `code` correspond au code court de la mission. Exemple : ```text A10 ``` Le champ `code_year` ajoute l’année au code de la mission. Exemple : ```text A10_2014 ``` Ce champ est utile lorsque le même code peut être réutilisé ou suivi sur plusieurs années. Il permet de distinguer plus clairement une mission dans une année donnée. --- ## 6. Intitulé de la mission Le champ `intitule` contient le titre de la mission. Exemple : ```text SIG d'Amathonte ``` Il s’agit de la forme lisible par l’utilisateur. Ce champ est généralement utilisé dans les interfaces d’administration, les listes de choix et les affichages publics lorsqu’une fiche est reliée à une mission. --- ## 7. Site associé Le champ `site` indique le lieu principal concerné par la mission. Exemple : ```text Amathonte - Agios Tychonas Délos ``` Ce champ permet de relier la mission à un contexte géographique ou archéologique. Il peut être utilisé pour faciliter la recherche et pour rapprocher les missions des sites déjà présents dans Archimage. --- ## 8. Section Le champ `section` indique la section associée à la mission. Exemple : ```text ANTIQUITÉ ``` Cette information permet de classer les missions selon leur domaine scientifique ou administratif. Elle peut être utilisée dans les filtres, les exports ou les traitements internes. --- ## 9. Date de la mission Le champ `date` correspond à l’année de la mission. Exemple : ```text 2014 ``` Cette valeur permet de situer la mission dans le temps et de produire des regroupements chronologiques. --- ## 10. Chercheur associé Les champs `chercheur_id` et `chercheur_label` permettent d’identifier le chercheur ou responsable associé à la mission. Exemple : ```text chercheur_id : 159 chercheur_label : Cannavo, Anna ``` Le champ `chercheur_id` conserve l’identifiant technique du chercheur dans la source de données. Le champ `chercheur_label` contient la forme lisible du nom, utilisée pour l’affichage. Cette distinction permet de conserver à la fois un lien technique stable et une valeur compréhensible par l’utilisateur. --- ## 11. Rapport de mission Le champ `rapport_url` permet d’associer une mission à une ressource externe, par exemple un rapport de mission. Lorsque ce champ est renseigné, Archimage peut proposer un lien vers le rapport correspondant ou conserver cette information pour les exports et les traitements d’interopérabilité. Lorsque le champ est vide, aucune ressource externe n’est associée à la mission. --- ## 12. Utilisation dans Archimage Une fois importées ou mises à jour, les missions peuvent être associées aux fiches documentaires. Cette association permet par exemple de signaler qu’un document est lié à une mission précise : ```text Mission : A10_2014 - SIG d'Amathonte ``` La mission devient alors un point d’entrée documentaire. L’utilisateur peut retrouver les documents liés à une même opération scientifique ou à un même programme. --- ## 13. Mise à jour des missions L’outil d’indexation peut être relancé afin de mettre à jour les missions existantes. Lors d’une mise à jour, le script peut notamment : - ajouter les nouvelles missions ; - mettre à jour les intitulés ; - corriger les sites associés ; - compléter les informations de chercheur ; - ajouter ou modifier les liens vers les rapports ; - conserver les liens existants avec les fiches Archimage. Le champ `identifiant` joue ici un rôle essentiel, car il permet de reconnaître les missions déjà présentes dans Archimage. --- ## 14. Points de contrôle Après une indexation ou une mise à jour des missions, il est recommandé de vérifier : - que les nouvelles missions ont bien été créées ; - que les missions existantes n’ont pas été dupliquées ; - que les champs `code`, `code_year` et `intitule` sont cohérents ; - que les chercheurs associés sont correctement affichés ; - que les liens éventuels vers les rapports sont valides ; - que les fiches Archimage déjà liées à des missions conservent leurs associations. --- ## 15. Exemple de lecture À partir de la ligne suivante : ```text 1 | 2013_A_00001 | A10 | A10_2014 | SIG d'Amathonte | Amathonte - Agios Tychonas | ANTIQUITÉ | 2014 | 159 | Cannavo, Anna | ``` On peut lire : La mission possède l’identifiant externe `2013_A_00001`. Son code court est `A10` et son code annuel est `A10_2014`. Elle correspond à la mission intitulée `SIG d'Amathonte`, rattachée au site `Amathonte - Agios Tychonas`, à la section `ANTIQUITÉ`, pour l’année `2014`. Le chercheur associé est `Cannavo, Anna`, identifié par l’id `159`. --- ## 16. Synthèse L’indexation des missions permet à Archimage de relier ses fiches documentaires aux activités scientifiques de l’établissement. Elle permet de transformer une simple mention de mission en une donnée structurée, identifiable, actualisable et réutilisable dans la recherche, l’affichage public et les exports de métadonnées. # Publications L’outil d’indexation des publications permet d’importer et de mettre à jour dans Archimage les informations relatives aux publications scientifiques ou institutionnelles en renseignant le fichier config.php sur une URL de l’API ONIX. ``` ParamManager::getInstance()->add("PUBLICATIONS_API",""); ``` Ces publications proviennent d’une source externe, par exemple le catalogue des éditions ou une plateforme de gestion des publications. Elles sont ensuite stockées dans Archimage afin de pouvoir être associées aux fiches documentaires. Exemple fichier ONIX : [https://editions.efa.gr/index.php?kroute=api\_publications&token=76vrt9mop](https://editions.efa.gr/index.php?kroute=api_publications&token=76vrt9mop) L’objectif est de relier les documents conservés dans Archimage aux publications dans lesquelles ils sont cités, étudiés, reproduits ou contextualisés. --- ## 1. Rôle de l’indexation des publications L’indexation des publications permet de créer un lien entre une fiche Archimage et une publication. Ce lien peut ensuite être utilisé pour : - contextualiser un document ; - indiquer qu’un document est lié à une publication scientifique ; - retrouver les documents associés à une publication ; - enrichir les exports de métadonnées ; - créer des liens entre Archimage et la plateforme des éditions ; - renforcer l’interopérabilité entre les outils documentaires de l’établissement. Une publication n’est donc pas simplement une mention bibliographique saisie manuellement. Elle constitue une entité structurée, avec son propre identifiant, son titre, sa collection, son numéro, sa date de parution et un lien vers la ressource source. --- ## 2. Structure des données d’une publication Chaque publication importée dans Archimage est composée de plusieurs champs. Exemple de données : ```text id | publication_id | titre | collection | num_collection | date_parution | collection_short | link_ressource 1070 | 1128 | Ville et migrations internationales | Bibliothèque des Écoles françaises d'Athènes et de Rome | 418 | 12/31/2025 | BEFAR | https://editions.efa.gr/?kroute=publication&id=1128 1003 | 1058 | Les lampes minoennes | Études Crétoises | 38 | 12/31/2025 | Et. cret. | https://editions.efa.gr/?kroute=publication&id=1058 1103 | 1138 | Bulletin de Correspondance Hellénique | Bulletin de Correspondance Hellénique | 148.1 | 12/31/2025 | BCH | https://editions.efa.gr/?kroute=publication&id=1138 1020 | 1073 | De la lampe à la lumière en Crète minoenne | Bibliothèque des Écoles françaises d'Athènes et de Rome | 410 | 12/31/2025 | BEFAR | https://editions.efa.gr/?kroute=publication&id=1073 ``` --- ## 3. Description des champs
ChampDescription
`id`Identifiant interne de la publication dans Archimage.
`publication_id`Identifiant de la publication dans la plateforme source.
`titre`Titre de la publication.
`collection`Nom complet de la collection éditoriale.
`num_collection`Numéro de la publication dans la collection.
`date_parution`Date de parution de la publication.
`collection_short`Forme abrégée du nom de la collection.
`link_ressource`URL de la publication dans la plateforme source.
--- ## 4. Identifiant de publication Le champ `publication_id` permet de conserver le lien avec la plateforme d’origine. Exemple : ```text 1128 ``` Cet identifiant est important lors des mises à jour successives. Il permet au script de reconnaître une publication déjà indexée dans Archimage et d’éviter la création de doublons. Le champ `id`, quant à lui, correspond à l’identifiant interne utilisé par Archimage. --- ## 5. Titre de la publication Le champ `titre` contient le titre lisible de la publication. Exemples : ```text Ville et migrations internationales Les lampes minoennes Bulletin de Correspondance Hellénique De la lampe à la lumière en Crète minoenne ``` Ce titre est utilisé dans les interfaces de sélection, dans les fiches documentaires et éventuellement dans les exports. --- ## 6. Collection éditoriale Le champ `collection` contient le nom complet de la collection à laquelle appartient la publication. Exemples : ```text Bibliothèque des Écoles françaises d'Athènes et de Rome Études Crétoises Bulletin de Correspondance Hellénique ``` Le champ `collection_short` contient une forme abrégée de cette collection. Exemples : ```text BEFAR Et. cret. BCH ``` La forme longue permet un affichage complet et explicite. La forme courte peut être utilisée dans des interfaces plus compactes, des tableaux, des listes ou des exports. --- ## 7. Numéro de collection Le champ `num_collection` indique le numéro de la publication dans sa collection. Exemples : ```text 418 38 148.1 410 ``` Ce champ permet de distinguer les volumes au sein d’une même collection. Il peut contenir un nombre entier ou une valeur plus précise, comme `148.1`, selon la logique éditoriale de la collection. --- ## 8. Date de parution Le champ `date_parution` indique la date de publication. Exemple : ```text 12/31/2025 ``` Cette valeur permet de situer la publication dans le temps. Selon la source de données, la date peut correspondre à une date complète ou à une date normalisée utilisée par la plateforme source. Lorsque seule l’année est connue, la source peut utiliser une date conventionnelle. --- ## 9. Lien vers la ressource source Le champ `link_ressource` contient l’URL de la publication dans la plateforme d’origine. Exemple : ```text https://editions.efa.gr/?kroute=publication&id=1128 ``` Ce lien permet de créer une passerelle entre Archimage et le catalogue des publications. Depuis une fiche Archimage, l’utilisateur peut ainsi accéder à la publication liée, lorsque ce lien est affiché ou exploité par l’interface. --- ## 10. Utilisation dans Archimage Une fois importées ou mises à jour, les publications peuvent être associées aux fiches documentaires. Cette association permet par exemple d’indiquer qu’un document est lié à une publication précise : ```text Publication : BEFAR 418 - Ville et migrations internationales ``` ou : ```text Publication : Études Crétoises 38 - Les lampes minoennes ``` La publication devient alors un point d’entrée documentaire. L’utilisateur peut retrouver les documents associés à une même publication ou naviguer d’une notice documentaire vers une ressource éditoriale. --- ## 11. Mise à jour des publications L’outil d’indexation peut être relancé afin de mettre à jour les publications existantes. Lors d’une mise à jour, le script peut notamment : - ajouter de nouvelles publications ; - mettre à jour les titres ; - corriger les collections ; - compléter les numéros de collection ; - modifier les dates de parution ; - mettre à jour les liens vers les ressources sources ; - conserver les associations existantes avec les fiches Archimage. Le champ `publication_id` joue ici un rôle essentiel, car il permet de reconnaître les publications déjà présentes dans Archimage. --- ## 12. Points de contrôle Après une indexation ou une mise à jour des publications, il est recommandé de vérifier : - que les nouvelles publications ont bien été créées ; - que les publications existantes n’ont pas été dupliquées ; - que les champs `titre`, `collection` et `num_collection` sont cohérents ; - que les formes abrégées de collection sont correctes ; - que les dates de parution sont correctement interprétées ; - que les liens vers la plateforme source sont valides ; - que les fiches Archimage déjà liées à des publications conservent leurs associations. --- ## 13. Exemple de lecture À partir de la ligne suivante : ```text 1070 | 1128 | Ville et migrations internationales | Bibliothèque des Écoles françaises d'Athènes et de Rome | 418 | 12/31/2025 | BEFAR | https://editions.efa.gr/?kroute=publication&id=1128 ``` On peut lire : La publication possède l’identifiant interne `1070` dans Archimage et l’identifiant source `1128` dans la plateforme des publications. Son titre est `Ville et migrations internationales`. Elle appartient à la collection `Bibliothèque des Écoles françaises d'Athènes et de Rome`, abrégée en `BEFAR`, avec le numéro de collection `418`. Sa date de parution est indiquée comme `12/31/2025`. La ressource source est accessible à l’adresse `https://editions.efa.gr/?kroute=publication&id=1128`. --- ## 14. Synthèse L’indexation des publications permet à Archimage de relier ses fiches documentaires aux ressources éditoriales de l’établissement. Elle permet de transformer une simple référence bibliographique en une donnée structurée, identifiable, actualisable et reliée à une plateforme source. Ce mécanisme améliore la navigation entre les documents d’archives et les publications, renforce la cohérence des données et facilite leur réutilisation dans les interfaces de recherche et les exports de métadonnées. # Mots Clés L’outil d’indexation des mots-clés permet d’alimenter le moteur de recherche par défaut d’Archimage avec des termes issus des fiches documentaires. Ces mots-clés servent principalement à proposer des suggestions d’autocomplétion lors de la recherche. Ils permettent à l’utilisateur de retrouver plus facilement des termes déjà présents dans la base, sans devoir connaître exactement la forme utilisée dans les notices. --- ## 1. Rôle de l’indexation des mots-clés L’indexation des mots-clés a pour objectif d’améliorer l’expérience de recherche dans Archimage. Elle permet notamment : - d’extraire ou de récupérer des termes utilisés dans les fiches ; - de constituer une liste de mots-clés exploitables par le moteur de recherche ; - de proposer des suggestions lors de la saisie ; - d’harmoniser les recherches autour de termes déjà présents ; - d’aider l’utilisateur à découvrir les vocabulaires utilisés dans la base. Les mots-clés ne sont donc pas nécessairement des entités documentaires complexes. Ils constituent avant tout une indexation textuelle destinée à faciliter la recherche. --- ## 2. Utilisation dans le moteur de recherche Dans le moteur de recherche par défaut, les mots-clés peuvent être utilisés pour proposer des autocomplétions. Lorsqu’un utilisateur commence à saisir un terme, Archimage peut lui proposer des valeurs déjà indexées. Par exemple, si des notices contiennent régulièrement certains termes, ceux-ci peuvent être proposés automatiquement dans le champ de recherche. Cette fonctionnalité permet : - d’accélérer la saisie ; - de limiter les erreurs typographiques ; - d’orienter l’utilisateur vers des termes réellement présents dans la base ; - de rendre la recherche plus efficace. --- ## 3. Principe de fonctionnement Le script d’indexation des mots-clés parcourt les données utilisées par la recherche et met à jour une liste de termes exploitables par l’autocomplétion. Le principe général est le suivant : 1. le script identifie les termes à indexer ; 2. il ajoute les nouveaux mots-clés si nécessaire ; 3. il met à jour la liste utilisée par le moteur de recherche ; 4. les mots-clés deviennent disponibles dans les suggestions de recherche. Cette indexation peut être relancée afin de prendre en compte les nouvelles fiches ou les modifications apportées aux notices existantes. --- ## 4. Mise à jour des mots-clés L’indexation des mots-clés doit être relancée lorsque de nouvelles fiches sont créées ou lorsque des notices existantes sont fortement modifiées. Cette mise à jour permet de garantir que les suggestions proposées par le moteur de recherche restent cohérentes avec le contenu réel de la base. Après une mise à jour, les nouveaux termes peuvent apparaître dans l’autocomplétion du champ de recherche. # Auteurs L’outil d’indexation des auteurs permet de mettre à jour les informations relatives aux personnes associées aux fiches Archimage. Il s’appuie principalement sur le champ `id_ppn`, qui correspond à l’identifiant IdRef de l’auteur. À partir de cet identifiant, l’outil interroge la base nationale IdRef afin de récupérer ou de mettre à jour les informations d’autorité disponibles. L’objectif est d’harmoniser les formes d’auteurs utilisées dans Archimage et de les aligner avec un référentiel national d’autorité. --- ## 1. Rôle de l’indexation des auteurs L’indexation des auteurs permet d’améliorer la qualité et la cohérence des données relatives aux personnes. Elle permet notamment : - de compléter les informations d’un auteur à partir d’IdRef ; - de mettre à jour les formes normalisées des noms ; - d’ajouter ou corriger les dates de naissance et de décès ; - d’enrichir la description biographique ; - de conserver un identifiant d’autorité stable ; - de faciliter la recherche par auteur ; - d’améliorer les exports de métadonnées. Un auteur dans Archimage n’est donc pas seulement un nom saisi sous forme libre. Lorsqu’il est lié à IdRef, il devient une entité documentaire identifiable, actualisable et interopérable. --- ## 2. Principe de fonctionnement L’outil auteur utilise le champ `id_ppn` pour identifier une notice d’autorité dans IdRef. Le principe général est le suivant : 1. Archimage identifie les auteurs disposant d’un `id_ppn` ; 2. le script interroge IdRef à partir de cet identifiant ; 3. les informations disponibles dans IdRef sont récupérées ; 4. les champs de l’auteur sont mis à jour dans Archimage ; 5. les fiches liées à cet auteur bénéficient d’une information plus fiable et plus homogène. Le champ `id_ppn` est donc la clé de correspondance entre Archimage et IdRef. --- ## 3. Structure des données d’un auteur Chaque auteur est composé de plusieurs champs. Exemple de données : ```text id | nom | prenom | initiale | fk_id_ensembles | description | annee_naissance | annee_deces | code_notice | adresse | domaine_public | id_ppn | point_acces 15 | Anville | Jean-Baptiste Bourguignon d' | J.-B. | Personne | Géographe ordinaire du roi en 1719. - Auteur de nombreuses cartes, il a réuni une importante collection achetée par Louis XVI en 1779 (au département des Cartes et plans de la Bibliothèque nationale depuis 1924). Né et mort à Paris | 1697 | 1782 | | | | 032948638 | Anville, Jean-Baptiste Bourguignon d' (1697-1782) 21 | Kourtessi-Philippaki | Georgia | G. | Personne | Préhistorienne et archéologue. A soutenu une habilitation à diriger des recherches en archéologie à Paris 1 en 2006 | 1952 | | | | | 029293944 | Κουρτέση-Φιλιππάκη, Γεωρία (1952-....) ``` --- ## 4. Description des champs
ChampDescription
`id`Identifiant interne de l’auteur dans Archimage.
`nom`Nom de famille ou nom principal de l’auteur.
`prenom`Prénom ou forme développée du prénom de l’auteur.
`initiale`Initiale ou forme abrégée du prénom.
`fk_id_ensembles`Type d’entité associé à l’auteur, par exemple `Personne`.
`description`Description biographique ou note d’autorité récupérée ou mise à jour depuis IdRef.
`annee_naissance`Année de naissance de l’auteur, lorsqu’elle est connue.
`annee_deces`Année de décès de l’auteur, lorsqu’elle est connue.
`code_notice`Code de notice éventuel utilisé selon les besoins internes.
`adresse`Adresse éventuelle associée à l’auteur, si ce champ est utilisé.
`domaine_public`Indication éventuelle liée au domaine public ou à un statut particulier.
`id_ppn`Identifiant IdRef de l’auteur ; c’est la clé utilisée pour la mise à jour depuis `idref.fr`.
`point_acces`Forme d’accès normalisée ou forme d’autorité de l’auteur.
--- ## 5. Identifiant IdRef Le champ `id_ppn` est l’élément central de l’outil d’indexation des auteurs. Exemple : ```text 032948638 029293944 ``` Cet identifiant correspond à une notice d’autorité dans IdRef. Il permet à Archimage de retrouver l’auteur dans la base nationale et de mettre à jour les informations disponibles. Sans `id_ppn`, l’outil ne peut pas garantir une correspondance fiable avec IdRef. L’auteur peut exister dans Archimage, mais il ne pourra pas être automatiquement enrichi depuis la base nationale. --- ## 6. Nom, prénom et initiale Les champs `nom`, `prenom` et `initiale` permettent de gérer les différentes formes courantes du nom de l’auteur. Exemple : ```text nom : Anville prenom : Jean-Baptiste Bourguignon d' initiale : J.-B. ``` Ces champs peuvent être utilisés dans les interfaces d’administration, les listes de sélection, les fiches publiques ou les exports. Ils permettent de proposer un affichage clair tout en conservant une forme courte lorsque cela est nécessaire. --- ## 7. Point d’accès Le champ `point_acces` correspond à la forme d’autorité ou forme normalisée de l’auteur. Exemples : ```text Anville, Jean-Baptiste Bourguignon d' (1697-1782) Κουρτέση-Φιλιππάκη, Γεωρία (1952-....) ``` Cette forme est particulièrement importante pour l’interopérabilité, car elle permet d’utiliser une formulation normalisée issue du référentiel d’autorité. Elle peut différer de la simple combinaison du nom et du prénom, notamment lorsque la notice IdRef utilise une forme linguistique, historique ou scientifique spécifique. --- ## 8. Description biographique Le champ `description` contient une note descriptive ou biographique sur l’auteur. Exemple : ```text Géographe ordinaire du roi en 1719. - Auteur de nombreuses cartes, il a réuni une importante collection achetée par Louis XVI en 1779... ``` ou : ```text Préhistorienne et archéologue. A soutenu une habilitation à diriger des recherches en archéologie à Paris 1 en 2006 ``` Cette information permet d’enrichir la fiche auteur et d’apporter un contexte supplémentaire aux utilisateurs. Elle est particulièrement utile lorsque plusieurs auteurs portent des noms proches ou lorsque l’identification d’une personne nécessite des éléments biographiques. --- ## 9. Dates de naissance et de décès Les champs `annee_naissance` et `annee_deces` permettent d’indiquer les dates connues de l’auteur. Exemple : ```text annee_naissance : 1697 annee_deces : 1782 ``` ou : ```text annee_naissance : 1952 annee_deces : ``` Lorsque l’année de décès est vide, cela signifie que l’information n’est pas disponible ou que la personne est considérée comme vivante dans la source d’autorité. Ces dates contribuent à distinguer les homonymes et à améliorer la qualité des données d’autorité. --- ## 10. Type d’entité Le champ `fk_id_ensembles` indique le type d’entité concerné. Dans les exemples fournis, la valeur est : ```text Personne ``` Cela permet de distinguer les personnes physiques d’autres types d’entités éventuelles, par exemple des collectivités, institutions ou groupes, si ces catégories sont utilisées dans Archimage. --- ## 11. Utilisation dans Archimage Une fois les auteurs mis à jour, ils peuvent être associés aux fiches documentaires. Une fiche peut ainsi indiquer qu’un document est lié à un auteur particulier : ```text Auteur : Anville, Jean-Baptiste Bourguignon d' (1697-1782) ``` ou : ```text Auteur : Κουρτέση-Φιλιππάκη, Γεωρία (1952-....) ``` Cette association permet : - d’afficher une forme d’auteur plus fiable ; - de faciliter les recherches par auteur ; - de produire des exports plus cohérents ; - de relier les fiches Archimage à un référentiel externe ; - de réduire les variantes de noms dans la base. --- ## 12. Mise à jour des auteurs L’outil peut être relancé afin de mettre à jour les auteurs existants. Lors d’une mise à jour, le script peut notamment : - interroger IdRef à partir du champ `id_ppn` ; - mettre à jour le point d’accès ; - compléter ou corriger la description ; - ajouter ou corriger les années de naissance et de décès ; - harmoniser certaines formes de nom ; - conserver les liens déjà établis avec les fiches Archimage. Le champ `id_ppn` doit être conservé avec attention, car il garantit le lien entre l’auteur Archimage et sa notice IdRef. --- ## 13. Points de contrôle Après une mise à jour des auteurs, il est recommandé de vérifier : - que les auteurs disposant d’un `id_ppn` ont bien été traités ; - que les points d’accès ont été correctement mis à jour ; - que les dates de naissance et de décès sont cohérentes ; - que les descriptions récupérées sont pertinentes ; - que les caractères accentués, apostrophes et caractères non latins sont correctement conservés ; - que les fiches liées aux auteurs n’ont pas perdu leurs associations ; - qu’aucun doublon n’a été créé. Une attention particulière doit être portée aux noms multilingues ou translittérés, comme dans le cas des formes grecques. --- ## 14. Exemple de lecture À partir de la ligne suivante : ```text 15 | Anville | Jean-Baptiste Bourguignon d' | J.-B. | Personne | Géographe ordinaire du roi en 1719... | 1697 | 1782 | | | | 032948638 | Anville, Jean-Baptiste Bourguignon d' (1697-1782) ``` On peut lire : L’auteur possède l’identifiant interne `15` dans Archimage. Son nom est `Anville`, son prénom est `Jean-Baptiste Bourguignon d'` et son initiale est `J.-B.`. Il s’agit d’une entité de type `Personne`. Sa description biographique indique qu’il était géographe ordinaire du roi et auteur de nombreuses cartes. Il est né en `1697` et décédé en `1782`. Son identifiant IdRef est `032948638`, et son point d’accès normalisé est `Anville, Jean-Baptiste Bourguignon d' (1697-1782)`. --- ## 15. Synthèse L’outil auteur permet à Archimage de s’appuyer sur le référentiel national IdRef pour améliorer la qualité des données relatives aux personnes. Grâce au champ `id_ppn`, les auteurs peuvent être identifiés de manière stable, enrichis automatiquement et reliés à une notice d’autorité externe. Cette indexation améliore la recherche, l’affichage des fiches, la qualité des exports et l’interopérabilité générale de la plateforme. # DOI - Datacite Archimage permet de créer et de mettre à jour automatiquement des DOI pour les fiches documentaires publiques destinées à être citées de manière pérenne. Le DOI est un identifiant stable associé à une ressource numérique. Dans Archimage, il permet d’identifier durablement une fiche publique et de faciliter sa citation dans des publications, des catalogues, des exports ou d’autres plateformes. La création et la mise à jour des DOI s’appuient sur DataCite. La plateforme peut donc créer automatiquement des entrées dans DataCite à partir des métadonnées présentes dans Archimage. --- ## 1. Rôle des DOI dans Archimage Les DOI permettent d’associer une fiche Archimage à un identifiant pérenne. Ils servent notamment à : - fournir un lien stable vers une notice ; - faciliter la citation scientifique des documents ; - améliorer l’interopérabilité de la plateforme ; - exposer des métadonnées structurées vers DataCite ; - renforcer la visibilité des ressources publiées ; - relier Archimage à des infrastructures de référencement externes. Lorsqu’un DOI est associé à une fiche publique, il peut être affiché dans la page de la notice, avec les autres formats d’export de métadonnées. --- ## 2. Fonctionnement général Le fonctionnement des DOI dans Archimage repose sur plusieurs étapes. ### 2.1 Sélection des fiches concernées Toutes les fiches publiques dans Archimage peuvent recevoir un DOI. Les DOI concernent principalement les fiches qui sont destinées à être diffusées publiquement et citées de manière stable. La politique d’attribution des DOI dépend donc des choix documentaires et institutionnels de l’établissement. --- ### 2.2 Préparation des métadonnées Avant la création d’un DOI, Archimage utilise les métadonnées de la fiche pour préparer l’entrée DataCite. Ces métadonnées peuvent notamment inclure : - le titre ou l’intitulé de la fiche ; - la référence documentaire ; - les auteurs ou contributeurs ; - l’éditeur ou l’institution responsable ; - la date ; - l’URL publique de la notice ; - le type de ressource ; - les informations de licence ou d’accès ; - les informations nécessaires à l’identification de la ressource. La qualité du DOI dépend donc directement de la qualité des métadonnées présentes dans la fiche Archimage. --- ### 2.3 Création dans DataCite Lorsque les conditions sont réunies, Archimage peut créer automatiquement une entrée dans DataCite. Cette opération permet : - de réserver ou créer le DOI ; - de transmettre les métadonnées associées ; - d’associer le DOI à l’URL publique de la fiche ; - de conserver le lien entre la notice Archimage et son identifiant pérenne. Une fois le DOI créé, il peut être enregistré dans Archimage et affiché dans la fiche publique si la notice est publiée. --- ### 2.4 Mise à jour des métadonnées Les métadonnées d’une fiche peuvent évoluer après la création du DOI. Archimage prévoit donc des outils de mise à jour afin de synchroniser les informations entre la fiche locale et l’entrée DataCite. Cette mise à jour permet de conserver une cohérence entre : - la notice Archimage ; - les métadonnées envoyées à DataCite ; - l’URL de la ressource ; - l’état public ou non public de la fiche. --- ## 3. Configuration de l'API Ce chapitre décrit les paramètres nécessaires avant de pouvoir créer des DOI. Elle concerne notamment la configuration DataCite dans le fichier `config.php`. Les paramètres principaux peuvent inclure :
ParamètreDescription
`DATACITE_API`URL de l’API DataCite utilisée par Archimage.
`DATACITE_BASE_URL`URL de résolution des DOI.
`DATACITE_HOSTED_PAGES`URL de consultation ou d’administration DataCite.
`DATACITE_PREFIX`Préfixe DOI attribué à l’établissement.
`DATACITE_USER`Nom d’utilisateur du compte DataCite.
`DATACITE_PASSWORD`Mot de passe du compte DataCite.
`DATACITE_SUFFIX`Suffixe ou modèle de suffixe utilisé pour les DOI.
`DATACITE_EMAIL`Adresse de contact utilisée dans les métadonnées DOI.
`DATACITE_DEFAULT_AUTHOR`Auteur par défaut utilisé lorsqu’aucun auteur n’est disponible.
Avant d’utiliser les scripts DOI, il faut vérifier que ces paramètres sont correctement renseignés. --- ### Indexation des nouvelles fiches Cette option est utile lorsque de nouvelles notices sont publiées ou lorsque des lots de fiches deviennent éligibles à l’attribution d’un DOI. --- ### Mise à jour des DOI Cette option permet de synchroniser les métadonnées déjà envoyées à DataCite avec les informations actuelles présentes dans Archimage. Cette opération peut être nécessaire après : - une correction de titre ; - une modification d’auteur ; - une mise à jour de la description ; - un changement d’URL publique ; - une modification des conditions d’accès ; - une évolution de la politique de publication. --- ### Lister les DOI non publics Cette page décrit l’outil permettant d’identifier les DOI associés à des fiches qui ne sont pas publiques. Ce contrôle est important, car un DOI doit normalement renvoyer vers une ressource accessible selon la politique de diffusion prévue. L’outil permet de repérer les incohérences possibles entre : - les fiches disposant d’un DOI ; - les fiches effectivement publiées ; - les fiches masquées ou non accessibles ; - les métadonnées exposées à DataCite ; - les ressources réellement disponibles pour les utilisateurs. --- ## 4. Points de vigilance La création automatique de DOI doit être utilisée avec prudence. Avant de lancer une indexation ou une mise à jour, il est recommandé de vérifier : - que la configuration DataCite est correcte ; - que l’environnement utilisé est bien celui souhaité, test ou production ; - que les fiches concernées sont réellement prêtes à être publiées ; - que les métadonnées principales sont complètes ; - que les auteurs, titres et dates sont cohérents ; - que les URLs publiques des notices sont valides ; - que les droits de diffusion sont compatibles avec la création d’un DOI. Un DOI engage la stabilité de la citation. Il est donc préférable de corriger les fiches avant la création du DOI plutôt qu’après