Transloadit

Der Parameter ignore_errors

Der Parameter ignore_errors wird von allen Robots auf Step-Ebene unterstützt. Damit kann eine Assembly weiterlaufen, wenn bestimmte Fehler bei einzelnen Dateien für Ihren Workflow akzeptabel sind.

Warum dies nützlich sein kann

ignore_errors ist nützlich, wenn ein Teilerfolg besser als ein vollständiger Fehlschlag ist. Typische Beispiele:

  • Batch-Verarbeitung, bei der einige Dateien erwartungsgemäß fehlerhaft sind oder nicht unterstützt werden.
  • Pipelines, bei denen die Metadatenextraktion optional ist.
  • Große Importe, bei denen fehlende oder vorübergehend nicht verfügbare Dateien nicht alle anderen Dateien stoppen sollen.

Unterstützte Werte

Alle Robots unterstützen meta und execute. Import-Robots unterstützen zusätzlich import.

WertWirkung
(weglassen), false oder []Standardverhalten: Fehler nicht ignorieren.
trueAlle unterstützten Phasen für diesen Robot ignorieren.
["meta"]Fehler bei der Metadatenextraktion ignorieren.
["execute"]Fehler bei der Ausführung oder beim Transcoding ignorieren.
["meta", "execute"]Sowohl Metadaten- als auch Ausführungsfehler ignorieren.
["import"]Nur Import-Robots: Import- oder Abruffehler ignorieren.
["meta", "import", "execute"]Nur Import-Robots: alle unterstützten Phasen ignorieren.

Beispiele

Fehler bei der Metadatenextraktion für einen Step zur Größenänderung von Bildern ignorieren:

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

Importfehler für einen Import-Step ignorieren:

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

Alle unterstützten Phasen ignorieren:

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

Hinweise und Best Practices

  • Setzen Sie ignore_errors gezielt ein. Es erhöht die Ausfallsicherheit, kann bei übermäßiger Verwendung jedoch Probleme verbergen.
  • Verwenden Sie nach Möglichkeit gezielte Arrays, beispielsweise nur ["meta"], statt true.
  • Überwachen Sie den Assembly Status auf ignorierte Fehler. Ignorierte Fehler werden in Feldern wie ignored_errors und ignored_error_count gemeldet.
  • Wenn Dateien bei metadatenbezogenen Problemen in bestimmten Importszenarien dennoch ausgegeben werden sollen, prüfen Sie auch Robot-spezifische Optionen wie import_on_errors für 🤖/http/import.