Transloadit

El parámetro ignore_errors

El parámetro ignore_errors es compatible con todos los Robots en el nivel de Step. Te permite mantener una Assembly en curso cuando ciertos errores por archivo son aceptables para tu flujo de trabajo.

Por qué puede ser útil

ignore_errors resulta útil cuando un éxito parcial es mejor que un fallo total. Algunos ejemplos comunes:

  • Procesamiento por lotes en el que se espera que algunos archivos tengan un formato incorrecto o no sean compatibles.
  • Flujos de procesamiento en los que la extracción de metadatos es opcional.
  • Importaciones grandes en las que los archivos faltantes o temporalmente no disponibles no deben detener todos los demás archivos.

Valores compatibles

Todos los Robots admiten meta y execute. Los Robots de importación también admiten import.

ValorEfecto
(omitir), false o []Comportamiento predeterminado: no ignorar los errores.
trueIgnorar todas las fases compatibles con ese Robot.
["meta"]Ignorar los errores de extracción de metadatos.
["execute"]Ignorar los errores de ejecución/transcodificación.
["meta", "execute"]Ignorar tanto los errores de metadatos como los de ejecución.
["import"]Solo para Robots de importación: ignorar los errores de importación/obtención.
["meta", "import", "execute"]Solo para Robots de importación: ignorar todas las fases compatibles.

Ejemplos

Ignora los errores de extracción de metadatos en un Step de redimensionamiento de imágenes:

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

Ignora los errores de importación en un Step de importación:

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

Ignora todas las fases compatibles:

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

Notas y prácticas recomendadas

  • Usa ignore_errors de forma intencional. Mejora la resiliencia, pero puede ocultar problemas si se usa en exceso.
  • Cuando sea posible, prefiere arrays específicos (por ejemplo, solo ["meta"]) en lugar de true.
  • Supervisa el Assembly Status para detectar fallos ignorados. Los errores ignorados se informan en campos como ignored_errors y ignored_error_count.
  • Si en algunos escenarios de importación necesitas seguir emitiendo archivos cuando haya problemas relacionados con los metadatos, revisa también las opciones específicas del Robot, como import_on_errors en 🤖/http/import.