Entrega e troca / X5 · CSV

O que um CSV de entrega leva a mais e a menos que um ALE

A planilha detalhada CSV e a lista ALE não são os mesmos dados com outra extensão. O CSV serve à leitura coluna por coluna feita por pessoas e por ferramentas de planilha, enquanto o ALE é uma lista de troca destinada ao fluxo de recebimento que o lê em máquina; os dois diferem no conjunto de valores admissíveis, na escrita dos valores ausentes, na codificação e no sentido dos campos. O CSV traz mais informação de câmera e de filmagem, mas continua sem ser um inventário de mídia e continua sem oferecer mapeamento de canais nem timecode de som.

Quando o formato muda, o que importa não é só “ter mais algumas colunas”, e sim de onde vem cada coluna e para quem ela deve ser conferida.

O que o CSV traz a mais é o detalhe de câmera e de filmagem

Comparado com o ALE, o CSV traz mais informação nas camadas de plano e de câmera. Distância focal, filtro, ISO, abertura, obturador, proporção da imagem, resolução, além de tamanho do plano, ângulo de filmagem e movimento, estão dentro do que esse detalhe tabular consegue expressar.

Ele também escreve alguns sinalizadores de estado, como os estados de câmera de efeitos visuais, prancha, imagem limpa e referência, e leva junto a data de filmagem. Aqui é preciso manter uma fronteira importante: existir uma coluna na tabela de entrega não equivale a dizer que o app tenha hoje uma entrada de registro correspondente no set. Algumas colunas de estado de som aparecem na estrutura do arquivo, mas isso não pode ser apresentado como capacidade de gravação já disponível.

As notas da tomada e as notas da câmera também entram em colunas separadas. Ao gerar o CSV, quebras de linha, retornos de carro e tabulações dentro das notas são achatados em espaços, e por isso não se pode prometer “as notas ficam exatamente como foram escritas”. O que a parte receptora vê é texto já tratado para caber na tabela.

As duas colunas de avaliação não são a mesma coisa

O CSV tem uma coluna de nome de avaliação em texto e uma coluna booleana Circle. O nome em texto é escrito como Circle, Keep, Hold ou N/G; sem marcação, pode ficar vazio. A coluna booleana Circle, por sua vez, escreve TRUE apenas na faixa que corresponde ao texto Circle, e FALSE em todos os outros casos.

Isso significa que, quando o set marca uma tomada como Keep, a coluna de texto escreve abertamente Keep, mas a booleana Circle continua FALSE. Portanto não se pode interpretar a coluna booleana direto como a semântica completa de “esta tomada foi circulada no set”. Ela é apenas um valor booleano derivado de uma condição específica de avaliação.

Ler Rating é ler o nome da avaliação em texto; ler Circle é ler uma condição derivada mais estreita. As duas colunas não se substituem.

É aqui que a parte receptora precisa montar a sua própria correspondência coluna por coluna. Se o seu modelo de planilha olhar só a coluna booleana, vai perder os outros estados que ainda têm sentido no nome de avaliação em texto; e se olhar só a coluna de texto, também não pode presumir que ela seja igual a outros campos internos de estado do app.

O CSV continua sem posição de mídia e sem mapeamento de som

Mais campos não querem dizer que este arquivo tenha assumido toda a informação de vínculo com a mídia. Hoje o CSV não escreve caminho de mídia e não traz mapeamento de canais nem timecode de som. Se a parte receptora precisa saber onde os arquivos de mídia estão de fato e qual canal corresponde a qual origem de som, terá de completar isso a partir da mídia e dos outros registros de passagem.

Do mesmo modo, aparecerem Filename, número do rolo ou identificador do clipe na tabela não transformam o arquivo, por si só, num inventário capaz de localizar toda a mídia. Os campos de identidade precisam ser cruzados com o nome real do arquivo de mídia, com o número do rolo e com o registro do set.

A codificação e as regras de limpeza também diferem do ALE

O CSV é gravado com marca de ordem de bytes, e o ALE não. Os dois usam quebra de linha LF, mas o comportamento do ambiente de recebimento diante de codificação e quebras precisa ser medido na prática. Quando aparecer texto com caracteres trocados ou quando as colunas se deslocarem, confira primeiro codificação, separadores e tratamento de texto, antes de presumir que os campos de conteúdo estão errados.

Cada valor de dado do CSV passa pelo seu próprio caminho de escape. Quebras de linha e tabulações são achatadas; vírgulas e aspas duplas dentro do valor recebem aspas e escape conforme a regra atual. Esse comportamento descreve a forma de geração de hoje, e não deve ser ampliado para uma promessa de conformidade com alguma especificação externa de CSV.

A data também não segue um único critério em todas as entregas

A coluna de data do CSV é escrita num formato de máquina gregoriano fixo, yyyy-MM-dd. A data no cabeçalho de outro tipo de relatório segue, ela sim, o ajuste de formato de data do ambiente do aparelho. Os dois servem a situações de leitura diferentes, e por isso não se pode escrever que “a data em todas as entregas é necessariamente igual byte a byte”.

Se a parte receptora for confrontar arquivos entre si, deve tratar a diferença de formato dos campos de data como condição esperada e só então conferir se eles apontam para o mesmo dia. String diferente não implica necessariamente data diferente, e string igual não substitui a confirmação contra o registro de origem.

FAQ

O que o CSV traz a mais em relação ao ALE?

Principalmente detalhe mais fino de câmera, óptica, composição, estado e data, por exemplo distância focal, filtro, ISO, abertura, obturador, resolução, tamanho do plano, ângulo de filmagem e movimento.

Por que as colunas Rating e Circle podem parecer contraditórias?

Porque não vêm do mesmo sentido de origem. Rating escreve o nome da avaliação em texto, e a booleana Circle escreve TRUE apenas na faixa em que a avaliação é Circle. Uma tomada Keep produz, portanto, Rating=Keep e Circle=FALSE ao mesmo tempo.

O CSV preserva as notas exatamente como foram escritas?

Não caractere por caractere. Quebras de linha, retornos de carro e tabulações são achatados em espaços na geração, e a parte receptora vê o resultado tratado para caber na estrutura de linha da tabela.

Com mais campos, o CSV passa a localizar a mídia e os canais de som?

Não. O arquivo atual continua sem caminho de mídia, sem mapeamento de canais e sem timecode de som. Posição da mídia e relação do som precisam ser conferidas na mídia e em outras informações de passagem.


Axiom One LLC — SlateX. Os números acima são os de 2026-09-24.