VITAM Guide De Lecture La Ation

User Manual:

Open the PDF directly: View PDF PDF.
Page Count: 28

DownloadVITAM Guide De Lecture La Ation
Open PDF In BrowserView PDF
Documentation Vitam
Guide de lecture

Date

Version

30/01/2019

4.0
(Release 9)

1

État du document
●

En projet

Vérifié

Validé

Maîtrise du document
Responsabilité
Rédaction
Vérification
Validation

Nom
MR
Équipe

Entité
Équipe Vitam
Équipe Vitam
Équipe Vitam

Date
06/06/2018
15/06/18

Suivi des modifications
Version
0.1
0.2
0.3.
0.4.

Date
28/06/2017
05/07/2017
13/07/2017
28/11/2017

Auteur
MR
MR
MR
MR

1.0

20/03/2018

MR

1.1

06/06/2018

MRE

2.0

25/06/2018

MRE

2.1

15/10/2018

MRE

3.0

25/10/2018

MRE

3.1
4.0

25/01/2019
30/01/19

MRE
MRE

Modifications
Initialisation
Reprise suite à commentaires EV, JSL, KW
Finalisation du document pour publication
Finalisation du document pour publication
de la V1 fonctionnelle
Finalisation du document pour publication
de la V1 de production
Relecture et ajout de la doc Profil des unités
archivistiques
Finalisation du document pour publication
de la Release 7
Relecture et ajout de la doc Profil des unités
archivistiques
Finalisation du document pour publication
de la Release 8
Relecture
Finalisation du document pour publication
de la Release 9

Licence
La solution logicielle VITAM est publiée sous la licence CeCILL 2.1 ; la documentation associée
(comprenant le présent document) est publiée sous Licence Ouverte V2.0.

2

Programme Vitam – Guide de lecture – v 4.0

Table des matières
1. Introduction.............................................................................................................................4
1.1 Présentation du programme Vitam...................................................................................4
1.2 Présentation du document................................................................................................5
2. Lire la documentation Vitam : à chaque besoin, sa documentation…....................................6
3. Découvrir la solution logicielle Vitam....................................................................................7
3.1. Présentation du projet solution logicielle........................................................................7
3.2. Guide de prise en main de la solution logicielle Vitam (1er transfert).............................7
3.3. Storymap.........................................................................................................................8
4. Comprendre et approfondir les concepts Vitam......................................................................9
4.1. Backlog............................................................................................................................9
4.2. Organisation de l’information.........................................................................................9
4.3. Modèle de données........................................................................................................10
4.4. Modèle de Workflow.....................................................................................................11
4.5. Dossier d’architecture technique (DAT)........................................................................12
5. Installer et gérer la solution logicielle...................................................................................13
5.1. Documentation d’installation (DIN).............................................................................13
5.2. Documentation d’exploitation (DEX)...........................................................................13
6. Interfacer et ajouter des composants à la solution logicielle Vitam......................................15
6.1. Manuel d’intégration applicative...................................................................................15
6.2. JAVADOC.....................................................................................................................15
6.3. Documentation des API externes..................................................................................16
7. Tester la solution logicielle...................................................................................................17
7.1. Manuel d’utilisation de l’IHM de recette......................................................................17
7.2. Scenarios de tests métier et tests de non régression......................................................17
7.3. Cahier de tests métiers...................................................................................................17
8. Utiliser la solution logicielle.................................................................................................19
8.1. Manuel utilisateur..........................................................................................................19
8.2. Structuration des Submission Information Packages (SIP)...........................................19
8.3. Règles de gestion...........................................................................................................20
8.4. Services Producteurs.....................................................................................................21
8.5. Arbre de positionnement et Plan de classement............................................................21
8.6. Conservation de la valeur probante...............................................................................22
8.7. Gestion des habilitations...............................................................................................23
8.8. Profils d’archivage........................................................................................................24
8.9. Profils d’unité archivistique..........................................................................................25
8.10. Ontologie.....................................................................................................................26
8.11. Structuration des Dissemination Information Packages (DIP)....................................26
9. Maintenir la solution logicielle.............................................................................................28
9.1. Manuel de développement.............................................................................................28
9.2. Documentation des API internes...................................................................................28

Licence Ouverte V2.0.

3

Programme Vitam – Guide de lecture – v 4.0

1. Introduction
Jusqu’à présent, pour la gestion, la conservation, la préservation et la consultation des
archives numériques, les acteurs du secteur public étatique ont utilisé des techniques
d’archivage classiques, adaptées aux volumes limités dont la prise en charge leur était
proposée. Cette situation évolue désormais rapidement et les acteurs du secteur public étatique
doivent se mettre en capacité de traiter les volumes croissants d’archives numériques qui
doivent être archivés, grâce à un saut technologique.

1.1 Présentation du programme Vitam
Les trois ministères (Armées, Culture et Europe et Affaires étrangères), combinant légalement
mission d'archivage définitif et expertise archivistique associée, ont décidé d'unir leurs efforts,
sous le pilotage de la Direction interministérielle du numérique et du système d’information et
de communication de l’État (DINSIC), pour faire face à ces enjeux. Ils ont lancé un
programme nommé Vitam (Valeurs Immatérielles Transmises aux Archives Pour Mémoire)
qui couvre plus précisément les opérations suivantes :


la conception, la réalisation et la maintenance mutualisées d’une solution logicielle
d'archivage électronique de type back-office, permettant la prise en charge, le
traitement, la conservation et l’accès aux volumes croissants d’archives (projet de
solution logicielle Vitam) ;



