Casos services

1. Crear un caso.

- local_contentdata_create_caso

Descripción:
Servicio para crear un caso. Endpoint: local_contentdata_create_caso
Método: POST
Argumentos:

wstoken: string | token de Manager
moodlewsrestformat: json | formato de la respuesta
wsfunction: string | local_contentdata_create_caso
usertoken: string | token del usuario
courseid: int | Id de curso
sectionnum: int | Número de módulo del caso
name: string | Nombre del caso
description: string | Descripción del caso
sesion_link: string | URL de la sesión en vivo (opciona)
date: int | Fecha en TimeStamp
maxgrade: int | Calificación máxima
gradepass: int | Calificación para aprobar
users: string | Lista de id’s de usuarios que tienen acceso a la actividad, separados por ”,” (opcional, valor por defecto “all”)
files: file | Archivo para el caso (opcional)

Respuestas:

Éxito
Fallo

Se creó el caso

{
    "status": 201,
    "code": 0,
    "message": "",
    "body":
        'id': id del caso,
        'name': nombre del caso
}

Error producido si el usuario no tiene permisos para crear casos

{
    "status": 404,
    "code": 1,
    "message": "Permission denied",
    "body": []
}

Error producido si el curso no es Máster

{
    "status": 404,
    "code": 2,
    "message": "Incorrect course type",
    "body": []
}

Error producido si no se encontró el curso

{
    "status": 404,
    "code": 3,
    "message": "Course not found",
    "body": []
}

Error producido si no se encontró el módulo

{
    "status": 404,
    "code": 4,
    "message": "Invalid section",
    "body": []
}

2. Actualizar un caso.

- local_contentdata_update_caso

Descripción:
Servicio para actualizar un caso. Endpoint: local_contentdata_update_caso
Método: POST
Argumentos:

wstoken: string | token de Manager
moodlewsrestformat: json | formato de la respuesta
wsfunction: string | local_contentdata_update_caso
usertoken: string | token del usuario
courseid: int | Id de curso
activityid: int | Id de la actividad (cmid)
name: string | Nombre del caso
description: string | Descripción del caso
sesion_link: string | URL de la sesión en vivo (opciona)
date: int | Fecha en TimeStamp
maxgrade: int | Calificación máxima
gradepass: int | Calificación para aprobar
users: string | Lista de id’s de usuarios que tienen acceso a la actividad, separados por ”,” (opcional)
files: file | Archivo para el caso (opcional)

Respuestas:

Éxito
Fallo

Se actualizó el caso

{
    "status": 200,
    "code": 0,
    "message": ""
}

Error producido si el usuario no tiene permisos para editar casos

{
    "status": 404,
    "code": 1,
    "message": "Permission denied",
    "body": []
}

Error producido si no se encontró el curso

{
    "status": 404,
    "code": 3,
    "message": "Course not found"
}

Error producido si no se encontró la actividad

{
    "status": 404,
    "code": 4,
    "message": "Activity not found"
}

3. Eliminar un caso.

- local_contentdata_delete_caso

Descripción:
Servicio para eliminar un caso. Endpoint: local_contentdata_delete_caso
Método: POST
Argumentos:

wstoken: string | token de Manager
moodlewsrestformat: json | formato de la respuesta
wsfunction: string | local_contentdata_delete_caso
usertoken: string | token del usuario
courseid: int | Id de curso
activityid: int | Id de la actividad (cmid)

Respuestas:

Éxito
Fallo

Se eliminó el caso

{
    "status": 200,
    "code": 0,
    "message": ""
}

Error producido si el usuario no tiene permisos para eliminar casos

{
    "status": 404,
    "code": 1,
    "message": "Permission denied",
    "body": []
}

Error producido si no se encontró el curso

{
    "status": 404,
    "code": 3,
    "message": "Course not found"
}

Error producido si no se encontró la actividad

{
    "status": 404,
    "code": 4,
    "message": "Activity not found"
}

4. Asignar usuarios a actividades especificas.

- local_contentdata_assign_users_to_activity

Descripción:
Servicio para asignar usuarios a actividades especificas. Endpoint: local_contentdata_assign_users_to_activity
Método: POST
Argumentos:

