Pular para o conteúdo principal

Mapeamento dos campos de credenciais POK com OpenBadge 3.0 e 2.0

Quando você conclui um design de credencial no POK Proof of Knowledge, cada campo preenchido passa a fazer parte de um arquivo JSON em conformidade com os padrões OpenBadge 3.0 e OpenBadge 2.0. Esta referência mostra como cada campo do POK corresponde às propriedades técnicas dos dois modelos, para que você possa validar a estrutura completa das suas credenciais.

Onde preencher esses campos​

Preencha esses campos no editor do Template, em "Meus Designs", ao criar o design da credencial que será emitida.

  1. Ao editar o template, clique no atalho "Como melhorar a qualidade do meu Open Badge 3.0".

  2. Ative a opção "Quero que a credencial esteja em conformidade com os padrões de qualidade do Open Badge".

Mapeamento de campos​

1. Conquista Obtida​

Por padrão, o POK usa o atributo "Title" do design da credencial. Você pode substituir esse valor por qualquer atributo criado dentro do design ou definir um novo valor padrão.

  • OpenBadge 3.0: Achievement.name
  • OpenBadge 2.0: BadgeClass.name

2. Descrição​

Este texto aparece como descrição da credencial na página do destinatário.

  • OpenBadge 3.0: Achievement.description
  • OpenBadge 2.0: BadgeClass.description

3. Critérios para Obtenção​

Este texto aparece como requisitos da credencial na página do destinatário.

  • OpenBadge 3.0: Achievement.criteria.narrative
  • OpenBadge 2.0: BadgeClass.criteria.narrative

4. Evidência​

  • ID
    • OB 3.0: AchievementCredential.evidence.id
    • OB 2.0: Assertion.Evidence.id
  • Nome da Evidência
    • OB 3.0: AchievementCredential.evidence.name
    • OB 2.0: Assertion.Evidence.name
  • Descrição da Evidência
    • OB 3.0: AchievementCredential.evidence.description
    • OB 2.0: Assertion.Evidence.description
  • Narrativa
    • OB 3.0: AchievementCredential.evidence.narrative
    • OB 2.0: Assertion.Evidence.narrative

5. Créditos Obtidos​

  • OB 3.0: AchievementSubject.creditsEarned
  • OB 2.0: BadgeClass.creditsEarned

6. Endossos Externos​

  • OB 3.0: AchievementSubject.externalEndorsements
  • OB 2.0: BadgeClass.externalEndorsements

7. Tags Internas​

  • OB 3.0: Achievement.tag
  • OB 2.0: BadgeClass.tags

8. Alinhamento​

  • Referencial
    • OB 3.0: Achievement.alignment.targetFramework
    • OB 2.0: BadgeClass.Alignment.targetFramework
  • Nome
    • OB 3.0: Achievement.alignment.targetName
    • OB 2.0: BadgeClass.Alignment.targetName
  • Descrição do Referencial
    • OB 3.0: Achievement.alignment.targetDescription
    • OB 2.0: BadgeClass.Alignment.targetDescription
  • URL
    • OB 3.0: Achievement.alignment.targetUrl
    • OB 2.0: BadgeClass.Alignment.targetUrl

9. Informações do Emissor​

  • Nome
    • OB 3.0: AchievementCredential.issuer.name
    • OB 2.0: Issuer.Profile.name
  • Descrição do Emissor
    • OB 3.0: AchievementCredential.issuer.description
    • OB 2.0: Issuer.Profile.description
  • Endereço
    • OB 3.0: AchievementCredential.issuer.address
  • URL
    • OB 3.0: AchievementCredential.issuer.url
    • OB 2.0: Issuer.Profile.url
  • Contato
    • OB 3.0: AchievementCredential.issuer.email
    • OB 2.0: Issuer.Profile.email

10. Atributo "Versão"​

Durante a emissão, o POK adiciona o campo "Versão" para completar as informações obrigatórias. Ele indica a versão da turma ou lote da credencial que será emitida.

  • OB 3.0: Achievement.version
  • OB 2.0: BadgeClass.version

Para que serve este mapeamento?​

  • Garante que cada informação preenchida fique corretamente vinculada à propriedade correspondente do padrão.
  • Assegura a compatibilidade com sistemas que validam credenciais OpenBadge 2.0 e 3.0.
  • Facilita a revisão técnica e a validação do JSON que o POK gera automaticamente.

Validar o JSON emitido​

Para validar ou visualizar o JSON emitido, você pode usar validadores externos compatíveis com os padrões da IMS Global (1EdTech):

Tem dúvidas?​

Se tiver qualquer dúvida ou problema, entre em contato pelo e-mail contact@pok.tech.