Saltar al contenido principal

Mapeo de campos de credenciales POK con OpenBadge 3.0 y 2.0

Cuando completas un diseño de credencial en POK Proof of Knowledge, cada campo que ingresas pasa a formar parte de un archivo JSON que cumple con los estándares OpenBadge 3.0 y OpenBadge 2.0. Esta referencia muestra cómo se corresponde cada campo de POK con las propiedades técnicas de ambos modelos, para que puedas validar la estructura completa de tus credenciales.

Dónde completar estos campos​

Completa estos campos desde el editor del Template en "Mis Diseños", al crear el diseño de la credencial que vas a emitir.

  1. Al editar el template, haz clic en el acceso directo "Cómo mejorar la calidad de mi Open Badge 3.0".

  2. Activa el toggle "Quiero que la credencial cumpla con los estándares de calidad de Open Badge".

Equivalencias de campos​

1. Logro obtenido​

Por defecto, POK usa el atributo "Title" del diseño de la credencial. Puedes reemplazar este valor por cualquier atributo creado dentro del diseño, o definir un nuevo valor por defecto.

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

2. Descripción​

Este texto se muestra como descripción de la credencial en la página del destinatario.

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

3. Criterios de obtención​

Este texto se muestra como requisitos de la credencial en la página del destinatario.

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

4. Evidencia​

  • ID
    • OB 3.0: AchievementCredential.evidence.id
    • OB 2.0: Assertion.Evidence.id
  • Nombre de evidencia
    • OB 3.0: AchievementCredential.evidence.name
    • OB 2.0: Assertion.Evidence.name
  • Descripción de evidencia
    • 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 obtenidos​

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

6. Respaldos externos​

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

7. Etiquetas internas​

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

8. Alineamiento​

  • Marco de referencia
    • OB 3.0: Achievement.alignment.targetFramework
    • OB 2.0: BadgeClass.Alignment.targetFramework
  • Nombre
    • OB 3.0: Achievement.alignment.targetName
    • OB 2.0: BadgeClass.Alignment.targetName
  • Descripción del marco
    • 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. Información del emisor​

  • Nombre
    • OB 3.0: AchievementCredential.issuer.name
    • OB 2.0: Issuer.Profile.name
  • Descripción del emisor
    • OB 3.0: AchievementCredential.issuer.description
    • OB 2.0: Issuer.Profile.description
  • Dirección
    • OB 3.0: AchievementCredential.issuer.address
  • URL
    • OB 3.0: AchievementCredential.issuer.url
    • OB 2.0: Issuer.Profile.url
  • Contacto
    • OB 3.0: AchievementCredential.issuer.email
    • OB 2.0: Issuer.Profile.email

10. Atributo "Versión"​

Durante la emisión, POK agrega el campo "Versión" para completar la información requerida. Indica la versión del grupo de credenciales que se emite.

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

¿Para qué sirve este mapeo?​

  • Asegura que cada dato que completes quede correctamente vinculado a la propiedad correspondiente del estándar.
  • Garantiza la compatibilidad con sistemas que validan credenciales OpenBadge 2.0 y 3.0.
  • Facilita la revisión técnica y la validación del JSON que POK genera automáticamente.

Validar el JSON emitido​

Si quieres validar o visualizar el JSON emitido, puedes usar validadores externos compatibles con los estándares de IMS Global (1EdTech):

¿Tienes dudas?​

Si tienes preguntas o algún problema, escríbenos a contact@pok.tech.