Fórmulas de avaliação

Onde: menu Acadêmico › Catálogo Acadêmico › Fórmula de Avaliação.

Quem pode usar: perfis administrativos com a permissão "Fórmula de Avaliação" (veja Usuários e permissões).

Para que serve

A fórmula de avaliação é a receita de cálculo da média dos alunos. É ela que define:

• quais notas o professor lança (cada item manual da fórmula vira uma coluna de nota no lançamento — N1, N2, T1...);
• como essas notas viram a média do período (a expressão matemática);
• o que é opcional (recuperação, simulado) e por isso não trava o fechamento do período.

As fórmulas são usadas pela grade curricular: lá você escolhe a fórmula de cada disciplina da série (média do bimestre) e a fórmula da média final do ano. O resultado do cálculo aparece no boletim (Notas e boletim).

A listagem mostra as colunas Nome, Descrição, Fórmula e Ação.

Campos

Dados da fórmula

Campo	O que é	Obrigatório	Observações
Nome	Nome curto da fórmula (ex.: MB, MF)	Sim	Até 5 caracteres, somente letras e números, começando por letra. O nome importa: veja "Qual fórmula vale em cada período" abaixo
Descrição	Texto livre que explica a fórmula (ex.: Média do bimestre)	Sim	Até 50 caracteres
Fórmula	A expressão matemática que calcula a média (ex.: (N1+N2)/2)	Sim	Usa os nomes dos itens como variáveis

Itens da fórmula

Abaixo dos dados fica a tabela de itens. Use o botão de mais para acrescentar linhas, o de menos para remover e arraste pela alça no início da linha para mudar a ordem.

Coluna	O que é	Obrigatório	Observações
Nome	Nome da variável (ex.: N1, N2, R1)	Sim (linhas sem nome são descartadas ao salvar)	Até 5 caracteres, somente letras e números, começando por letra
Descrição	O que é essa avaliação (ex.: Prova mensal)	Não	Até 50 caracteres
Fórmula	Deixe vazio para item manual (nota lançada pelo professor); preencha para criar uma subfórmula (valor calculado)	Não	Veja "Itens manuais e subfórmulas" abaixo
Opcional	Marque quando o lançamento não é obrigatório (ex.: recuperação, simulado)	Não	Item opcional não conta como "nota faltando" no fechamento do período. Só vale para itens manuais — em itens com subfórmula a marcação é ignorada

Itens manuais e subfórmulas

• Item manual (coluna Fórmula vazia): vira uma coluna de nota que o professor preenche no lançamento. A ordem dos itens é a ordem das colunas.
• Item com subfórmula (coluna Fórmula preenchida): é um valor calculado pelo sistema a partir de outros itens — ninguém lança nota nele. As subfórmulas são resolvidas antes da fórmula principal, e o resultado fica disponível pelo nome do item para ser usado na fórmula principal.

Como o sistema calcula

Quando o período é processado (ao fechar a etapa ou recalcular as médias — veja Notas e boletim), o sistema faz, para cada aluno e disciplina:

1. Reúne as notas lançadas no período (N1, N2...) e também as médias já calculadas de períodos anteriores do aluno naquela disciplina — cada uma disponível pelo seu nome de média (ex.: B1, B2).
2. Resolve as subfórmulas e guarda o resultado de cada uma pelo nome do item.
3. Calcula a fórmula principal e grava o resultado como a média do período, com o Nome da Média configurado na etapa (ex.: B1 no 1º bimestre, MF na etapa final).

:::info Regra do sistema Toda variável sem valor entra como 0 (zero). Se o professor ainda não lançou N2, a fórmula (N1+N2)/2 é calculada com N2 = 0 — a média fica temporariamente baixa e sobe quando a nota for lançada e o período for reprocessado. Por isso a média "de verdade" é a do fechamento, com todas as notas lançadas. :::

:::info Regra do sistema Uma fórmula precisa ter pelo menos um item cadastrado para calcular. Uma fórmula sem itens não produz média. :::

Qual fórmula vale em cada período

Na grade curricular, cada disciplina tem a sua fórmula (a do bimestre) e o cabeçalho da grade tem a Fórmula Média Final. A escolha em cada período é feita pelo nome:

:::info Regra do sistema Ao calcular um período, o sistema compara o Nome da Média do período (configurado no cadastro de etapas do ano) com o Nome da Fórmula Média Final da grade. Se forem exatamente iguais (ex.: ambos "MF", respeitando maiúsculas e minúsculas), vale a Fórmula Média Final; em qualquer outro período, vale a fórmula da disciplina. :::

Na prática: nomeie a fórmula de fechamento anual de MF, e configure a etapa final do ano com Nome da Média MF. Nos bimestres (nomes B1, B2...), o sistema usa a fórmula de cada disciplina.

A sintaxe da expressão

• Use os nomes dos itens (e nomes de médias de períodos, como B1) como variáveis.
• Operações confirmadas: soma (+), subtração (-), multiplicação (*), divisão (/) e parênteses para agrupar. Ex.: (N1*2+N2*3)/5.
• Escreva as variáveis exatamente como estão no nome do item (mesmas letras maiúsculas/minúsculas).
• TODO: VALIDATE — se a expressão aceita funções além da aritmética básica (como máximo entre dois valores ou condições do tipo "se"). Enquanto não confirmado, monte fórmulas apenas com as quatro operações e parênteses.

Exemplos completos

1. Média aritmética simples

Fórmula MB — Descrição "Média do bimestre" — Fórmula (N1+N2)/2.

Item	Descrição	Fórmula	Opcional
N1	Prova mensal	(vazio)	Não
N2	Prova bimestral	(vazio)	Não