l’intégration par chacun des trois ministères porteurs du Programme de la solution
logicielle dans sa plate-forme d’archivage. Ceci implique l’adaptation ou le
remplacement des applications métiers existantes des services d'archives pour unifier
la gestion et l'accès aux archives, la reprise des données archivées depuis le début des
années 1980, la réalisation d'interfaces entre les applications productrices d’archives et
la plate-forme d’archivage (projets SAPHIR au MEAE, ADAMANT au MC et
ArchiPél au MinArm) ;



le développement, par un maximum d’acteurs de la sphère publique, de politiques et
de plates-formes d’archivage utilisant la solution logicielle (projet Ad-Essor).

La solution logicielle Vitam est développée en logiciel libre et recourt aux technologies
innovantes du Big Data, seules à même de relever le défi de l’archivage du nombre d’objets
numériques qui seront produits ces prochaines années par les administrations de l’État. Afin
de s’assurer de la qualité du logiciel livré et de limiter les dérapages calendaires de réalisation,
le projet est mené selon une conduite de projet Agile. Cette méthode dite « itérative »,
« incrémentale » et « adaptative » opère par successions de cycles réguliers et fréquents de
développements-tests-corrections-intégration. Elle associe les utilisateurs tout au long des
développements en leur faisant tester les éléments logiciels produits et surtout en leur
demandant un avis sur la qualité des résultats obtenus. Ces contrôles réguliers permettent

Licence Ouverte V2.0.

4

Programme Vitam – Guide de lecture – v 4.0

d’éviter de mauvaises surprises lors de la livraison finale de la solution logicielle en
corrigeant au fur et à mesure d’éventuels dysfonctionnements.
Le programme Vitam bénéficie du soutien du Commissariat général à l’investissement dans le
cadre de l'action : « Transition numérique de l’État et modernisation de l'action publique » du
Programme d'investissement d'avenir. Il a été lancé officiellement le 9 mars 2015, suite à la
signature de deux conventions, la première entre les ministères porteurs et les services du
Premier ministre, pilote du programme au travers de la DINSIC, et la seconde entre les
services du Premier ministre et la Caisse des dépôts et consignations, relative à la gestion des
crédits attribués au titre du Programme d’investissements d’avenir.

1.2 Présentation du document
Le présent document constitue un guide permettant de s’orienter au sein de la documentation
produite par le Programme Vitam.
Il s’articule autour des axes suivants :
•

qui sont les utilisateurs ? : archivistes, informaticiens (développeurs, architectes)

•

quel est leur besoin ? : découvrir, tester, installer, utiliser, interfacer le logiciel…

•

quel document leur apportera l’information qu’ils recherchent ?

Le document comporte une carte apportant une vision globale croisant ces trois axes
(utilisateur/besoin/documentation) et une fiche signalétique de chaque document produit par
le Programme Vitam, comportant sa description, le public ciblé, le lien pour consulter le
document et une extraction du sommaire.
Il est conseillé de consulter les documents du général au particulier, dans l’ordre de la
démarche présentée par le schéma suivant. Par exemple, pour un développeur, il est conseillé
de consulter le document d’architecture avant le manuel d’intégration.

Licence Ouverte V2.0.

5

Programme Vitam – Guide de lecture – v 4.0

2. Lire la documentation Vitam :
documentation…

Licence Ouverte V2.0.

à chaque besoin, sa

6

Programme Vitam – Guide de lecture – v 4.0

3. Découvrir la solution logicielle Vitam
3.1. Présentation du projet solution logicielle
Présentation : ce document présente de manière assez générale la solution logicielle : mode
de développement, vision générale fonctionnelle et technique de la solution.
Lien vers le document : Présentation de la solution logicielle Vitam
Public cible : toute personne voulant découvrir la solution logicielle Vitam, tant profil
technique que fonctionnel.
Sommaire :
•

Solution logicielle Vitam : Manifeste, Une logique back-office… à l’écoute des
besoins métiers et techniques, Planning, Contenu des versions, Normes et textes pris
en compte, Sécurité, Maintenance

•

Vision fonctionnelle : « Story Map » : Principe d’élaboration et Contenu, Interfaces
Homme Machine

•

Vision technique : Architecture générale, Modules du Coeur Vitam, Moteur de
traitement, Moteur de données, Gestion des journaux, Gestion des offres de stockage,
Principes d’organisation des archives

3.2. Guide de prise en main de la solution logicielle Vitam (1er transfert)
Présentation : ce document décrit comment effectuer une première entrée dans la solution
logicielle Vitam. Il explicite les étapes obligatoires de paramétrage et de préparation des lots
d’archives. Un lexique en annexe explicite et détaille les principaux objets métiers avec une
description, un statut (obligatoire ou facultatif) pour l’opération d’entrée et renvoie vers la
documentation permettant d’approfondir cette notion.
Le document est accompagné d’un « kit » comportant les fichiers d’exemple utiles (contrats,
référentiels, SIP)
Lien vers le document : Guide de prise en main de la solution logicielle Vitam
Public cible : toute personne voulant découvrir et tester la solution logicielle Vitam.
Sommaire :
•
•
•

Avertissements
Processus
Lexique

Licence Ouverte V2.0.

7

Programme Vitam – Guide de lecture – v 4.0

