Transloadit

¿Qué es una Assembly Variable?

Una Assembly Variable de Transloadit es un marcador de posición como ${file.original_basename} que se resuelve durante el procesamiento. Los Robots usan estos valores para adaptar su comportamiento a partir del archivo actual, de los campos enviados o del contexto a nivel de Assembly, como ${assembly.id} y ${unique_prefix}.

Cómo funcionan las Assembly Variables

Las variables son expresiones que se evalúan en función del contexto de ejecución cuando un Robot necesita valores que se desconocen al crear el Template. Sus espacios de nombres exponen atributos de archivos, campos enviados y valores de la Assembly, como identificadores y prefijos únicos, lo que permite que un mismo grafo adapte nombres y opciones para cada entrada. Se diferencian de los parámetros literales porque la expansión ocurre durante la ejecución y puede variar entre archivos. El valor resuelto se incorpora a rutas o ajustes del Robot, por lo que importan su tipo, los caracteres permitidos y el comportamiento cuando falta.

Datos clave

  1. Las variables cuyo ámbito es un archivo pueden resolverse de forma diferente para cada elemento de una misma Assembly, lo que permite asignar nombres según el origen, pero también puede generar colisiones cuando se repiten los nombres base.
  2. Los campos proporcionan a las Instructions datos específicos de cada solicitud sin modificar el Template: pueden llegar como campos de formulario enviados con la subida o definirse mediante programación en el parámetro fields, y los valores enviados mediante el formulario tienen prioridad en caso de conflicto. Siguen siendo datos de entrada no confiables y requieren validación antes de usarse en operaciones sensibles.
  3. Un valor ausente o mal formado puede propagarse a un parámetro de Robot o a una ruta de salida; las integraciones deberían probar el comportamiento de respaldo en lugar de asumir que todos los archivos exponen todos los campos.

Cuándo son importantes las Assembly Variables

Usa variables cuando los nombres de salida o las opciones de Robot deban depender de los datos de cada archivo o solicitud sin recurrir a Instructions separadas. Sanea los valores utilizados en rutas o nombres, porque una entrada inesperada puede generar salidas no válidas o en conflicto.

Convierte tus conocimientos sobre multimedia en un pipeline funcional

Conecta las subidas, el procesamiento, la IA, el almacenamiento y la entrega mediante una sola API declarativa, mientras nos encargamos por ti del stack de encoding, el escalado y los cambios constantes de formatos.

Prueba Transloadit gratis