Este manual define as especificações técnicas e as melhores práticas para a criação de pacotes SCORM, garantindo a máxima compatibilidade e o rastreamento de dados preciso no Smartleader LMS. Este documento serve como referência técnica para autores de conteúdo, desenvolvedores e fornecedores.
1. Suporte e Padrões de Compatibilidade
O Smartleader LMS é uma plataforma de aprendizado totalmente compatível com os principais padrões da indústria.
1.1 Versões SCORM Suportadas
O Smartleader oferece suporte completo às seguintes versões:
- SCORM 1.2: Implementação total do modelo de dados CMI (Computer Managed Instruction) e funções da API.
- SCORM 2004 (2nd, 3rd, e 4th Edition): Suporte completo ao modelo de dados CMI e às regras de Sequenciamento e Navegação (SN).
1.2 Ferramentas de Autoria e Metodologia
Nossa plataforma foi testada e validada para funcionar perfeitamente com os líderes de mercado, garantindo a integridade dos dados.
| Ferramenta | Compatibilidade | Recomendação de Exportação |
| Articulate Rise | 100% Validada | SCORM 1.2 ou SCORM 2004 (4th Edition) |
| iSpring | 100% Validada | SCORM 1.2 ou SCORM 2004 |
| Articulate Storyline | Compatível (com as configurações SCORM adequadas) | SCORM 2004 (4th Edition) para rastreamento mais granular |
2. Estrutura e Conteúdo do Pacote
O pacote SCORM deve ser um arquivo ZIP que contenha a estrutura e o manifesto conforme especificado abaixo.
2.1 Estrutura de Diretórios
O Smartleader é flexível, aceitando o imsmanifest.xml na raiz ou dentro de um diretório:
| Estrutura | Descrição |
| Padrão | imsmanifest.xml e todo o conteúdo (SCOs e Assets) no subdiretório scormcontent/. |
| Alternativa | imsmanifest.xml e todo o conteúdo diretamente na raiz do arquivo ZIP. |
2.2 O Arquivo imsmanifest.xml (Content Packaging)
Este arquivo é obrigatório e define a estrutura, metadados e o ponto de lançamento do conteúdo.
| Elemento Chave | Uso no Smartleader | Requisito Mínimo |
| identifier | Usado como ID de rastreamento do curso. | Deve ser único. Recomendamos mantê-lo constante em futuras atualizações para reter o histórico do usuário. |
| <organization> | Define a estrutura navegacional do curso. | Deve ter um atributo default referenciando uma organização. |
| <item> | Define a atividade de aprendizado (SCO). | O atributo identifierref deve apontar para o <resource> principal. |
| <resource> | Define o ativo físico do conteúdo. | O atributo href deve conter o caminho e nome exato do arquivo de entrada (ex: index.html). |
| adlcp:masteryscore | (Opcional, mas recomendado) Define a nota mínima para aprovação no LMS. | Usado para determinar automaticamente o success_status se a ferramenta não o fizer. |
3. Comunicação em Tempo de Execução (Run-Time)
A comunicação é estabelecida via JavaScript, onde o conteúdo (SCO) interage com a API do Smartleader.
3.1 Funções Essenciais da API
Seu SCO deve invocar estas funções para garantir o ciclo de vida da sessão:
| Função SCORM 1.2 | Função SCORM 2004 | Finalidade |
| LMSInitialize("") | Initialize("") | Inicia a sessão. Deve ser a primeira chamada. Carrega dados salvos (suspend_data, lesson_location). |
| LMSCommit("") | Commit("") | Salva o estado atual. Deve ser chamada periodicamente (ex: a cada 30-60 segundos ou após interações críticas) para persistir o progresso. |
| LMSFinish("") | Terminate("") | Encerra a sessão. Deve ser a última chamada ao sair do curso. |
| LMSGetValue(element) | GetValue(element) | Lê dados do LMS (ex: nome do aluno, dados de retomada). |
| LMSSetValue(element, value) | SetValue(element, value) | Escreve dados para o LMS (ex: status, pontuação). |
3.2 Variáveis CMI (Modelo de Dados)
O Smartleader monitora e armazena os seguintes elementos CMI:
Rastreamento de Progresso e Retomada
| Elemento SCORM 1.2 | Elemento SCORM 2004 | Descrição e Requisito |
| cmi.core.lesson_location | cmi.location | Bookmark/Posição. Usado para salvar a última posição do usuário para que a retomada seja precisa. |
| cmi.suspend_data | cmi.suspend_data | Dados Internos. String (geralmente JSON) contendo o estado interno do curso. |
| cmi.core.total_time | cmi.total_time | Tempo Acumulado. Tempo total gasto em todas as sessões. |
| cmi.core.session_time | cmi.session_time | Tempo da Sessão. Duração da sessão atual, usada para calcular o total_time. |
Limitação do suspend_data
O campo cmi.suspend_data possui um limite de 64.000 caracteres em ambas as versões SCORM (1.2 e 2004). Pacotes que excedem este limite podem falhar ao salvar o progresso.
Dados de Avaliação e Status
| Elemento SCORM 1.2 | Elemento SCORM 2004 | Descrição e Valores Aceitos |
| cmi.core.lesson_status | cmi.completion_status | Conclusão. Status do curso: "completed", "incomplete", "not attempted". |
| cmi.core.lesson_status | cmi.success_status | Aprovação. Status de aprovação: "passed", "failed", "unknown". |
| cmi.core.score.raw | cmi.score.raw | Pontuação Bruta. Valor numérico (normalmente entre 0 e 100) da nota do quiz. |
| cmi.core.score.max | cmi.score.max | Pontuação Máxima. O Smartleader o utiliza para normalizar a pontuação, se necessário. |
4. Melhores Práticas de Exportação
A exportação correta do seu conteúdo é crucial para o rastreamento no Smartleader.
4.1 Configurações de Status e Tracking
| Cenário | SCORM 1.2 (cmi.core.lesson_status) | SCORM 2004 (cmi.completion_status e cmi.success_status) |
| Aprovado/Concluído | "passed" ou "completed" | "completed" E "passed" |
| Reprovado/Falhou | "failed" | "completed" E "failed" |
| Em Progresso | "incomplete" | "incomplete" E "unknown" (ou não defina success_status) |
5. Checklist de Validação Técnica
Use este checklist antes de importar qualquer pacote para o Smartleader.
| Categoria | Item de Validação | Detalhe Técnico |
| Pacote | [ ] Arquivo é um ZIP válido. | O arquivo não deve estar corrompido. |
| Estrutura | [ ] imsmanifest.xml localizado. | Deve estar na raiz ou em scormcontent/. |
| Manifesto | [ ] Ponto de entrada (href) correto. | O caminho do arquivo de lançamento (index.html ou similar) deve estar correto. |
| Inicialização | [ ] Chamada a LMSInitialize(). | Deve ser a primeira chamada da API. |
| Persistência | [ ] Chamada a LMSCommit(). | Deve ser chamada periodicamente para salvar progresso incremental. |
| Encerramento | [ ] Chamada a LMSFinish(). | Deve ser a última chamada ao fechar o curso. |
| Retomada | [ ] cmi.suspend_data e cmi.location são salvos. | O conteúdo deve salvar o estado interno e a posição. |
| Status | [ ] O Status de Conclusão/Aprovação é enviado. | Use um dos valores válidos (passed, completed, failed). |
| Pontuação | [ ] cmi.score.raw é enviado. | Valor numérico (String) para notas de avaliação. |
Comentários
0 comentário
Por favor, entre para comentar.