Actualización de datos de asignación y calificación

Las instituciones educativas tienen herramientas personalizadas para actualizar los datos de asignación y calificación. Por ejemplo, es posible que un profesor tenga que realizar una actualización de una asignación antes de que los alumnos las envíen o realizar un cambio en una calificación (resultado) mediante una herramienta personalizada.

Para poder actualizar los datos, debe obtener la información de clase y miembro pertinente.

Nota: Puede usar el Explorador de Graph para probar las API de Educación mencionadas en este artículo.

Obtener información de clase y miembro

Todas las asignaciones y la información de calificación forman parte del equipo de Microsoft Teams. Puede obtener información sobre clases, miembros y roles (alumno o profesor) en un equipo mediante las siguientes API de Teams:

• Enumerar clases de una clase educationSchools: devuelve una lista de todas las clases del inquilino de educación.
• Enumerar miembros de una clase educationClass: Listas información sobre los miembros de una clase específica.

Después de obtener la información de clase y miembro pertinente, puede obtener la información de asignación y calificación que necesita.

Información de asignación y envío

Toda la información de asignación y alumno está vinculada a la información de clase y envío, respectivamente. Las siguientes API recuperan información sobre las asignaciones de clases y los envíos:

• tipo de recurso educationAssignment: Listas todos los métodos disponibles para las asignaciones de una clase. Un usuario puede obtener todos los objetos educationAssignmentResource asociados dentro de una asignación.
• Tipo de recurso educationSubmission: se crea un submissionId para cada alumno para el que se publica una asignación. Puede usar esta API para obtener el estado de envío, por ejemplo, si se ha convertido y calificado, (recursos) enviados por el alumno y la calificación (resultado) del envío.

Actualización de datos de calificación (resultado)

Los usuarios pueden actualizar las propiedades de un objeto educationOutcome . Las propiedades existentes que no se incluyen en el cuerpo de la solicitud mantendrán sus valores anteriores. Solo los profesores pueden realizar esta operación.

En el ejemplo siguiente se describe cómo actualizar un resultado de puntos.

Solicitud

En el ejemplo siguiente se muestra la solicitud.

Nota: El cuerpo de la solicitud solo debe incluir los valores de los campos que deben actualizarse.

PATCH https://graph.microsoft.com/v1.0/education/classes/acdefc6b-2dc6-4e71-b1e9-6d9810ab1793/assignments/cf6005fc-9e13-44a2-a6ac-a53322006454/submissions/d1bee293-d8bb-48d4-af3e-c8cb0e3c7fe7/outcomes/9c0f2850-ff8f-4fd6-b3ac-e23077b59141
Content-type: application/json

{
    "@odata.type":"#microsoft.graph.educationPointsOutcome",
    "points":{
        "@odata.type":"#microsoft.graph.educationAssignmentPointsGrade",
        "points":85.0
    }
}

Respuesta

En el ejemplo siguiente se muestra el resposnse.

HTTP/1.1 200 OK
Content-type: application/json

{
    "@odata.type":"#microsoft.graph.educationPointsOutcome",
    "id":"ea1351f6-ba33-4940-b2cb-6a7254af2dc8",
    "lastModifiedBy":{
        "user":{
            "id":"9391878d-903c-406c-bb1c-0f17d00fd878"
        }
    },
    "points":{
        "gradedDateTime":"2019-07-15T22:35:48.2429387Z",
        "points":85.0,
        "gradedBy":{
            "user":{
                "id":"9391878d-903c-406c-bb1c-0f17d00fd878"
            }
        }
    }
}

Esta solicitud devuelve un objeto educationOutcome actualizado en el cuerpo de la respuesta.

Permissions

Los permisos delegados y de aplicación son necesarios para actualizar los datos de las asignaciones. Actualmente, los permisos de aplicación solo se admiten en la versión beta.

Nota: Dado que la información de alumnos y calificaciones es información confidencial, asegúrese de comprobar qué permisos son necesarios.