wstoken: string | token de Manager
moodlewsrestformat: json | formato de la respuesta
wsfunction: string | local_contentdata_assign_users_to_activity
activityid: int | Id de actividad (cmid)
usesr: string | Id’s de usuarios separados por coma

Respuestas:

Éxito
Fallo

Se agregaron a los usuarios

{
    "status": 200,
    "code": 0,
    "message": ""
}

Error producido si no se encontró el curso

{
    "status": 404,
    "code": 4,
    "message": "Activity not found"
}

5. Obtener la infomación de un caso.

- local_contentdata_get_caso

Descripción:
Servicio para obtener la infomación de un caso. Endpoint: local_contentdata_get_caso
Método: GET
Argumentos:

wstoken: string | token de Manager
moodlewsrestformat: json | formato de la respuesta
wsfunction: string | local_contentdata_get_caso
cmid: int | Id de actividad (cmid)

Respuestas:

Éxito
Fallo

Se obtiene la información del caso

{
    "status": 200,
    "code": 0,
    "message": ""
    "body":
        'cmid' : Id de la actividad (cmid)
        'categoryid' : Id de la categoría
        'typeid' : Id del tipo de caso
        'casoid' : Id del caso
        'name' : Nombre del caso
        'description' : Descripción del caso
        'statement' : Enunciado del caso
        'session_link' : URL de la sesión
        'speaker' : Orador
        'dateid' : Id de la fecha
        'startdate' : Fecha de inicio
        'enddate' : Fecha de cierre
        'deadline' Fecha limite
}

Error producido si el usuario no tiene permisos para eliminar casos

{
    "status": 404,
    "code": 1,
    "message": "Permission denied"
}

Error producido si no se encontró el caso

{
    "status": 404,
    "code": 4,
    "message": "Caso not found"
}

6. Enlistar los casos de una promoción.

- local_contentdata_get_group_cases_info

Descripción:
Servicio enlistar los casos de una promoción. Endpoint: local_contentdata_get_group_cases_info
Método: GET
Argumentos:

wstoken: string | token de Manager
moodlewsrestformat: json | formato de la respuesta
wsfunction: string | local_contentdata_get_group_cases_info
courseid: int | Id de curso
groupid: int | Id de grupo

Respuestas:

Éxito
Fallo

Se obtiene la información del caso

{
    "status": 200,
    "code": 0,
    "message": ""
    "body":
        'cmid' : Id de la actividad (cmid)
        'categoryid' : Id de la categoría
        'typeid' : Id del tipo de caso
        'casoid' : Id del caso
        'name' : Nombre del caso
        'dateid' : Id de la fecha
        'startdate' : Fecha de inicio
        'enddate' : Fecha de cierre
        'deadline' Fecha limite
        'extraordinarydateid' : Id de fecha extraordinaria (Solo en casos extraordinarios)
        'statement' : URL de la sesión
        'assigneduserid' : Id de usuario asignadio (Solo en casos extraordinarios)
        'assignedusername' : Nombre de usuario asignado (Solo en casos extraordinarios)
        'assigneduseremail' : Email de usuario asignado (Solo en casos extraordinarios)
}

Error producido si no se encontró el curso

{
    "status": 404,
    "code": 1,
    "message": "Course not found"
}

Error producido si no se encontró el grupo

{
    "status": 404,
    "code": 3,
    "message": "Group not found"
}

7. Enlistar los casos de un curso por curso.

- local_contentdata_get_cases_by_course

Descripción:
Servicio enlistar los casos de un curso por curso. Endpoint: local_contentdata_get_cases_by_course
Método: GET
Argumentos:

wstoken: string | token de Manager
moodlewsrestformat: json | formato de la respuesta
wsfunction: string | local_contentdata_get_cases_by_course
courseid: int | Id de curso
groupid: int | Id de grupo

Respuestas:

Éxito
Fallo

Se obtiene la información del caso