• Aluno com N1 = 8 e N2 = 6: (8 + 6) / 2 = 7,0.
• Aluno com N1 = 8 e N2 ainda não lançada: (8 + 0) / 2 = 4,0 — sobe quando N2 for lançada e a etapa reprocessada.

2. Média ponderada

Fórmula MB — Fórmula (N1*2+N2*3)/5 (N1 tem peso 2 e N2 tem peso 3).

• Aluno com N1 = 6 e N2 = 8: (6×2 + 8×3) / 5 = (12 + 24) / 5 = 7,2.

3. Prova e trabalho com subfórmula

Fórmula MB — Fórmula MP.

Item	Descrição	Fórmula	Opcional
N1	Prova	(vazio)	Não
T1	Trabalho	(vazio)	Não
MP	Média ponderada 70/30	(N17+T13)/10	Não

• Aluno com N1 = 8 e T1 = 6: MP = (8×7 + 6×3) / 10 = (56 + 18) / 10 = 7,4. A fórmula principal é só MP, então a média do período é 7,4.
• O professor lança apenas N1 e T1; a coluna MP é calculada.

4. Atividade opcional que soma pontos (simulado)

Fórmula MB — Fórmula (N1+N2)/2+SIM/10.

Item	Descrição	Fórmula	Opcional
N1	Prova mensal	(vazio)	Não
N2	Prova bimestral	(vazio)	Não
SIM	Simulado (bônus de até 1 ponto)	(vazio)	Sim

• Aluno com N1 = 6, N2 = 7 e SIM = 8: (6+7)/2 + 8/10 = 6,5 + 0,8 = 7,3.
• Aluno que não fez o simulado: SIM entra como 0 → (6+7)/2 + 0 = 6,5, e a falta do simulado não aparece como pendência no fechamento (item opcional).

Este desenho — opcional que soma — combina bem com a regra do zero: quem não fez, não ganha nem perde. Evite colocar um item opcional dentro de uma divisão (ex.: (N1+N2+R1)/3), porque quem não fizer a atividade teria a média dividida por 3 mesmo assim, com R1 = 0.

5. Média final do ano (MF)

Fórmula MF — Descrição "Média final anual" — Fórmula (B1+B2+B3+B4)/4.

Item	Descrição	Fórmula	Opcional
B1	Média do 1º bimestre	(vazio)	Sim
B2	Média do 2º bimestre	(vazio)	Sim
B3	Média do 3º bimestre	(vazio)	Sim
B4	Média do 4º bimestre	(vazio)	Sim

Como funciona: os nomes B1 a B4 são os Nomes da Média dos quatro bimestres — quando a etapa MF é processada, o sistema busca automaticamente as médias já fechadas de cada bimestre e as usa como valores de B1 a B4 (bimestre ainda não fechado entra como 0). Marcar os itens como opcionais evita que apareçam como "nota faltando", já que ninguém lança nota diretamente neles.

• Aluno com B1 = 7,0, B2 = 6,0, B3 = 8,0 e B4 = 7,0: (7+6+8+7)/4 = 7,0.

Para essa fórmula valer no fechamento anual, escolha-a como Fórmula Média Final na grade curricular da série e confira que a etapa final do ano tem Nome da Média MF.

Passo a passo

Cadastrar a fórmula do bimestre

1. Abra Acadêmico › Catálogo Acadêmico › Fórmula de Avaliação e clique em NOVO.
2. Preencha Nome (ex.: MB) e Descrição.
3. Na tabela de itens, crie uma linha para cada nota que o professor vai lançar (N1, N2...), com descrição. Marque Opcional nas avaliações que não devem travar o fechamento.
4. Se precisar de valores intermediários calculados, crie itens com subfórmula.
5. Escreva a Fórmula principal usando os nomes dos itens (ex.: (N1+N2)/2).
6. Arraste as linhas para deixar os itens na ordem em que devem aparecer no lançamento de notas.
7. Clique em Salvar.
8. Vá à grade curricular e escolha esta fórmula nas disciplinas que a usam.

Cadastrar a fórmula da média final

1. Crie uma fórmula com Nome exatamente igual ao Nome da Média da etapa final do ano (normalmente MF).
2. Cadastre como itens (opcionais) os nomes das médias dos períodos (B1, B2, B3, B4).
3. Escreva a fórmula final (ex.: (B1+B2+B3+B4)/4).
4. Na grade curricular de cada série, selecione-a no campo Fórmula Média Final.

Problemas comuns

• "Nome deve ter somente letras e números e iniciar com pelo menos uma letra." O nome (da fórmula e dos itens) aceita só letras e números, começando por letra, com até 5 caracteres. Atenção: o dígito 0 (zero) não é aceito no nome — use N1 a N9 ou acrescente uma letra (ex.: NA, NB) se precisar de mais itens.
• A média final do ano saiu igual à do bimestre. O Nome da Média da etapa final não bate com o Nome da Fórmula Média Final da grade (a comparação é exata, incluindo maiúsculas). Corrija um dos dois para ficarem idênticos.
• A média do aluno está baixa demais. Provavelmente falta lançar alguma nota — toda variável sem valor entra como 0. Complete o lançamento e reprocesse a etapa.
• Marquei um item com subfórmula como opcional e a marcação sumiu. É o comportamento esperado: opcional só faz sentido em item manual; ao salvar, o sistema desmarca a opção em itens que têm subfórmula.
• Mudei a fórmula no meio do ano. A mudança vale para o próximo processamento de médias — as colunas de lançamento e o cálculo passam a seguir a nova receita. Notas já lançadas em itens que deixaram de existir saem do cálculo. Prefira mudar fórmulas na virada de período.