Transloadit

Le paramètre ignore_errors

Le paramètre ignore_errors est pris en charge par tous les Robots au niveau du Step. Il vous permet de poursuivre le traitement d’une Assembly lorsque certaines erreurs par fichier sont acceptables dans votre flux de travail.

Pourquoi ce paramètre peut être utile

ignore_errors est utile lorsqu’une réussite partielle vaut mieux qu’un échec total. Voici quelques exemples courants :

  • Traitement par lots dans lequel on s’attend à ce que certains fichiers soient mal formés ou non pris en charge.
  • Pipelines dans lesquels l’extraction des métadonnées est facultative.
  • Importations volumineuses dans lesquelles des fichiers manquants ou temporairement indisponibles ne doivent pas interrompre le traitement de tous les autres fichiers.

Valeurs prises en charge

Tous les Robots prennent en charge meta et execute. Les Robots d’importation prennent également en charge import.

ValeurEffet
(omettre), false ou []Comportement par défaut : ne pas ignorer les erreurs.
trueIgnorer les erreurs de toutes les phases prises en charge par ce Robot.
["meta"]Ignorer les erreurs d’extraction des métadonnées.
["execute"]Ignorer les erreurs d’exécution ou de transcodage.
["meta", "execute"]Ignorer à la fois les erreurs de métadonnées et d’exécution.
["import"]Robots d’importation uniquement : ignorer les erreurs d’importation ou de récupération.
["meta", "import", "execute"]Robots d’importation uniquement : ignorer les erreurs de toutes les phases prises en charge.

Exemples

Ignorez les erreurs d’extraction des métadonnées pour un Step de redimensionnement d’image :

{
  "steps": {
    ":original": {
      "robot": "/upload/handle"
    },
    "resized": {
      "use": ":original",
      "robot": "/image/resize",
      "width": 1200,
      "ignore_errors": ["meta"]
    }
  }
}

Ignorez les erreurs d’importation pour un Step d’importation :

{
  "steps": {
    "imported": {
      "robot": "/s3/import",
      "credentials": "YOUR_S3_CREDENTIALS",
      "path": "/incoming/",
      "ignore_errors": ["import"]
    },
    "encoded": {
      "use": "imported",
      "robot": "/video/encode",
      "preset": "ipad-high"
    }
  }
}

Ignorez les erreurs de toutes les phases prises en charge :

{
  "steps": {
    "imported": {
      "robot": "/http/import",
      "url": "https://example.com/multi-file-feed.json",
      "ignore_errors": true
    }
  }
}

Remarques et bonnes pratiques

  • Utilisez ignore_errors à bon escient. Ce paramètre améliore la résilience, mais peut masquer des problèmes si vous l’utilisez de manière excessive.
  • Préférez des tableaux ciblés (par exemple, uniquement ["meta"]) à true lorsque c’est possible.
  • Surveillez votre Assembly Status pour repérer les échecs ignorés. Les erreurs ignorées sont signalées dans des champs comme ignored_errors et ignored_error_count.
  • Si vous devez continuer à produire des fichiers en cas de problèmes liés aux métadonnées dans certains scénarios d’importation, consultez aussi les options propres à chaque Robot, comme import_on_errors du Robot 🤖/http/import  (English).