3.3. Storymap
Présentation : Le document présente l’ensemble des macro-fonctionnalités destinées à être
développées dans les versions successives de la solution logicielle Vitam d’ici 2019. Il permet
à tous les acteurs du programme Vitam de s’accorder sur les domaines fonctionnels devant
être traités et de prioriser les travaux de réalisation de la solution logicielle Vitam, en se
focalisant sur la valeur métier des activités pour les utilisateurs.
Le document offre aux acteurs du programme Vitam une vue globale du produit attendu, audelà du fractionnement induit par la méthodologie Agile.
Lien vers le document : réservé aux porteurs et partenaires, la Storymap est accessible via
Jalios
Public cible : Archiviste.

Licence Ouverte V2.0.

8

Programme Vitam – Guide de lecture – v 4.0

4. Comprendre et approfondir les concepts Vitam
4.1. Backlog
Présentation : Le document présente la liste mise à jour à l’issue de chaque release, des users
stories réalisées durant les 15 dernières semaines.
Lien vers le document : réservé aux porteurs et partenaires, le Backlog est accessible via
Jalios
Public cible : Archiviste.

4.2. Organisation de l’information
Présentation : Le document présente l’organisation fonctionnelle de l’information (données
et métadonnées) retenue pour la solution logicielle Vitam.
Il s’articule autour de trois grands axes :
•

les exigences fonctionnelles impactant l’organisation de l’information ;

•

la manière dont la solution logicielle Vitam adapte les spécifications de la norme
OAIS pour répondre aux exigences fonctionnelles identifiées précédemment,
notamment dans la conception de ce que la norme OAIS désigne sous l’expression
d’Archival Information Packages (AIP) ;

•

l’organisation de l’information dans la solution logicielle Vitam en tant que telle.

Il doit permettre à tout projet d’implémentation de la solution logicielle Vitam d’alimenter le
dossier de description technique du système tel qu’exigé par les normes NF Z42-013 et
NF Z42-020.
Il contextualise le modèle de données fourni comme documentation de la solution logicielle.
Lien vers le document : Organisation de l'information
Public cible : Archivistes
Sommaire :
•

Exigences : transverses ; associées aux différentes étapes du cycle de vie des objets
archivés

•

Implémentation de la norme OAIS dans la solution logicielle Vitam
◦ Les paquets transférés au système d’archivage : les Submission Information
Packages (SIP)
◦ Les paquets gérés par le système d’archivage : les Archival Information Packages
(AIP)

Licence Ouverte V2.0.

9

Programme Vitam – Guide de lecture – v 4.0

◦ Les paquets transmis par le système d’archivage : les Dissemination Information
Packages (DIP)
•

Structuration proposée :
◦ Données de référence
◦ Objets permettant la gestion des droits
◦ Stratégies liées à la gestion
◦ Modèles et structuration des objets métiers
◦ Descriptions
◦ Journaux et registres

4.3. Modèle de données
Présentation : Le document présente l’organisation technique des données et métadonnées au
sein de la solution logicielle Vitam.
Il a pour objectif de présenter la structure générale des collections utilisées dans la solution
logicielle Vitam. Il est destiné principalement aux développeurs, ainsi qu’à tous les autres
acteurs du programme, pour leur permettre de connaître ce qui existe en l’état actuel.
Il explicite chaque champ, précise la relation avec les sources (manifeste conforme au
standard SEDA v.2.1 ou référentiels Pronom et règles de gestions) et la structuration JSON
stockée dans MongoDB.
Pour chacun des champs, cette documentation apporte :
•

Une liste des valeurs licites ;

•

La sémantique ou syntaxe du champ ;

•

La codification en JSON.

Il décrit aussi parfois une utilisation particulière faite à une itération donnée.
Lien vers le document : Modèle de données
Public cible : développeurs
Sommaire :
•

Base Identity

•

Base Logbook

•

Base MetaData

•

Base MasterData

•

Base Report

Licence Ouverte V2.0.

10

Programme Vitam – Guide de lecture – v 4.0

4.4. Modèle de Workflow
Présentation : Ce document présente les différents processus employés par la solution
logicielle Vitam. Il explicite chaque processus (appelés également “workflow”), et pour
chacun d’eux, leurs tâches et traitements. Ce document comprend également du matériel
additionnel pour faciliter la compréhension des processus comme des fiches récapitulatives et
des schémas. Il explique également la manière dont est formée la structure des fichiers de
workflow.
Un workflow est un processus composé d’étapes (macro-workflow), elles-mêmes composées
d’une liste d’actions à exécuter de manière séquentielle, une seule fois ou répétées sur une
liste d’éléments (micro-workflow).
Pour chacun de ces éléments, le document décrit :
•

La règle générale qui s’applique à cet élément

•

Les statuts de sortie possibles (OK, KO...), avec les raisons de ces sorties et les clés
associées

•

Des informations complémentaires, selon le type d’élément traité

Chaque étape, chaque action peuvent avoir les statuts suivants :
•

OK : le traitement associé s’est passé correctement. Le workflow continue.

•

Warning : le traitement associé a généré un avertissement. Le workflow continue.

•

KO : le traitement associé a généré une erreur métier. Le workflow s’arrête si le
modèle d’exécution est bloquant.

•

FATAL : le traitement associé a généré une erreur technique. Le workflow s’arrête.

Chaque action peut avoir les modèles d’exécutions suivants (toutes les étapes sont par défaut
bloquantes) :
•

