Por que o CSV tem as colunas Rating e Circle e por que as duas podem se contradizer

O CSV do SlateX é uma linha por câmera, e uma tomada sem câmera também gera uma linha; o cabeçalho e a ordem das colunas estão hoje fixados, e só é possível acrescentar colunas depois da ordem existente, sem reordenar as colunas que já estão lá. Rating e Circle parecem descrever o mesmo julgamento feito no set, mas não são dois caminhos de estado do set: as duas colunas são derivadas do valor numérico da avaliação, e as condições de derivação são diferentes, então um mesmo registro pode produzir nas duas colunas resultados que parecem inconsistentes entre si.

Rating e Circle são campos de entrega derivados do valor numérico da avaliação; não se deve tratá-los como dois registros independentes da marcação em círculo feita no set.

A forma das linhas do CSV primeiro se expande por câmera

Se uma tomada tem várias câmeras, o CSV a expande em uma linha de dados correspondente para cada câmera; se essa tomada não tem câmera, ainda assim sai uma linha, só que as colunas relacionadas à câmera não compartilham uma única forma de valor ausente: algumas ficam em branco e outras caem no valor padrão, então a parte receptora deve conferir coluna por coluna. O cabeçalho usa nomes de coluna fixos em inglês, e a ordem das colunas também é definida por constante, sem acompanhar a troca do idioma da interface do app.

Isso é coerente com o critério de “O que um CSV de entrega leva a mais e a menos que um ALE”: a estrutura de campos do CSV precisa ser conferida no próprio arquivo, e não inferida de outro tipo de arquivo de entrega que talvez leve um conjunto diferente de colunas.

Rating converte o valor numérico da avaliação em texto fixo em inglês

O mapeamento do Rating é fixo: o valor 4 escreve Circle, 3 escreve Keep, 2 escreve Hold, 1 escreve N/G, e, quando a tomada não tem avaliação marcada, escreve string vazia. Esse conjunto de textos de entrega é constante em inglês e não muda com o idioma da interface.

Portanto, Rating é “o resultado textual do valor numérico da avaliação”, e não uma segunda leitura de um estado do set. Uma interface em chinês, em inglês ou em qualquer outro idioma pode ter seus próprios textos de exibição, mas aqui, no CSV, a saída continua sendo as palavras fixas em inglês.

Circle só verifica se a tomada está no 4º nível de avaliação

A regra do Circle é mais estreita: só quando o valor numérico da avaliação é igual a 4 ele escreve TRUE, e em todos os outros casos escreve FALSE. Essa coluna não tem ramificação de valor vazio, então uma tomada sem avaliação marcada, Keep, Hold e N/G recebem todas um valor falso explícito, e não uma célula em branco.

Aí aparece a contradição anunciada no título. Quando o set marca uma tomada como Keep, existe ainda um sinalizador interno de marcação em círculo que, em alguns caminhos de escrita, também é ajustado como verdadeiro; mas o Circle do CSV não lê esse sinalizador: ele só verifica se a avaliação é igual a 4. Por isso essa tomada sai, no CSV, com Rating=Keep e Circle=FALSE.

Nenhuma das duas colunas lê o estado do set ou o sinalizador de marcação em círculo

Rating e Circle não leem o texto de estado do set nem aquele sinalizador interno de marcação em círculo. Elas apenas passam o mesmo número de avaliação por duas regras de derivação diferentes. Portanto, a parte receptora não pode interpretar a coluna Circle como o registro direto de “esta tomada foi marcada em círculo no set”, nem tratar as duas colunas como fontes independentes que se validam entre si.

A única conclusão que se pode tirar é que a avaliação tem formas visíveis diferentes em cada artefato de entrega, e aqui estão apenas as origens das duas colunas do CSV. Nenhuma das duas carrega aquele sinalizador interno, então não dá para reconstituir a marcação em círculo do set a partir de Circle, e também não se pode dizer, em sentido contrário, que o estado do set percorre a entrega inteiro junto com o CSV.

Uma tomada Keep pode produzir ao mesmo tempo Rating=Keep e Circle=FALSE; isso vem de duas condições de derivação diferentes, e não de dois estados do set que se negam um ao outro.

O CSV ainda tem dois limites de forma que precisam ser vistos juntos

O cabeçalho é montado pela concatenação direta das constantes, sem passar por escape de campos; dentro dos campos de dados, quebras de linha e tabulações são antes achatadas em espaços, em vez de conservar a quebra de linha dentro de um campo entre aspas. Por isso, não se pode resumir essa saída como “compatível com RFC4180”. O que se descreve aqui é a forma atual de geração; não se julga, em nome de qualquer planilha ou sistema de edição a jusante, como ele vai interpretar o arquivo.

Os nomes de coluna também são constantes fixas em inglês e não acompanham a troca de idioma do app. O princípio de recebimento enfatizado em “De onde vem o valor de cada coluna do ALE” e em “Ao receber uma ALE, confira estes campos” vale igualmente aqui: a parte receptora deve conferir, contra o seu próprio modelo de importação, os nomes literais das colunas, as formas dos valores e as origens.

FAQ

O Rating muda conforme o idioma da interface?

Não muda. Os textos de avaliação do CSV são constantes fixas em inglês, e, quando a tomada não tem avaliação marcada, Rating escreve string vazia.

Um Circle vazio quer dizer que não houve marcação em círculo?

Circle não tem ramificação de valor vazio. Avaliação igual a 4 escreve TRUE, e todos os outros casos escrevem FALSE.

Por que Keep produz Circle=FALSE?

Porque Circle só verifica se a avaliação é igual a 4; Keep corresponde a outro nível de avaliação e, por isso, escreve FALSE, ainda que aquele sinalizador interno de marcação em círculo seja ajustado como verdadeiro nos caminhos de escrita.

Dá para tratar Circle como o estado de marcação em círculo do set?

Não se deve interpretá-lo assim. Ele é derivado só da condição “a tomada está no 4º nível de avaliação”; a parte receptora deve conferir o seu sentido junto com Rating e com as próprias regras de importação.

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