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 :
[
{
"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 :
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
| Champ | Description |
|---|---|
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 :
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 :
A10
Le champ code_year ajoute l’année au code de la mission.
Exemple :
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 :
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 :
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 :
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 :
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 :
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 :
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_yearetintitulesont 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 :
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.