Archivematica 1.8.1 is a legacy release, and these documents are no longer being maintained.

Gestion des erreurs

Archivematica tient compte du fait que plusieurs types d’erreurs peuvent survenir lors du traitement. Certaines erreurs entraînent l’arrêt du traitement, auquel cas le transfert ou SIP en cours est envoyé dans le répertoire Échecs de l’explorateur de fichiers. D’autres types d’erreurs permettent la poursuite du traitement en cours. Par exemple, lorsqu’une erreur de normalisation est signalée, l’utilisateur peut choisir de poursuivre le traitement du SIP.

If you don’t find an answer here or elsewhere in the user manual, please try searching the Archivematica user forum. Someone may have had the same problem before and been offered a solution. If you do not find the answer there, feel free to ask us a question. The best questions to the list include as much information as possible about the error. This means offering us information about the system(s) you’re using, the content of your transfer(s), and copying the task information (click on the cog icon on the same line as the microservice job where the error occurred) and show arguments data output. See task information and show arguments data for the same error, below.

Sur cette page:

Notification des erreurs dans le tableau de bord

When a microservice fails or encounters an error, the workflow will be halted and Archivematica will report a “Failed transfer”. The microservice drop-down can be expanded to show the specific task that failed.

The dashboard showing a transfer has failed

The dashboard showing a transfer has failed at the Verify transfer checksums microservice

Veuillez noter que le transfert a été envoyé dans le répertoire Échecs et que le traitement a été interrompu.

Microservice expanded to show the failed job

The expanded detail on “Failed transfer”

Cliquer sur l’icône des tâches (engrenage à droite) pour ouvrir le rapport d’erreur :

An error report showing that a virus has been found in a file

An error report showing that a file has failed checksum validation

Certaines erreurs sont prévisibles et les rapports d’erreur sont utiles pour le dépannage. Veuillez noter que les fichiers qui ont fait l’objet d’une erreur sont toujours mentionnés au début du rapport.

Rapports d’échec dans l’onglet Administration

Pour voir les rapports d’échec dans l’onglet Administration du Tableau de bord. Voir Onglet Administration du Tableau de bord - Échecs pour plus d’information.

Courriel de rapport d’échec

Archivematica will send email reports for two kinds of failures:

  • Normalization reports are sent when the normalization process has resulted in at least one error.
  • Failure reports are sent when the workflow fails unexpectedly.
An emailed failure report showing an error at Verify bag microservice

An emailed failure report showing an error at Verify bag microservice

Un courriel est envoyé automatiquement si le transfert ou l’acquisition ne peut pas être terminé, mais pas dans les cas où une erreur permettant la poursuite des opérations survient. Veuillez noter que l’option de livraison par courriel doit être activée dans le serveur pour que cette fonction soit opérationnelle sans nécessiter de configuration supplémentaire.

For more information about email reports, please see Email notification configuration

Erreurs de normalisation

Les erreurs de normalisation apparaissent dans le Tableau de bord quand :

  • Une tentative de normalisation échoue,
  • Aucune normalisation n’est tentée et le fichier n’est pas enregistré dans un format reconnu.

Quand la normalisation échoue, le traitement du SIP se poursuit jusqu’à l’étape de validation de la normalisation. L’utilisateur a alors deux options :

Option 1

Cliquer sur l’icône du rapport à côté du menu déroulant Actions pour voir le rapport sommaire de la normalisation :

Normalization report showing failed normalization attempts

Rapport de normalisation montrant les tentatives de normalisation ayant échoué.

Le rapport montre ce qui a été normalisé, ce qui est déjà dans un format de préservation et d’accès convenable et ce qui n’a pas pu être normalisé ou ce qui n’est pas dans un format de préservation ou d’accès reconnu. Si la normalisation a échoué, on peut cliquer sur « Oui » pour voir un rapport d’erreur plus détaillé dans un nouvel onglet :

Task output for failed normalization job

Rapport de sortie d’une tâche de normalisation ayant échoué

Option 2

