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

O CSV do SlateX traz uma linha por câmera, e uma tomada sem câmera também gera uma linha; o cabeçalho e a ordem das colunas são fixos, e novas colunas só podem ser acrescentadas ao fim da ordem existente, sem reordenar as atuais. Rating, Circle e Circled On Set parecem descrever a mesma decisão do set, mas os três derivam do mesmo valor de avaliação, com regras diferentes, então um mesmo registro pode produzir uma combinação que parece não bater.

Rating, Circle e Circled On Set derivam todos do mesmo valor de avaliação, apenas com regras diferentes; não devem ser tratados como três estados independentes do 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

A célula de Rating entrega texto: um dos quatro níveis Circle, Keep, Hold e N/G, e fica vazia quando a tomada não recebeu avaliação; a coluna Circle ao lado não é um registro separado da circulação no set, mas escreve TRUE apenas quando a avaliação em si é Circle. Esses textos de entrega são constantes em inglês e não mudam 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ó é verdadeiro para a avaliação Circle

A coluna Circle usa uma regra estreita: escreve TRUE apenas quando o valor de avaliação corresponde a Circle; uma tomada sem marcação, Keep, Hold e N/G escrevem FALSE e não ficam vazias. Não é um segundo julgamento do set.

Circled On Set usa uma regra de derivação mais ampla

Circled On Set também deriva desse mesmo valor de avaliação, mas trata tanto Circle quanto Keep como marcadas em círculo no set e escreve TRUE para esses dois níveis; os demais escrevem FALSE. Por isso uma tomada Keep produz Rating=Keep, Circle=FALSE e Circled On Set=TRUE. Não são três estados de set que se contradizem, mas um mesmo valor de avaliação exportado por três regras diferentes.

As três colunas são três derivações do mesmo valor de avaliação

Rating converte o número da avaliação em texto fixo em inglês; Circle é verdadeiro apenas para a avaliação Circle; Circled On Set é verdadeiro para Circle e Keep. As três derivam do mesmo valor de avaliação, com regras diferentes. Por isso a parte receptora não deve tratá-las como fontes independentes que se validam entre si nem substituir uma coluna por outra.

Uma tomada Keep pode apresentar ao mesmo tempo Rating=Keep, Circle=FALSE e Circled On Set=TRUE; é o mesmo valor de avaliação passado por três regras de derivação.

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 ramo de valor vazio: TRUE aparece apenas na avaliação Circle, e todos os demais casos escrevem FALSE.

Por que Keep produz Circle=FALSE?

Porque Circle só responde se o nível de avaliação daquela tomada é o nível Circle; Keep é outro nível e, por isso, escreve FALSE — mesmo que a coluna Circled On Set escreva TRUE para ela.

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

Não deve ser interpretado assim. Circle é verdadeiro apenas para a avaliação Circle; Circled On Set abrange Circle e Keep, mas são apenas duas regras diferentes sobre o mesmo valor de avaliação. Verifique o significado das três colunas com suas próprias regras de importação.

Axiom One LLC — SlateX