{
    "status": 200,
    "code": 0,
    "message": ""
    "body":
        'cmid' : Id de la actividad (cmid)
        'categoryid' : Id de la categoría
        'typeid' : Id del tipo de caso
        'casoid' : Id del caso
        'name' : Nombre del caso
        'dateid' : Id de la fecha
        'startdate' : Fecha de inicio
        'enddate' : Fecha de cierre
        'deadline' Fecha limite
        'extraordinarydateid' : Id de fecha extraordinaria (Solo en casos extraordinarios)
        'statement' : URL de la sesión
        'assigneduserid' : Id de usuario asignadio (Solo en casos extraordinarios)
        'assignedusername' : Nombre de usuario asignado (Solo en casos extraordinarios)
        'assigneduseremail' : Email de usuario asignado (Solo en casos extraordinarios)
}

Error producido si no se encontró el curso

{
    "status": 404,
    "code": 1,
    "message": "Course not found"
}

Error producido si no se encontró el grupo

{
    "status": 404,
    "code": 3,
    "message": "Group not found"
}

8. Ver la información de la entrega del alumno en un caso.

- local_contentdata_get_student_case_submission

Descripción:
Servicio para ver la información de la entrega del alumno de un caso. Endpoint: local_contentdata_get_student_case_submission Método: GET
Argumentos:

wstoken: string | token de Manager
moodlewsrestformat: json | formato de la respuesta
wsfunction: string | local_contentdata_get_student_case_submission
courseid: int | Id de curso
activityid: int | Id de la actividad (cmid)
userid: int | Id de usuario
groupid: int | Id de grupo
extraordinarydateid: int | Id fecha extraordinaria (opcional)

Respuestas:

Éxito
Fallo

Se obtiene la información de la entrega del caso

{
    "status": 200,
    "code": 0,
    "message": ""
    "body":
        'activityid' : ID de la actividad (cmid)
        'casoid' : ID del caso
        'casecategoryid' : ID de la categoría del caso
        'casetypeid' : Tipo de caso
        'userid' : ID de usuario
        'student' : Nombre del usuario
        'title' : Título de la actividad
        'description' : Descripción de la actividad
        'statement' : Estado de la actividad
        'session_link' : LINK de sesión
        'speaker' : Orador
        'startdate' : Fecha de inicio
        'enddate' : Fecha final
        'deadline' : Fecha limite
        'userDeliveryDate' : Fecha de entrega del usuario
        'delivery_grade' : Calificación de la entrega
        'final_grade' : Calificación final
        'studentDelivery' : Archivo del alumno
        'teacherCorrection' : Archivo de correción del tutor
        'comment' : Comentario del tutor
        'casestate' : Estado del caso
}

Error producido si no se encontró el curso

{
    "status": 404,
    "code": 1,
    "message": "Course not found"
}

Error producido si no se encontró el grupo

{
    "status": 404,
    "code": 2,
    "message": "Group not found"
}

Error producido si no se encontró el caso

{
    "status": 400,
    "code": 3,
    "message": "Case not found"
}

Error producido si no se encontró el caso extraordinario

{
    "status": 400,
    "code": 3,
    "message": "Extraordinary not found"
}

9. Guardar la calificación y la corrección de la entrega de un caso

— local_contentdata_save_case_grade

Descripción:
Servicio para guardar la calificación y la corrección de la entrega de un caso Endpoint: local_contentdata_save_case_grade Método: GET
Argumentos:

wstoken: string | token de Manager
moodlewsrestformat: json | formato de la respuesta
wsfunction: string | local_contentdata_save_case_grade
courseid: int | Id de curso
activityid: int | Id de la actividad (cmid)
userid: int | Id de usuario
groupid: int | Id de grupo
grade: float | Calificación
comment: string | Comentario del tutor
extraordinarydateid: int | Id fecha extraordinaria (opcional)

Respuestas:

Éxito
Fallo

Se guardo la calificación

{
    "status": 200,
    "code": 0,
    "message": ""
}

Error producido si no se encontró el curso

{
    "status": 404,
    "code": 1,
    "message": "Course not found"
}

Error producido si no se encontró el grupo

{
    "status": 404,
    "code": 2,
    "message": "Group not found"
}

Error producido si no se encontró el caso

{
    "status": 400,
    "code": 3,
    "message": "Case not found"
}

Error producido si no se encontró el caso extraordinario

{
    "status": 400,
    "code": 3,
    "message": "Extraordinary not found"
}