Entrega e intercambio / X5 · CSV

Qué lleva un archivo de entrega CSV que el ALE no, y qué deja de llevar

La tabla de detalle CSV y la lista ALE no son los mismos datos con otra extensión. El CSV está pensado para que una persona y una herramienta de tabla lean columna por columna, y el ALE es una lista de intercambio que lee un flujo de recepción; los dos difieren en el rango de valores, en la manera de escribir la ausencia, en la codificación y en la semántica de los campos. El CSV saca más parámetros de cámara y de rodaje, pero sigue sin ser una lista de medios y no aporta asignación de canales ni código de tiempo del sonido.

Cuando cambia el formato, lo importante no es solo “cuántas columnas más”, sino de dónde sale cada columna y para quién se escribió.

Lo que el CSV lleva de más son los detalles de cámara y de rodaje

Frente al ALE, el CSV saca más información de plano y de cámara: distancia focal, filtro, ISO, apertura, obturador, relación de aspecto y resolución, además de datos de composición como el tamaño de plano, el ángulo y el movimiento. Todo eso entra dentro de lo que esta tabla de detalle puede expresar.

También escribe varios indicadores de estado, entre ellos condiciones de cámara como VFX, placa, plano limpio y referencia, y agrega la fecha de rodaje. Acá hay que conservar una frontera importante: que en la tabla de entrega exista una columna no prueba que hoy la app tenga una entrada de registro en el set para ese campo. Algunas columnas de estado del sonido aparecen en la estructura del archivo, pero eso no se puede presentar como una capacidad que ya se pueda registrar.

Las notas de la toma y las notas de la cámara también entran por columnas separadas. Al generar el CSV, los saltos de línea, los retornos y las tabulaciones que haya dentro de una nota se convierten en espacios, así que no se puede prometer que “las notas se conservan tal cual”. Lo que ve quien recibe es un texto ya pasado por el procesamiento de la tabla.

Las dos columnas de clasificación no son la misma cosa

En el CSV hay una columna con el texto de la clasificación y otra columna booleana, Circle. El texto de la clasificación se escribe como Circle, Keep, Hold o N/G, y cuando no hay marca puede quedar vacío. La columna booleana Circle, en cambio, escribe TRUE solo en el caso en que el texto de la clasificación corresponde a Circle, y en cualquier otra situación escribe FALSE.

Eso significa que, si en el set una toma se marca como Keep, la columna del texto de la clasificación escribe Keep sin ambigüedad, pero la Circle booleana sigue quedando en FALSE. Por eso la columna booleana no se puede interpretar tal cual con toda la semántica de “si esta toma fue marcada con círculo en el set”. Es apenas un valor booleano derivado de una condición de clasificación concreta.

Leer Rating es leer el texto de la clasificación; leer Circle es leer una condición derivada más angosta. Las dos columnas no se sustituyen entre sí.

Acá es justamente donde quien recibe tiene que armar su mapeo columna por columna. Si su propia plantilla de tabla mira solo la columna booleana, va a perder otros estados que el texto de la clasificación todavía expresa; y si mira solo la columna de texto, tampoco puede suponer que equivale a otros campos de estado internos de la app.

El CSV tampoco tiene la ubicación de los medios ni la asignación del sonido

Que haya más campos no significa que este archivo asuma toda la información de asociación con los medios. Hoy el CSV no escribe rutas de los archivos de medios y no tiene asignación de canales ni código de tiempo del sonido. Si quien recibe necesita saber dónde está realmente cada archivo o qué canal corresponde a qué fuente de sonido, tiene que completarlo con el material y con los demás registros de la entrega.

Del mismo modo, que en la tabla aparezcan Filename, el número de rollo o el número de clip no convierte al archivo, automáticamente y por sí solo, en una lista capaz de ubicar todos los medios. Los campos de identidad hay que cruzarlos con los nombres reales de los archivos de medios, con los números de rollo y con el registro del set.

La codificación y las reglas de limpieza tampoco coinciden con las del ALE

Al escribirse, el CSV lleva marca de orden de bytes y el ALE no. Los dos usan saltos LF, pero la manera como el entorno receptor trata la codificación y los saltos necesita medirse de hecho. Si el texto sale con caracteres corruptos o las columnas se desplazan, conviene revisar primero la codificación, los separadores y la limpieza del texto, sin suponer que el contenido de los campos está mal.

Cada valor de dato del CSV pasa por su propia ruta de escapado: los saltos de línea y las tabulaciones se aplanan, y cuando un valor contiene comas o comillas se le agregan comillas y se escapa según la regla vigente. Esa conducta corresponde a la forma de generación actual, pero no se puede ampliar hasta volverla una promesa de cumplimiento de alguna norma externa de CSV.

La fecha tampoco se escribe igual en todos los productos

La columna de fecha del CSV se escribe fija en el formato de máquina del calendario gregoriano yyyy-MM-dd. La fecha del encabezado de otro tipo de informe, en cambio, sigue la configuración de formato de fecha del entorno del dispositivo. Los dos sirven a lecturas distintas, así que no se puede escribir que “la fecha de todos los productos de entrega tiene forzosamente los mismos caracteres”.

Si quien recibe tiene que cotejar archivos entre sí, debe tomar primero la diferencia de formato en los campos de fecha como una condición esperada y después revisar si apuntan al mismo día. Que dos cadenas sean distintas no implica forzosamente que la fecha sea otra, y que sean iguales tampoco sustituye la confirmación contra el registro de origen.

FAQ

¿Qué es lo principal que el CSV lleva de más frente al ALE?

Sobre todo un detalle más fino de cámara, óptica, composición, estado y fecha: distancia focal, filtro, ISO, apertura, obturador, resolución, tamaño de plano, ángulo y movimiento, entre otros.

¿Por qué las columnas Rating y Circle pueden parecer contradictorias?

Porque no comparten la misma semántica de origen. Rating escribe el texto de la clasificación, y la Circle booleana escribe TRUE solo en el caso en que el texto de la clasificación corresponde a Circle. Una toma Keep sale entonces a la vez con Rating=Keep y Circle=FALSE.

¿El CSV conserva las notas tal cual?

No las conserva carácter por carácter. Los saltos de línea, los retornos y las tabulaciones se convierten en espacios al generar el archivo, así que lo que ve quien recibe es un resultado ya adaptado a la estructura de filas de la tabla.

Con tantos campos más, ¿el CSV ya permite encontrar los medios y los canales de sonido?

No. El archivo actual sigue sin incluir rutas de los medios, asignación de canales ni código de tiempo del sonido. La ubicación de los medios y la relación con el sonido hay que cotejarla con el material y con la demás información de la entrega.


Axiom One LLC — SlateX. Las cifras de arriba son a fecha de 2026-09-24.