Pular para o conteúdo principal

Ele me devolverá o arquivo?

Importing from FET 6 min de leitura

Seu arquivo .fet é um termo de trabalho, portanto, antes de enviá-lo a qualquer ferramenta, há uma pergunta que vale a pena fazer e um teste de dois minutos que a responde.

Um arquivo .fet não parece muita coisa. Algumas centenas de kilobytes de XML, guardados em uma pasta ao lado do arquivo do ano passado.

Mas você sabe o que foi investido nele. A quinzena em agosto gasta calculando que o bloco de ciências não pode comportar duas aulas práticas ao mesmo tempo. O compromisso com o coordenador de idiomas que levou três conversas. As onze restrições que você adicionou uma a uma, cada uma depois que algo deu errado e que você nunca mais quer ver acontecer.

Nada disso está escrito em qualquer outro lugar. Existe como restrições naquele arquivo, e se ele for perdido, você não perde apenas um documento — você perde o raciocínio, e descobre isso em setembro quando o Grade deixa de fazer sentido.

Portanto, quando uma ferramenta web oferece abri-lo, a questão não é se a ferramenta é útil. É: ela vai me devolver meu arquivo?

Por que a resposta geralmente é "nem tanto"

A maioria das ferramentas que lê um .fet faz isso da maneira óbvia. Alguém analisa o formato, escreve código para as partes de que precisa — docentes, disciplinas, salas, atividades, as restrições comuns — e publica.

Isso funciona, e falha silenciosamente. O FET tem um grande vocabulário de restrições e ele cresce a cada versão. Qualquer coisa que o autor da ferramenta não implementou simplesmente não é lida, e quando o arquivo é salvo novamente, o que nunca foi lido não é gravado. O arquivo ainda abre. Ele ainda é válido. Ele apenas está sem as três restrições com as quais você mais se importava, e nada em lugar nenhum avisou sobre isso.

Essa é a falha contra a qual vale a pena projetar, porque ela é invisível exatamente no momento em que você gostaria de detectá-la.

O que fazemos em vez disso

O FET Explorer não tenta entender cada restrição. Ele tenta não precisar disso.

Quando um arquivo é lido, cada restrição nele é armazenada pelo seu próprio nome, com seu conteúdo mantido como está — independentemente de este aplicativo ter ou não ideia do que aquela restrição significa. Quando você faz o download, cada uma é gravada novamente sob o mesmo nome, com o mesmo conteúdo, na mesma ordem.

Não existe uma lista de tipos de restrição suportados, porque não há nada para suportar. Um tipo de restrição introduzido em uma versão do FET da qual nunca ouvimos falar viaja intacto, pela mesma razão que uma palavra que você não conhece sobrevive ao ser copiada à mão.

Nos Grades que estão em nosso próprio corpus hoje, isso representa 2.987 restrições em 20 tipos diferentes, indo e voltando sem que nenhuma delas seja um caso especial no código de exportação.

Pesos voltam como pesos. Uma restrição definida em 80% ainda é 80% — não arredondada, não rederivada, não promovida para "ligada". Uma restrição inativa volta inativa. Seus comentários voltam.

O arquivo é verificado antes de você recebê-lo

Existe uma coisa pela qual iremos interromper.

Um .fet que o FET se recusa a abrir é pior do que nenhum arquivo: você descobre no final do processo, sem nenhuma pista de qual dos vários milhares de registros é o culpado. Por isso, o arquivo é construído e inspecionado antes de ser entregue.

A linha de download, com o sub-rótulo de verificação abaixo dela
A linha de download, com o sub-rótulo de verificação abaixo dela

Se algo genuinamente necessário estiver faltando — uma atividade sem disciplina, uma aula apontando para um docente que não está na lista de docentes — você será avisado, com os registros reais nomeados. Coisas que podem ser definidas com segurança como padrão são definidas e nunca se tornam seu problema.

Se o arquivo for válido, mas parecer incompleto, você recebe um aviso e um botão Baixar mesmo assim. Isso é um conselho, não um bloqueio.

E se a própria verificação falhar ao ser executada, o download simplesmente prossegue. Uma verificação que não produziu uma opinião não é motivo para ficar entre você e seu próprio arquivo.

Não acredite apenas na nossa palavra — leve dois minutos

Esta é a parte que realmente vale a pena fazer, porque não custa quase nada e resolve a questão permanentemente.

  1. Envie seu arquivo .fet.
  2. Baixe-o novamente imediatamente, antes de alterar qualquer coisa.
  3. Compare os dois arquivos.
O mecanismo de ida e volta relatando que todas as verificações estão verdes: o que foi exportado corresponde ao que foi importado.
O mecanismo de ida e volta relatando que todas as verificações estão verdes: o que foi exportado corresponde ao que foi importado.

Eles devem diferir na formatação — recuo, espaçamento de atributos, a ordem de alguns campos opcionais — e em nada mais. Mesmas atividades, mesmas restrições, mesmos pesos, mesmos comentários.

Se os dois arquivos diferirem em substância, isso é um erro e queremos saber sobre ele. Não é algo para se contornar, e não é algo que você deveria descobrir em setembro.

Uma exceção honesta

Se o seu Grade foi construído a partir de planilhas em vez de um .fet, há um detalhe que vale a pena saber. Linhas CSV não carregam identificadores de atividade do FET, e restrições de posicionamento precisam de IDs estáveis para apontar para aulas individuais.

Em vez de recusar, nós atribuímos esses identificadores ao construir o arquivo — e os armazenamos, para que não mudem. Um segundo download corresponde ao primeiro. Você pode construir um Grade a partir de planilhas e ainda obter um .fet coerente do outro lado.

O que isto não é

O FET Explorer não gera Grades. Ele não otimiza, não resolve novamente, nem melhora o que o FET produziu. O FET faz a parte difícil; este aplicativo lê, apresenta, compartilha e edita o resultado.

O que é exatamente o motivo pelo qual a ida e volta importa. Uma ferramenta que apenas mostra um Grade pode se dar ao luxo de entender metade do arquivo. Uma ferramenta na qual você pode editar precisa devolver tudo.

Experimente com seu próprio arquivo →