Bloquant : Si une action est identifiée en erreur, l’étape en cours est alors arrêtée et le
workflow passe à un nouvel état.

•

Non bloquant : Si une action est identifiée en erreur, le reste des actions de l’étape est
exécuté avant que le statut de l’étape passe à « erreur ». Le workflow passe alors à un
nouvel état.

Lien vers le document : Modèle de Workflow
Public cible : administrateurs aussi bien techniques que fonctionnels, archivistes souhaitant
une connaissance plus avancée du logiciel, développeurs.
Sommaire :
•
•
•

Audit
DIP (Dissemination Information Package)
Ingest

Licence Ouverte V2.0.

11

Programme Vitam – Guide de lecture – v 4.0

•
•
•
•
•

MasterData
Traceability
Update
Unit Mass Update
Modification d’arborescences

4.5. Dossier d’architecture technique (DAT)
Présentation : Le document présente une vision d’ensemble des problématiques structurantes
de la solution logicielle Vitam (d’un point de vue applicatif et technique). Il explicite
également les choix structurants de principes et composants de réalisation de la solution
logicielle, ainsi que les raisons de ces choix.
Lien vers le document : Dossier d’architecture technique
Public cible : architectes applicatifs et techniques de projets désirant intégrer la solution
logicielle Vitam, développeurs, exploitants
Sommaire :
•
•
•
•
•

Vue d’ensemble
Architecture applicative
Architecture technique / exploitation
Sécurité
Architecture détaillée

Licence Ouverte V2.0.

12

Programme Vitam – Guide de lecture – v 4.0

5. Installer et gérer la solution logicielle
5.1. Documentation d’installation (DIN)
Présentation : Le document a pour but de fournir à une équipe d’exploitants de la solution
logicielle Vitam les procédures et informations nécessaires pour l’installation de celle-ci.
Lien vers le document : Documentation d’installation (DIN)
Public cible : informaticiens, exploitants ayant de bonnes connaissances en environnement
Linux.
Sommaire :
•
•
•
•
•

Rappels
Pré-requis à l’installation
Procédure d’installation
Procédure de mise à jour
Post installation

5.2. Documentation d’exploitation (DEX)
Présentation : Le document a pour but de fournir à une équipe d’exploitants de la solution
logicielle Vitam les procédures et informations nécessaires au bon fonctionnement de celle-ci.
Lien vers le document : Documentation d'exploitation (DEX)
Public cible : informaticiens, exploitants ayant de bonnes connaissances en environnement
Linux.
Sommaire :
•
•
•
•
•
•
•
•

Architecture de la solution logicielle Vitam
Exploitation globale
Suivi de l’état du système
Exploitation des composants de la solution logicielle Vitam
Intégration d’une application externe dans Vitam
Aide à l’exploitation
Questions fréquemment posées
Exploitation par composants

5.3 Documentation de montées de version (DMV)
Présentation : Le document a pour but de fournir à une équipe d’exploitants de VITAM les

Licence Ouverte V2.0.

13

Programme Vitam – Guide de lecture – v 4.0

procédures et informations utiles pour réaliser les montées de version de la solution logicielle.
Il décrit les chemins de montées de versions supportés.
Lien vers le document : Documentation de montées de version (DMV)
Public cible :
•

Les architectes techniques des projets désirant intégrer la solution logicielle VITAM ;

•

Les exploitants devant installer la solution logicielle VITAM

Sommaire :
•

Introduction

•

Rappels

•

Nomenclature des versions

•

Montées de version

Licence Ouverte V2.0.

14

Programme Vitam – Guide de lecture – v 4.0

6. Interfacer et ajouter des composants à la solution logicielle
Vitam
6.1. Manuel d’intégration applicative
Présentation : Le document présente comment interfacer la solution logicielle Vitam avec
une application métier : comment développer un connecteur Vitam, et instaurer un dialogue
entre l’application et la solution logicielle Vitam, développer des plugin...
Lien vers le document : Manuel d’intégration applicative
Public cible : développeurs
Sommaire :
•
•
•
•

API
Exemples
DSL Java Vitam
Utilisation des clients externes

6.2. JAVADOC
Présentation : Le document présente la documentation interne du code de la solution
logicielle Vitam, notamment la documentation associée aux clients java externes de celle-ci.
Ces éléments de code peuvent être utilisés pour associer une application à la solution
logicielle Vitam.
Lien vers le document : JAVADOC
Public cible : développeurs, mainteneurs de la solution logicielle Vitam
•
•
•
•
•
•
•
•
•
•
•
•
•
•

Ihm Demo
Ihm Recette
Ingest External Client
Ingest module
Access External Client
Acces module
Common module
Functional administration module
Logbook module
Metadata module
Processing module
Storage Driver / Offer modules
Storage Engine module
Worker module

Licence Ouverte V2.0.

15

Programme Vitam – Guide de lecture – v 4.0

•
•

Workspace module
Other Packages

6.3. Documentation des API externes
Présentation : Le document présente, sous forme de RAML, les API REST, exposées aux
applications métiers.
Lien vers le document : Documentation des API externes
Public cible : développeurs
Sommaire :
•
•
•
•
•

Access
DSL
Functional-administration
Ingest
Logbook

Licence Ouverte V2.0.

16

Programme Vitam – Guide de lecture – v 4.0

