Contenido Actividad

Documentación detallada del módulo de Actividades de Contenido para la gestión de actividades asociadas a contenidos educativos en RedCollege.

Introducción

El módulo ContenidoActividadModule proporciona métodos para gestionar actividades específicas asociadas a contenidos educativos dentro de las planificaciones en el sistema RedCollege. Estas actividades representan tareas, ejercicios o acciones concretas que los estudiantes deben realizar como parte del proceso de aprendizaje.

Métodos

obtenerActividadesPorContenido

Obtiene todas las actividades asociadas a un contenido específico.

Parámetros:

NombreTipoDescripciónRequerido
contenidoIdnumberID del contenido

Retorna:

  • Promise con un array de objetos IContenidoActividad

Ejemplo de uso:

const { planificaciones } = useNuxtApp().$apis
const actividades = await planificaciones.contenidoActividades.obtenerActividadesPorContenido(789)

crearNuevaActividad

Crea una nueva actividad asociada a un contenido.

Parámetros:

NombreTipoDescripciónRequerido
dataObjectDatos de la actividad a crear
data.contenidoIdnumberID del contenido asociado
data.descripcionstringDescripción detallada de la actividad

Retorna:

  • Promise con un objeto IContenidoActividad de la actividad creada

Ejemplo de uso:

const { planificaciones } = useNuxtApp().$apis
const nuevaActividad = await planificaciones.contenidoActividades.crearNuevaActividad({
  contenidoId: 789,
  descripcion: 'Realizar ejercicios prácticos de geometría aplicada'
})

obtenerActividadPorId

Obtiene una actividad específica por su ID.

Parámetros:

NombreTipoDescripciónRequerido
idnumberID de la actividad

Retorna:

  • Promise con un objeto IContenidoActividad con los detalles de la actividad

Ejemplo de uso:

const { planificaciones } = useNuxtApp().$apis
const actividad = await planificaciones.contenidoActividades.obtenerActividadPorId(101)

actualizarActividad

Actualiza una actividad existente.

Parámetros:

NombreTipoDescripciónRequerido
idnumberID de la actividad a actualizar
dataObjectDatos actualizados de la actividad
data.contenidoIdnumberID del contenido asociado
data.descripcionstringDescripción actualizada de la actividad

Retorna:

  • Promise con un objeto IContenidoActividad con los datos actualizados

Ejemplo de uso:

const { planificaciones } = useNuxtApp().$apis
const actividadActualizada = await planificaciones.contenidoActividades.actualizarActividad(
  101,
  {
    contenidoId: 789,
    descripcion: 'Realizar ejercicios avanzados de geometría aplicada con ejemplos de la vida real'
  }
)

eliminarActividad

Elimina una actividad existente.

Parámetros:

NombreTipoDescripciónRequerido
idnumberID de la actividad a eliminar

Retorna:

  • Promise con un objeto IContenidoActividad de la actividad eliminada

Ejemplo de uso:

const { planificaciones } = useNuxtApp().$apis
const actividadEliminada = await planificaciones.contenidoActividades.eliminarActividad(101)

Consideraciones importantes

  • La mayoría de los métodos requieren autenticación previa en el sistema.
  • Las actividades están siempre asociadas a un contenido específico, que a su vez pertenece a una unidad dentro de una planificación.
  • Las actividades permiten desglosar un contenido en tareas específicas que deben realizarse como parte del proceso educativo.
  • Al crear o actualizar actividades, es necesario proporcionar tanto el ID del contenido como la descripción de la actividad.
  • Las descripciones de actividades deben ser claras y detalladas para facilitar su comprensión por parte de estudiantes y docentes.

Errores comunes

  • 404 Not Found: La actividad o contenido solicitado no existe
  • 403 Forbidden: El usuario no tiene permisos para acceder o modificar la actividad
  • 400 Bad Request: Datos enviados incorrectos o incompletos
  • 500 Internal Server Error: Error en el servidor, intentar más tarde

Interfaces relacionadas

La principal interfaz utilizada por este módulo es:

  • IContenidoActividad: Representa una actividad asociada a un contenido
    • id: Identificador único de la actividad
    • contenidoId: ID del contenido al que está asociada
    • descripcion: Descripción detallada de la actividad
    • createdAt: Fecha de creación
    • updatedAt: Fecha de última actualización
    • deletedAt: Fecha de eliminación (si aplica)
    • deletedBy: ID del usuario que eliminó la actividad (si aplica)