Compartir a través de

Estado, transiciones y limitaciones para envíos en Microsoft Graph

  • Artículo

Los envíos son una parte importante de la interacción entre las acciones de los profesores y los alumnos. Esto está relacionado con los cambios en el estado de envío durante el flujo de proceso y qué API de educación de Microsoft Graph están implicadas.

Estado de envío y transiciones

Un envío representa los recursos que un individuo o grupo activa para una asignación. Los envíos pertenecen a una asignación y se crean automáticamente cuando se publica una asignación.

El estado es una propiedad de solo lectura en el envío. Cambia en función de las acciones de los alumnos y profesores.

Estado Descripción Llamada a la API REST
Working Estado inicial después de crear el envío. POST /education/classes/{id}/assignments
POST /education/classes/{id}/assignments/{id}/submissions/{id}/unsubmit
Submitted Estado después de que el alumno active la asignación. POST /education/classes/{id}/assignments/{id}/submissions/{id}/submit
Volvió Estado después de que el profesor haya devuelto una asignación al alumno. POST /education/classes/{id}/assignments/{id}/submissions/{id}/return
Reasignado Estado después de que el profesor haya devuelto la asignación al alumno para su revisión. POST /education/classes/{id}/assignments/{id}/submissions/{id}/reassign
Excusa Los maestros pueden marcar una presentación como excusa para indicar que el envío no tiene ninguna acción adicional para el alumno. POST /education/classes/{id}/assignments/{id}/submissions/{id}/excuse

En el diagrama siguiente se muestra el flujo de transición de estado.

Diagrama de transiciones de estado de envío

Transiciones de estado de envío basadas en acciones permitidas

Estado de envío actual Nueva acción Nuevo estado
Working Turn in (Activar) Submitted
Working Devolución para revisión Reasignado
Working Return Volvió
Working Excusa Excusado
Submitted Deshacer Activar Working
Submitted Return Volvió
Submitted Devolución para revisión Reasignado
Submitted Excusa Excusado
Volvió Turn in (Activar) Submitted
Volvió Return Volvió
Volvió Devolución para revisión Reasignado
Volvió Excusa Excusado
Reasignado Turn in (Activar) Submitted
Reasignado Return Volvió
Reasignado Devolución para revisión Reasignado
Reasignado Excusa Excusado
Excusado Devolución para revisión Reasignado
Excusado Return Volvió
Excusado Turn in (Activar) Submitted

Nota:

No se permite ninguna acción ni transición de estado que no aparezca en la tabla.

Sincronización frente a operaciones asincrónicas a través de llamadas API de envíos

En la tabla siguiente se enumeran las llamadas API que afectan al estado de envío y al tipo de operación.

En este caso, todas las llamadas son asincrónicas, lo que significa que se inicia la operación y otra operación puede comenzar antes de que finalice la primera. La operación asincrónica realiza alguna actividad en segundo plano y el llamador debe sondear para obtener el resultado.

API Sincronización o sincronización asincrónica Mecanismo para obtener el estado más reciente
POST /education/classes/{id}/assignments/{id}/submissions/{id}/submit Async Sondeo
POST /education/classes/{id}/assignments/{id}/submissions/{id}/unsubmit Async Sondeo
POST /education/classes/{id}/assignments/{id}/submissions/{id}/return Async Sondeo
POST /education/classes/{id}/assignments/{id}/submissions/{id}/reassign Async Sondeo
POST /education/classes/{id}/assignments/{id}/submissions/{id}/excuse Async Sondeo

Límites

Los límites siguientes se aplican a todas las llamadas API:

  • El número máximo de recursos de envío es de 10 para el alumno.
  • El tamaño máximo permitido para los recursos es de 500 MB.
  • Se aplican límites de limitación; Para obtener más información, consulte Guía de limitación de Microsoft Graph.

Contenido relacionado