7. Tester la solution logicielle
7.1. Manuel d’utilisation de l’IHM de recette
Présentation : Le document présente pas à pas l’utilisation de l’IHM de recette, développée à
des fins de tests uniquement.
Lien vers le document : Manuel d’utilisation de l’IHM de recette
Public cible : Exploitants, Développeurs pour la partie DSL
Sommaire :
•
•
•
•

Recette
Administration des collections
Tests (performance, fonctionnels, requêtes DSL, visualisation des graphs)
Sécurisation des journaux

7.2. Scenarios de tests métier et tests de non régression
Présentation : Le document présente les différentes méthodes et outils de test pour pouvoir
tester au maximum les fonctionnalités offertes par la solution logicielle Vitam, que ce soit via
ses API ou en passant par un outillage de test automatisé. Les utilisateurs testeurs de la
solution logicielle Vitam peuvent ainsi reproduire, dans leur propre environnement, les cas de
tests proposés par l’équipe Vitam.
Lien vers le document : Scénarios de tests métier
Public cible : Archivistes, Développeurs (tests Cucumber et interface de recette du DSL)
Sommaire :
•
•
•
•
•

Tests manuels
Tests automatisés
Écriture des TNR
Guide d’écriture des tests Cucumber
Tests Curl

7.3. Cahier de tests métiers
Présentation : Ce document recense l’ensemble des tests réalisés manuellement au fil des
développements de la solution logicielle Vitam afin d’en vérifier le bon fonctionnement et la
conformité aux spécifications demandées. Il permet, à l’équipe Vitam, de reproduire ces tests
lors de chaque campagne de recette. Ces tests peuvent être adaptés et reproduits par les projets

Licence Ouverte V2.0.

17

Programme Vitam – Guide de lecture – v 4.0

d’implémentation à partir de leurs propres jeux de données.
Pour chaque test on détaille les éléments suivants :
•

Titre du cas de test : description du contenu du test et le statut attendu pour l’opération
effectuée (succès ou échec),

•

Itération : numéro de l’itération de la solution logicielle Vitam pour laquelle le test a
été conçu (et par conséquent, les itérations suivantes). [Attention les itérations 1 à 17
figurent sous la référence IT17]

•

User Storie : la référence des user stories (dans le logiciel Tuleap interne à l’équipe
Vitam) à laquelle le test se rapporte

•

Nom de l’activité : le nom de l’activité (dans la storymap Vitam) à laquelle la user
storie et le test se rapportent,

•

Code Story Map : le code de l’activité (dans la storymap Vitam) à laquelle la user
storie et le test se rapportent,

•

Mode opératoire pour réaliser le test,

•

Résultat attendu pour le test,

•

IHM/API : le type d’interface de la solution logicielle Vitam par lequel le test peut être
réalisé au sein des modules les interfaces de démonstrations (IHM) ou les interfaces
programmatiques,

•

Jeu de test associé : le nom du SIP avec lequel le test peut être réalisé. Les jeux de
tests
sont
disponibles
dans
les
ressources
publiées
le
dossier
« Jeux_de_tests_fonctionnels_RELEASE7_SEDA2.1 »

•

Couvert par les TNR

Lien vers le document : Cahier de tests métiers
Public cible : Archivistes

Licence Ouverte V2.0.

18

Programme Vitam – Guide de lecture – v 4.0

8. Utiliser la solution logicielle
8.1. Manuel utilisateur
Présentation : Le document présente pas à pas l’utilisation de la solution logicielle Vitam au
travers des Interfaces standard (IHM) fournies. Il a pour objectif de guider l’utilisateur de la
solution logicielle Vitam dans la gestion de ses archives, tout en lui permettant de se
familiariser avec les principales fonctionnalités.
Public cible : Archivistes
Lien vers le document : Manuel Utilisateur
Sommaire :
•
•
•
•
•
•
•
•
•

Généralités
Authentification
Entrée de SIP et de plan de classement
Recherche, consultation et modification
Gestion des archives
Administration
Traitements de masse
Modification en masse des métadonnées
Éliminations en masse

8.2. Structuration des Submission Information Packages (SIP)
Présentation : Le document décrit la manière de préparer des entrées d’archives destinées à
être transférées dans une plate-forme utilisant la solution logicielle Vitam. L’entrée doit être
réalisée conformément aux deux normes et standard suivants : OAIS (Open Archival
Information System) et Seda (Standard d’Échanges de Données pour l’Archivage).
Lien vers le document : Structuration des SIP
Public cible : Archivistes, utilisateurs et administrateurs fonctionnels
Sommaire :
•

Introduction : Définition ; Contexte normatif (OAIS, SEDA, MEDONA)

•

Constitution d’un SIP pour une plate-forme utilisant la solution logicielle Vitam : Le
paquet à archiver ; Le bordereau ; Le répertoire et ses objets

•

Import dans Vitam

•

Annexes :
◦ Extensions du SEDA ;

Licence Ouverte V2.0.

19

Programme Vitam – Guide de lecture – v 4.0

◦ Exemple de bordereau « simple » réalisé pour un jeu de test Vitam
◦ Exemple de bordereau « complexe » réalisé pour un jeu de test Vitam
◦ Exemple de bordereau « complexe » permettant le rattachement d’ArchiveUnits à
des éléments déjà présents dans le système

8.3. Règles de gestion
Présentation :Le document présente les fonctionnalités associées à l’utilisation des règles de
gestion dans la solution logicielle Vitam.
Il s’articule autour des axes suivants :
•

présentation des règles de gestion associées aux archives et de la manière dont le
Standard d’échanges de données pour l’archivage (SEDA) les formalise ;