Click Review in parentheses next to the microservice to view the normalization results in a directory structure in a new browser tab:

Review normalization results in a new tab

Résultats d’un examen de normalisation ouvert dans un nouvel onglet

L’examen permet à l’utilisateur d’ouvrir les objets à partir du navigateur, si le plugiciel adéquat est installé, ou de télécharger les objets et de les ouvrir dans une application locale.

L’utilisateur peut choisir de poursuivre le traitement du SIP malgré les erreurs de normalisation.

L’utilisateur peut aussi choisir de relancer la normalisation. Par exemple, si des erreurs surviennent en utilisant les résultats FITS-JHOVE, l’utilisateur peut retenter la normalisation à partir des résultats FITS-DROID.

Redo normalization option in drop-down menu of Approve normalization job

L’option de relance de la normalisation dans le menu déroulant de la tâche « Approuver la normalisation ».

Archivematica will send an email when normalization errors occur. Information given in the email report:

  • UUID du pipeline
  • Nom et UUID du SIP
  • Nom et UUID du fichier, et type d’échec (préservation ou accès)
  • Code de sortie

Le code de sortie 1 indique qu’une règle et une commande de normalisation existent, mais n’ont pas été exécutées correctement (à cause d’un problème de commande, de fichier, etc.) Le code de sortie 2 indique qu’aucune règle/commande n’existe pour le format concerné.

Normalization error report sent by email

Rapport d’erreur de normalisation envoyé par courriel

Erreur de téléchargement du DIP

Archivematica permet à l’utilisateur de poursuivre une tentative de téléchargement du DIP en cas d’erreur de saisie du permalien :

Warning that permalink was incorrect, allows user to retry upload DIP

Avertissement indiquant que le permalien est incorrect. L’utilisateur peut retenter le téléchargement du DIP.

Autres erreurs communes

  1. Verify metadata directory checksums: if the checksums in the metadata directory cannot be verified (i.e. if a file is missing or corrupted) the microservice will fail and the transfer will be moved in the failed directory.
  2. Scan for viruses: if a virus is found the microservice will fail and the transfer will be moved in the failed directory.
  3. Caractériser et extraire les métadonnées : Si un traitement FITS échoue, le microservice échoue et le transfert se poursuit. De même, si un outil échoue dans FITS, comme dans JHOVE, la barre d’erreur rose s’affiche, mais le traitement peut se poursuivre.
  4. Remove thumbs.db file: if Archivematica is unable to remove a thumbs.db file, the microservice will fail and the SIP will continue processing.
  5. Normalize submission documentation to preservation format: if normalization fails, the microservice will fail and the SIP will continue processing.

Rejeter un transfert ou SIP

À toute étape d’approbation, l’utilisateur peut choisir de rejeter un transfert, SIP, AIP ou DIP (suivant l’étape du déroulement des opérations). Le transfert ou SIP refjeté sera envoyé vers le répertoire des refus (accessible depuis le navigateur de fichiers) et tout traitement le concernant sera interrompu. Cependant, le transfert ou SIP apparaîtra dans le Tableau de bord. Voir Retirer un transfert ou SIP du Tableau de bord, ci-dessous, pour les effacer du Tableau de bord.

Retirer un transfert ou SIP du Tableau de bord

Pour retirer un transfert ou SIP du Tableau de bord, cliquer sur l’icône « Retirer » rouge du Tableau de bord :

Click on the red Remove icon to remove a transfer or SIP from the dashboard

Pour retirer un transfert ou SIP du Tableau de bord, cliquer sur l’icône « Retirer » rouge du Tableau de bord, puis cliquer sur confirmer.

On recommande de supprimer régulièrement tous les SIP et transferts du Tableau de bord pour en optimiser la performance.

Navigateurs compatibles

Archivematica has been tested most extensively with Firefox and Chrome. There are known issues with Internet Explorer 11 which result in an inability to start transfers in the dashboard (Issue 7246). Minimal, but successful, testing has been done with Microsoft Edge.

Retour en haut de page