Projet

Général

Profil

Fonctionnalité #20180

Fonctionnalité #19409: Audit de pérennisation

Référentiel de formats interne

Ajouté par Cyril VAZQUEZ il y a environ 2 ans. Mis à jour il y a plus d'un an.

Statut:
Clôturé
Priorité:
1-Majeur
Assigné à:
Charlotte Bataille
Version cible:
Début:
17/03/2022
Echéance:
Tags RM:
2.9

Description

En tant qu'administrateur, je veux gérer un référentiel des formats afin de planifier la préservation des données numériques.

Détail
Nouvel écran d'administration des formats

  • Liste des formats définis
  • Formulaire d'ajout/modification
  • fonction de suppression

Reprendre entité digitalResource.format
Ajouter indicateur de pérennité : sustainability (bool)

A la création: choix d'un puid ramène par défaut
* le nom
* les types mime
* les extensions
* la version

Après enregistrement le puid est immuable (pk)

Les autres informations sont modifiables :
* Nom (en priorité)
* types mime et extensions dans un second temps (valeur ?)
* version ?

formats.png (136 ko) formats.png Charlotte Bataille, 11/04/2022 14:31
formatsUpdated.png (127 ko) formatsUpdated.png Charlotte Bataille, 25/04/2022 17:05
11458
11551

Demandes liées

Lié à Backlog RM - Anomalie #20465: [Formats] Erreur de recherche de format PRONOMClôturé2022-04-08

Historique

#1 Mis à jour par Cyril VAZQUEZ il y a environ 2 ans

  • Statut changé de A traiter à R&D - En test

#2 Mis à jour par Charlotte Bataille il y a environ 2 ans

11458

Branche à tester sur socle et AP : feat/20180_format_reference_source

/!\ Passez le script migrationV2.8_V3.sql au préalable

Profil : archiviste

Écran à tester

http://maarchrm/digitalResource/formats

Retour attendu
cf. fichier joint formats.png

L'écran répertorie les différents formats enregistrés en base (table digitalResource/format).
Il est possible de les filtrer et de les trier par Puid ainsi que par Nom.

Création de format

Pour créer un format, remplir le formulaire à droite de la liste des formats puis cliquer sur Enregistrer.
Le champ Puid est un typeahead qui permet de rechercher un format PRONOM par puid ainsi que par nom.
Une fois un format PRONOM sélectionné :

  • ses métadonnées sont chargées dans les champs correspondants (Nom, Version, Mimetypes, Extensions)
  • il est possible de modifier tous les champs sauf le champ Puid. Pour vider le formulaire de création, cliquer sur Annuler

Par défaut, un format est pérenne et actif.
NB : Il n'est pas possible de créer un format qui n'est pas référencé dans le catalogue de formats PRONOM.

Route à tester

POST /digitalResource/format

Exemple de corps pour test via API

{
    "format" : {
        "puid": "fmt/13",
        "name": "pdf",
        "version": "1A",
        "mimetypes": null,
        "extensions": null,
        "sustainability": true,
        "enabled" : true
    }
}

Retour attendu
Réponse 200 : le service retourne un booléen qui correspond au résultat de l'opération (true en cas de succès, sinon false).
Le format défini en corps de requête, est créé dans la table digitalResource/format.

Modification d'un format

Pour modifier un format, cliquer sur le bouton Éditer à droite d'un format.
Le formulaire de Création d'un format devient celui de Modification d'un format et les métadonnées du format sélectionné y sont chargées.
Il est possible de modifier tous les champs sauf le champ Puid.
Cliquer sur le bouton Modifier pour appliquer les modifications.

Route à tester

PUT /digitalResource/format

Exemple de corps pour test via API

{
    "puid": "fmt/13",
    "format" : {
        "puid": "fmt/13",
        "name": "pdfTest",
        "version": "1A",
        "mimetypes": null,
        "extensions": null,
        "sustainability": true,
        "enabled": false
    }
}

Retour attendu
Réponse 200 : le service retourne un booléen qui correspond au résultat de l'opération (true en cas de succès, sinon false).

Suppression d'un format

Pour supprimer un format, cliquer sur le bouton Supprimer à droite d'un format.
Un message de confirmation s'affiche.
Une fois la suppression confirmée, le format disparaît du tableau sur l'écran et un message s'affiche.
Le format est supprimé de la table digitalResource/format.

Exemple de route à tester

DELETE /digitalResource/format?puid=fmt/13

Retour attendu
Réponse 200 : le service retourne un booléen qui correspond au résultat de l'opération (true en cas de succès, sinon false).

Autres routes à tester :

  • Lire un format à partir de son puid

Exemple de route à tester

GET /digitalResource/format/getbypuid?puid=fmt/13

Retour attendu
Réponse 200 : le service retourne les informations du format retrouvé.

  • Lister les formats

Route à tester

GET /digitalResource/format/list

Retour attendu
Réponse 200 : le service retourne en json tous les formats de la table digitalResource/format.

  • Lister les formats PRONOM

L'ancienne route pour lister les formats PRONOM a été renommée.

Route à tester

GET /digitalResource/pronomFormat/list

Retour attendu
Réponse 200 : le service retourne une liste des formats PRONOM.

#3 Mis à jour par Cyril VAZQUEZ il y a environ 2 ans

  • Version cible changé de 3.0 à 2.9

#4 Mis à jour par Cyril VAZQUEZ il y a environ 2 ans

  • Statut changé de R&D - En test à A revoir (S)
  • Tags RM 2.9 ajouté

Modifications demandées:

Remplacer le statut "Pérenne" + "activé" par un statut (entier ?) utilisé dans le RGI :

  • 1 = en observation, pas encore utilisable
  • 2 = recommandé (pérenne et interopérable)
  • 3 = en fin de vie (avertissement, déprécié)
  • 4 = retiré (ne pas utiliser, non pérenne)

A la création, c'est le nom du format qui remplit le champ PUID au lieu du puid

Rebrancher le test de fichier

#5 Mis à jour par Cyril VAZQUEZ il y a environ 2 ans

  • Lié à Anomalie #20465: [Formats] Erreur de recherche de format PRONOM ajouté

#6 Mis à jour par Cyril VAZQUEZ il y a presque 2 ans

  • Statut changé de A revoir (S) à R&D - En cours

#7 Mis à jour par Charlotte Bataille il y a presque 2 ans

Modifications appliquées sur socle:

  • data/maarchRM/sql/pgsql/migrationV2.8_V3.sql
  • bundle/digitalResource > format.php (Controller, Message, Model, Presenter)
  • fr/digitalResource/format.po
  • view/digitalResource/format/v3index.html

Branche à tester sur socle : feat/20180_format_reference_source

/!\ Passez le script migrationV2.8_V3.sql au préalable

Écran à tester

http://maarchrm/digitalResource/formats

Retour attendu
cf. fichier joint formatsUpdated.png et modifications demandées (https://forge.maarch.org/issues/20180#note-4)

#8 Mis à jour par Charlotte Bataille il y a presque 2 ans

11551

#9 Mis à jour par Cyril VAZQUEZ il y a plus d'un an

  • Statut changé de R&D - En test à Clôturé

Formats disponibles : Atom PDF