Resolução de Problemas de Upload, Conclusão e Pontuação do SCORM

Se seu pacote SCORM não carregar, não marcar como concluído ou não registrar uma pontuação, este artigo explica as causas mais comuns e como corrigi-las.

Problema 1: Falha no Upload do SCORM

Sintomas

• O arquivo .zip é rejeitado ou falha durante o upload
• O processo de upload apresenta erro sem motivo claro (mensagem na tela: Oops, algo deu errado. Por favor, tente novamente mais tarde.)

Causa

Isso é geralmente causado por uma de duas coisas:

1. O pacote contém um tipo de arquivo que não é permitido (por exemplo, um arquivo SVG).
2. O pacote está compactado incorretamente — os arquivos principais do SCORM (incluindo imsmanifest.xml) estão dentro de uma subpasta em vez de na raiz do arquivo zip.

Solução

Opção 1: Verifique tipos de arquivos não suportados Abra o zip do SCORM e remova ou converta quaisquer formatos de arquivo não suportados (ex.: imagens SVG) antes de fazer o upload novamente.

Opção 2: Verifique a estrutura do arquivo zip Certifique-se de que imsmanifest.xml e os outros arquivos principais do SCORM estejam no nível superior do zip — não dentro de uma pasta. Se estiverem dentro de uma pasta:

1. Abra o arquivo zip.
2. Mova todos os arquivos e pastas da subpasta interna para o nível raiz.
3. Recompacte o conteúdo para que imsmanifest.xml fique visível imediatamente ao abrir o zip.
4. Faça o upload novamente do pacote corrigido.

Problema 2: SCORM Não Está Sendo Marcado como Concluído

Sintomas

• Os alunos terminam o conteúdo, mas ele nunca aparece como "concluído" nos relatórios

Causa

Ou o SCORM não está enviando o status de conclusão para a plataforma, ou os próprios requisitos internos de conclusão do SCORM não estão sendo cumpridos pelo aluno (por exemplo, uma interação obrigatória dentro do SCORM não está sendo acionada).

Solução

• Confirme que o SCORM está configurado para enviar cmi.core.lesson_status (SCORM 1.2) ou cmi.completion_status (SCORM 2004) assim que seus objetivos forem alcançados.
• Verifique com o autor do SCORM ou a ferramenta de autoria se o gatilho de conclusão dentro do conteúdo realmente pode ser alcançado pelos alunos.
• Teste o SCORM você mesmo, completando todas as etapas necessárias, e confirme se o status é atualizado conforme esperado.

Problema 3: SCORM Não Está Registrando uma Pontuação

Sintomas

• O SCORM é concluído, mas nenhuma pontuação aparece nos relatórios

Causa

O SCORM não está enviando um dos parâmetros obrigatórios de pontuação. Dependendo da versão do SCORM, todos os parâmetros de pontuação aplicáveis são obrigatórios para que uma pontuação seja registrada (veja as tabelas de parâmetros em nosso artigo Visão Geral do SCORM).

Solução

• Verifique se o SCORM envia cmi.core.score.raw (e cmi.score.scaled para SCORM 2004), junto com cmi.core.score.max e cmi.core.score.min.
• Se você não for o autor do SCORM, consulte sua ferramenta de autoria ou fornecedor de conteúdo para confirmar que esses parâmetros estão sendo enviados.

Problema 4: SCORM Conclui Mas Nunca Registra uma Pontuação

Sintomas

• O conteúdo aparece como concluído, mas uma pontuação nunca é registrada — mesmo que o SCORM inclua atividades com pontuação

Causa

Isso geralmente ocorre quando o SCORM envia o status "concluído" muito cedo — frequentemente logo no início do conteúdo. Uma vez que "concluído" é enviado, a plataforma para de registrar quaisquer dados adicionais para esse SCORM, incluindo pontuações que viriam depois.

Solução

• Verifique a lógica interna do SCORM (com o autor ou a ferramenta de autoria) para confirmar que "concluído" só é enviado após todas as atividades com pontuação serem finalizadas.
• Se o SCORM precisar ser reconfigurado, republicá-lo para que o status de conclusão seja enviado por último, depois faça o upload novamente e teste.

Prevenção

Para evitar esses problemas no futuro:

• Siga as configurações recomendadas antes de empacotar um SCORM (16:9 paisagem, layout responsivo, conclusão enviada somente após todos os objetivos/pontuações serem concluídos).
• Sempre confirme que imsmanifest.xml está na raiz do zip antes de fazer o upload.
• Teste novos pacotes SCORM em um curso de teste/ambiente de homologação antes de disponibilizá-los aos alunos.

Ainda Está Com Problemas?

Se você verificou os itens acima e o problema persistir, entre em contato com nossa equipe de suporte com:

• A versão do SCORM (1.2 ou 2004)
• O arquivo zip (ou um link para ele)
• Uma captura de tela do relatório mostrando o problema

Artigos Relacionados

• Visão Geral do SCORM: Versões Suportadas, Parâmetros e Configurações Recomendadas