•

présentation des mécanismes mis en œuvre dans la solution logicielle Vitam pour gérer
ces règles de gestion, en application du SEDA ;

•

recommandations aux ministères porteurs, partenaires et utilisateurs de la solution
logicielle Vitam sur la manière d’utiliser les fonctionnalités associées aux règles de
gestion.

Public cible : Archivistes
Lien vers le document : Règles de gestion
Sommaire :
•

Présentation des règles de gestion : Description des règles de gestion ; Formalisation
des règles dans le SEDA ;

•

Mécanismes mis en œuvre dans la solution logicielle Vitam : Administration du
référentiel des règles de gestion ; Entrées ; Gestion des archives existantes ; Accès ;

•

Conseils de mise en œuvre :
◦ Comment élaborer le référentiel des règles de gestion ?
◦ Où positionner les règles ?
◦ Comment utiliser les mécanismes de contrôle des métadonnées offerts par la
solution logicielle Vitam pour les règles de gestion ?
◦ Quand et comment bloquer l’héritage de règles ?
◦ Comment afficher les règles de gestion associées aux unités archivistiques ?
◦ Comment utiliser les règles de gestion associées aux unités archivistiques pour
gérer les droits d’accès des utilisateurs ?

•

Annexe : Exemple de message ArchiveTransfer mettant en œuvre les différentes
possibilités d’utilisation des règles de gestion

Licence Ouverte V2.0.

20

Programme Vitam – Guide de lecture – v 4.0

8.4. Services Producteurs
Présentation : Le document présente les fonctionnalités associées à la prise en compte de la
notion de service producteur dans la solution logicielle Vitam. Il s’articule autour des axes
suivants :
•
•
•

une présentation de la notion de service producteur et de la manière dont le Standard
d’échanges de données pour l’archivage (SEDA) la formalise ;
une présentation des mécanismes mis en œuvre dans la solution logicielle Vitam pour
prendre en compte cette notion, en application du SEDA ;
des recommandations aux ministères porteurs, partenaires et utilisateurs de la solution
logicielle Vitam sur la manière d’utiliser les fonctionnalités associées aux services
producteurs.

Public cible : Archivistes
Lien vers le document : Services producteurs
Sommaire :
•

Présentation de la notion de service producteur :
◦ Description ;
◦ Formalisation de la notion de service producteur dans le SEDA ;
◦ Extension du schéma SEDA 2.1. pour prendre en compte la notion de service
producteur ;

•

Mécanismes mis en œuvre dans la solution logicielle Vitam : Import d’un référentiel
des services agents ; Entrées ; Registre des fonds ; Accès ;

•

Conseils de mise en œuvre : Comment découper ses SIP ? Comment gérer les droits
d’accès à la solution logicielle Vitam ?

8.5. Arbre de positionnement et Plan de classement
Présentation : Le document présente les fonctionnalités associées à l’utilisation des arbres de
positionnement et plans de classement dans la solution logicielle Vitam.
Il s’articule autour des axes suivants :
•

une présentation des arbres de positionnement et plans de classement et de la manière
dont le Standard d’échanges de données pour l’archivage (SEDA) est utilisé pour les
formaliser ;

•

une présentation des mécanismes mis en œuvre dans la solution logicielle Vitam pour
gérer ces arbres et plans ;

•

une présentation et des recommandations sur la génération d’un plan de classement ou
d’un arbre de positionnement au moyen du générateur SEDA ;

Licence Ouverte V2.0.

21

Programme Vitam – Guide de lecture – v 4.0

•

des recommandations aux ministères porteurs, partenaires et utilisateurs de la solution
logicielle Vitam sur la manière d’utiliser les fonctionnalités associées aux arbres et
plans.

Lien vers le document : Arbres de positionnement et plans de classement
Public cible : Archivistes
Sommaire :
•

Présentation des arbres et plans : Description ; Formalisation des arbres et plans dans
le SEDA

•

Mécanismes mis en œuvre dans la solution logicielle Vitam : Import, Accès, dans les
unités archivistiques et le registre des fonds ;

•

Conseils de mise en œuvre :
◦ Quand faut-il créer un arbre de positionnement ou un plan de classement ?
◦ Faut-il associer des règles de gestion à un plan de classement ?
◦ Peut-on mettre à jour un arbre de positionnement ou un plan de classement ?
◦ Est-il possible de faire cohabiter plusieurs arbres de positionnement et plusieurs
plans de classement ?
◦ Comment articuler plan de classement et profil d’archivage ?
◦ Comment restituer graphiquement des arbres de positionnement et des plans de
classement ?

8.6. Conservation de la valeur probante
Présentation : Le document présente la stratégie de conservation de la valeur juridique des
archives conservées dans une plate-forme utilisant la solution logicielle Vitam, d’un point de
vue fonctionnel. Ce sujet est central pour un système d’archivage numérique. L’objectif est de
rendre prouvable toute opération effectuée sur toute unité archivistique ou tout objet qui lui
est associé.
Dans la solution logicielle Vitam, cette valeur probante est conservée de façon systémique,
elle repose sur un faisceau d’éléments redondants dont la modification simultanée et
cohérente est impossible, ou plus exactement non réalisable en pratique. Les journaux
constituent un élément central de cette sécurité systémique.
Lien vers le document : Conservation de la valeur probante
Public cible : Archivistes, exploitants
Sommaire :
•
•

Journaux
Preuve systémique

