# 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.