Blackboard Learn

Acreditta Platform se integra con Blackboard Learn (Anthology) mediante LTI 1.3 Advantage. Una vez conectada, tus docentes agregan Acreditta como una herramienta dentro del curso y emiten credenciales digitales a los acreditados que cumplen las reglas que definas, sin emitir una por una.

Del lado de Blackboard necesitas hacer tres configuraciones: registrar la herramienta LTI, crear un placement para que aparezca en los cursos y autorizar una integración REST para que Acreditta pueda leer los participantes y las calificaciones del curso. Después conectas todo desde Acreditta.

Antes de empezar

Ten a la mano:

  • Acceso de administrador a tu Blackboard Learn (Administrator Panel).
  • Acceso a Integraciones → Herramientas externas en Acreditta.
  • La URL de tu Blackboard Learn (por ejemplo, https://blackboard.tu-universidad.edu).
  • El Application ID de Acreditta. Es el mismo para todas las instituciones:
89bb4aff-6db8-4835-9fa7-823d57e12670

🔎 Fíjate en: Blackboard maneja dos valores parecidos, el Application ID y el Application key. Esta guía usa siempre el Application ID. Nunca necesitas el Application key ni su secret.

1. Registra la herramienta LTI 1.3 en Blackboard

  1. Entra al Administrator Panel y abre LTI Tool Providers.
  2. Haz clic en Register LTI 1.3/Advantage Tool.
  3. Pega el Application ID en el campo Client ID y haz clic en Submit.

⚠️ Importante: registra la herramienta con Register LTI 1.3/Advantage Tool. No uses Register LTI 1.1 Provider ni registres el dominio de tu Blackboard como proveedor LTI 1.1.

2. Aprueba la herramienta y define sus políticas

  1. En LTI Tool Providers, abre el menú de la herramienta Acreditta y elige Edit.
  2. Configura los valores de la tabla:
Campo Valor
Tool Status Approved. Con Excluded la herramienta no se lanza.
User Fields to Send Activa Role in Course, Name y Email Address.
Allow grade service access Yes. Acreditta lo necesita para leer las calificaciones del curso.
Allow Membership Service Access Yes. Acreditta lo necesita para conocer a los participantes del curso.
  1. Haz clic en Submit.

3. Copia el Deployment ID

  1. En LTI Tool Providers, abre de nuevo el menú de la herramienta y elige Manage Deployments.
  2. Copia el valor de Default deployment ID. Lo vas a pegar en Acreditta en el paso 6.

4. Crea el placement

El placement hace que Acreditta aparezca en la lista de herramientas de tus cursos.

  1. En LTI Tool Providers, abre el menú de la herramienta y elige Manage Placements.
  2. Haz clic en Create Placement y diligencia:
Campo Valor
Label El nombre que verán los docentes. Por ejemplo, Acreditta Badges.
Handle Un identificador único, sin espacios. Por ejemplo, acreditta-badges.
Availability Yes.
Type Course content tool. No elijas Deep Linking content tool.
Target Link URI https://lti.acreditta.com/lti
  1. Haz clic en Submit.

🔎 Fíjate en: si en Manage Placements ya ves un placement de Acreditta, no necesitas crear otro.

5. Autoriza la integración REST

Sin este paso Acreditta no puede leer las calificaciones y la conexión falla con un error 401.

  1. En el Administrator Panel, abre REST API Integrations y haz clic en Create Integration.
  2. Completa los campos:
Campo Valor
Application ID El Application ID de Acreditta. No el Application key.
Learn User Haz clic en Browse y elige un usuario con permiso de lectura sobre participantes y libro de calificaciones. Te recomendamos crear un usuario dedicado, por ejemplo acreditta_rest.
End User Access Yes.
Authorized To Act As User Service Default (No).
  1. Haz clic en Submit.

🔎 Fíjate en: Acreditta usa los permisos del Learn User que elijas. Si ese usuario no puede ver las calificaciones de un curso, Acreditta tampoco podrá evaluarlas.

6. Configura la herramienta externa en Acreditta

  1. Ve a Integraciones → Herramientas externas.
  2. Haz clic en Agregar.
  3. En el selector Lms, elige Blackboard Learn.
  4. Diligencia los campos:
Campo De dónde sale
Nombre El nombre que quieras darle a esta instancia de Blackboard dentro de Acreditta.
Url LMS La URL base de tu Blackboard Learn, con https://.
Issuer Url Ya viene diligenciado con https://blackboard.com. No lo cambies.
Client ID El Application ID de Acreditta (89bb4aff-6db8-4835-9fa7-823d57e12670).
Token URL Ya viene diligenciado. No lo cambies.
Login URL Ya viene diligenciado. No lo cambies.
Keyset URL Se completa solo al escribir el Client ID. No lo cambies.
Send notification Actívalo para que Acreditta notifique por correo a cada acreditado cuando reciba su credencial.
Deployment ID El Default deployment ID que copiaste en el paso 3.
  1. Haz clic en Guardar.

7. Agrega Acreditta a un curso

El docente o administrador agrega la herramienta dentro del contenido del curso:

  1. Abre el curso y entra a Content.
  2. En el panel derecho, bajo Books & Tools, haz clic en View course & institution tools.
  3. Elige Browse all course tools.
  4. Haz clic en el + de la herramienta Acreditta (con el nombre que pusiste en Label).

  1. Deja el elemento visible en Course Content.

⚠️ Importante: abre Acreditta siempre desde el contenido del curso. Si la abres desde el Administrator Panel o desde LTI Tool Providers, Blackboard no envía el contexto del curso y Acreditta no puede leer las calificaciones.

8. Asocia una plantilla y emite

Al abrir Acreditta desde el curso, ves la misma pantalla de Plantillas de reconocimiento que en Moodle y Canvas. Ahí asocias una plantilla de credencial, defines sus reglas y emites. El detalle está en Mapeo de campos y emisión masiva (Canvas), que funciona igual en Blackboard.

Dos particularidades de Blackboard:

  • Criterios disponibles: hoy puedes evaluar la Nota final del curso (en porcentaje) y la Nota final del curso.
  • Calificación final: el curso necesita una calificación final en el Gradebook (Overall Grade, o una columna de calificación externa). Si existe una columna de calificación externa, Acreditta la usa primero. Si no existe ninguna calificación final, nadie cumple la regla.

Problemas frecuentes

Síntoma Causa más común
La herramienta no se abre El Tool Status no está en Approved (paso 2).
Acreditta no aparece en Books & Tools El Tool Status está en Excluded, el Type del placement no es Course content tool o la Availability está en No (pasos 2 y 4).
Error de servicio de calificaciones (AGS_ENDPOINT_MISSING) Abriste Acreditta fuera del curso, o Allow grade service access está en No (pasos 2 y 7).
Error de plataforma o deployment no registrado (UNREGISTERED_PLATFORM, DEPLOYMENT_ID) El Deployment ID en Acreditta está mal o vacío (pasos 3 y 6).
Error 401 al conectar con Blackboard Falta la integración REST, el Learn User no tiene permisos, o pegaste el Application key en lugar del Application ID (paso 5).

¿Sigues sin conectar? Escríbenos a tech@acreditta.com con el nombre de tu institución y el mensaje de error.

Siguiente paso


CONTENIDO

Powered By EazyDocs