Licence Ouverte V2.0.

22

Programme Vitam – Guide de lecture – v 4.0

•

•

Sécurisation des journaux
◦ Contexte de sécurisation
◦ Procédure de sécurisation
◦ Mise en œuvre sur le journal des opérations
◦ Mise en œuvre sur les journaux de cycle de vie
◦ Mise en œuvre sur le journal des écritures
Relevé de valeur probante

8.7. Gestion des habilitations
Présentation : Le document présente les fonctionnalités associées à la gestion et à
l’utilisation des habilitations dans la solution logicielle Vitam.
Il s’articule autour des axes suivants :
•

une présentation des différentes habilitations : contexte applicatif, contrat d’entrée,
contrat d’accès, et de la manière dont le Standard d’échanges de données pour
l’archivage (SEDA) et le modèle de données de la solution logicielle Vitam sont
utilisés pour les formaliser ;

•

une présentation des mécanismes mis en œuvre dans la solution logicielle Vitam pour
gérer ces habilitations ;

•

des recommandations aux ministères porteurs, partenaires et utilisateurs de la solution
logicielle Vitam sur la manière d’utiliser les fonctionnalités associées à ces
habilitations.

Lien vers le document : Gestion des habilitations
Public cible : Archivistes, exploitants
Sommaire :
•

Présentation des habilitations : Description et Formalisation des habilitations :
Certificat applicatif, Certificat personnel, Profil de sécurité, Contexte applicatif,
Contrat d’entrée, Contrat d’accès ; Profil de sécurité ;

•

Mécanismes mis en œuvre dans la solution logicielle Vitam : Administration des
référentiels ; Authentification ; Entrées ; Accès ;

•

Conseils de mise en œuvre :
◦ Certificat applicatif, Certificat personnel, Profil de sécurité, Contexte applicatif,
Contrat d’entrée, Contrat d’accès ; Profil de sécurité ;
◦ Comment nommer les différentes habilitations ?
◦ Quel accès aux différentes habilitations ?
◦ Gestion des droits
◦ Restitution sur une IHM

Licence Ouverte V2.0.

23

Programme Vitam – Guide de lecture – v 4.0

◦ Comment utiliser les différentes habilitations ?
◦ Comment gérer une nouvelle application ?
Annexe 1 : exemples d’habilitations
•

Annexe 2 : cas d’utilisation des habilitations

•

Annexe 3 : Liste des permissions et privilèges

8.8. Profils d’archivage
Présentation : Le document présente les fonctionnalités associées à la prise en compte de la
notion de profil d’archivage dans la solution logicielle Vitam.
Il s’articule autour des axes suivants :
•

une présentation de la notion de profil d’archivage ;

•

une présentation de la manière dont le Standard d’échanges de données pour
l’archivage (SEDA) la formalise ;

•

une présentation des mécanismes mis en œuvre dans la solution logicielle Vitam pour
prendre en compte cette notion, en application du SEDA ;

•

des recommandations aux ministères porteurs, partenaires et utilisateurs de la solution
logicielle Vitam sur la manière d’élaborer un profil d’archivage ;

•

quelques conseils complémentaires de mise en œuvre

Lien vers le document : Profils d'archivage
Public cible : Archivistes
Sommaire :
•

Présentation de la notion de profil d’archivage : Qu’est-ce qu’un profil d’archivage ;
Pourquoi élaborer un profil d’archivage ?

•

Formalisation des profils d’archivage : Dans un fichier propre ; Dans le SEDA

•

Mécanismes mis en œuvre dans la solution logicielle Vitam
◦ Administration d’un référentiel des profils d’archivage : Import de la notice
descriptive du profil d’archivage ; Import du profil d’archivage lui-même ;
Modification de la notice descriptive d’un profil d’archivage ; Activation /
Désactivation d’un profil d’archivage
◦ Processus d’entrée : Déclaration d’un profil d’archivage dans un contrat d’entrée ;
Processus de contrôles d’une entrée
◦ Recommandations

•

Étapes d’élaboration d’un profil d’archivage :
◦ Analyse et Structuration des données à verser ;
◦ Rédaction, Corrections et Documentation d’un profil d’archivage ;

Licence Ouverte V2.0.

24

Programme Vitam – Guide de lecture – v 4.0

◦ Réalisation d’un bordereau de transfert conforme au profil d’archivage
•

Conseils de mise en œuvre

•

Annexe 1 : Déclaration des références aux listes de codes (CodeListVersions)

•

Annexe 2 : Exemple de notice détaillée d’un profil d’archivage

•

Annexe 3 : Liste de messages d’erreur

8.9. Profils d’unité archivistique
Présentation : Le document présente les fonctionnalités associées à la prise en compte de la
notion de profil d’unité archivistique dans la solution logicielle Vitam.
Il s’articule autour des axes suivants :
• une présentation de la notion de profil d’unité archivistique ;
• une présentation de la manière dont le Standard d’échanges de données pour
l’archivage (SEDA) la formalise ;
• une présentation des mécanismes mis en œuvre dans la solution logicielle Vitam pour
prendre en compte cette notion, en application du SEDA ;
• une présentation des modalités de création d’un profil d’unité archivistique et de son
schéma de contrôle ;
• des recommandations aux utilisateurs de la solution logicielle Vitam sur l’élaboration
d’un profil d’unité archivistique ;
• quelques conseils complémentaires de mise en œuvre.
Lien vers le document : Profils d'unité archivistique
Public cible : Archivistes, développeurs
Sommaire :
•

Présentation de la notion de profil d’unité archivistique : qu’est-ce qu’un profil d’unité
archivistique ? pourquoi élaborer un profil d’unité archivistique ?

•

Formalisation des profils d’unité archivistique : dans un fichier propre, dans le SEDA

•

Mécanismes mis en œuvre dans la solution logicielle Vitam : administration d’un
référentiel des profils d’unité archivistique, processus d’entrée, Accès

•

Étapes d’élaboration d’un profil d’unité archivistique : analyse des données,
structuration des données à verser

•

Conseils de mise en œuvre

•

Annexe 1 : Schéma de contrôle par défaut dans la solution logicielle Vitam

•

Annexe 2 : Exemple de notice détaillée d’un profil d’unité archivistique

•

Annexe 3 : Types JSON

•

Annexe 4 : Messages d’erreur

Licence Ouverte V2.0.

25

Programme Vitam – Guide de lecture – v 4.0

8.10. Ontologie
Présentation : Le document présente les fonctionnalités associées à la prise en compte de la
notion d'ontologie dans la solution logicielle Vitam.
Il s’articule autour des axes suivants :
• une présentation de la notion d'ontologie ;
• une présentation de la manière dont la solution logicielle Vitam la formalise ;
• une présentation des mécanismes mis en œuvre dans la solution logicielle Vitam pour
prendre en compte cette notion ;
• quelques conseils complémentaires de mise en œuvre.
Lien vers le document : Ontologie
Public cible : Archivistes, développeurs
Sommaire :
•

Présentation de la notion d'ontologie

•

Formalisation des vocabulaires ontologiques : dans la solution logicielle Vitam, dans
le SEDA

•

Mécanismes mis en œuvre dans la solution logicielle Vitam : Administration de
l'ontologie, Contrôle de l'ontologie sur les profils d’unité archivistique, Processus
d’entrée, Accès

•

Conseils de mise en œuvre
◦ Quand et comment créer une ontologie ?
◦ Quand et comment créer un vocabulaire ?
◦ Quand et comment modifier un type d’indexation ?
◦ Quels sont les types d’indexation compatibles entre un profil d’unité archivistique
et des vocabulaires ontologiques ?
◦ Quand et comment supprimer un vocabulaire ?
◦ Comment mettre à jour une unité archivistique associée ou non à un profil d’unité
archivistique ?
◦ Quel accès à l’ontologie ?
◦ Gestion des droits
◦ Restitution sur une IHM
◦ Comment utiliser l’ontologie ?

8.11. Structuration des Dissemination Information Packages (DIP)
Présentation : Le document présente les fonctionnalités associées au Dissemination
Information Package dans la solution logicielle Vitam. Le DIP est un moyen de mettre à
Licence Ouverte V2.0.

26

Programme Vitam – Guide de lecture – v 4.0

disposition de tiers (services producteurs, autres services d’archives, usagers sur place et à
distance…) les archives et leurs métadonnées conservées par le service d’archives, si besoin
après vérification des droits des demandeurs. Le document décrit la manière de préparer des
paquets et de les mettre à disposition dans une plate-forme utilisant la solution logicielle
Vitam.
Lien vers le document : Structuration des DIP
Public cible : Archivistes, utilisateurs et administrateurs fonctionnels
Sommaire :
•

Présentation du DIP : Définition ; Contexte normatif (OAIS, SEDA, MEDONA)

•

Constitution d’un DIP par une plate-forme utilisant la solution logicielle Vitam :
◦ Les caractéristiques techniques du paquet à communiquer
◦ Les modalités de lancement de l’opération de mise à disposition d’un DIP
◦ Les modalités de récupération du DIP
◦ Le bordereau

•

Annexe : Exemple de bordereau de mise à disposition

Licence Ouverte V2.0.

27

Programme Vitam – Guide de lecture – v 4.0

9. Maintenir la solution logicielle
9.1. Manuel de développement
Présentation : Le document explicite les règles et points durs de développement de la
réalisation de la solution logicielle Vitam (code interne).
Lien vers le document : Manuel de développement
Public cible : développeurs, mainteneurs de la solution logicielle Vitam
Sommaire :
•
•
•
•
•
•
•

Configuration de l’environnement de développement
Détails par composant
Parallélisation des tests
Plugin ICU Elasticsearch
Gestion des bases de données
Ressources et clients
Création d’une machine de dev contenant Swift

9.2. Documentation des API internes
Présentation : Le document présente, sous forme de RAML, la documentation associée aux
API REST, exposées entre les composants de la solution logicielle Vitam.
Lien vers le document : Documentation des API internes
Public cible : développeurs, mainteneurs de la solution logicielle Vitam
Sommaire
•
•
•
•
•
•
•
•
•
•
•

Access
Functional-administration
Ingest
Logbook
Metadata
Offer
Processing
Storage
Technical-administration
Worker
Workspace

Licence Ouverte V2.0.

28



Source Exif Data:
File Type                       : PDF
File Type Extension             : pdf
MIME Type                       : application/pdf
PDF Version                     : 1.4
Linearized                      : No
Page Count                      : 28
Language                        : fr-FR
Has XFA                         : No
Author                          : edouard vasseur
Creator                         : Writer
Producer                        : LibreOffice 5.0
Create Date                     : 2019:01:30 13:01:10+01:00
EXIF Metadata provided by EXIF.tools

Navigation menu