Compartir a través de

Estado, transiciones y limitaciones para las asignaciones en Microsoft Graph

  • Artículo

Las asignaciones son una parte importante de la interacción entre los maestros y las acciones de los alumnos. En este artículo se describen los cambios en el estado de asignación durante el flujo de proceso y qué API de educación de Microsoft Graph están implicadas.

Estado y transiciones de asignación

Una asignación representa una tarea o unidad de trabajo asignada a un alumno o miembro del equipo de una clase como parte de su estudio. Solo los profesores o los propietarios del equipo pueden crear, copiar o programar asignaciones. Estas acciones afectan al estado de la asignación. En la tabla siguiente se enumeran el estado de la asignación y las API que están disponibles para cambiar el estado.

Estado Descripción Llamada a la API REST Características disponibles para editar
Borrador Estado inicial cuando se crea o copia una nueva asignación de una asignación existente. POST /education/classes/{id}/assignments Recursos, categorías, rúbricas
Published Estado de procesamiento en segundo plano cuando la asignación se distribuye a cada alumno asignado. POST /education/classes/{id}/assignments/{id}/publish
Scheduled Estado cuando el profesor programó la asignación para publicar en un momento futuro. PATCH /education/classes/{id}/assignments/{id}
POST /education/classes/{id}/assignments/{id}/publish		 Recursos, categorías, rúbricas
Asignado Una vez completado el proceso de publicación, la asignación se mueve a un estado asignado, pasando a estar disponible para los alumnos o permanece en un estado activo. POST /education/classes/{id}/assignments/{id}/publish
POST /education/classes/{id}/assignments/{id}/activate		 Envíos
Pending Estado de procesamiento en segundo plano cuando se copia una nueva asignación de una existente. PATCH /education/classes/{id}/assignments/{id}
Inactivo La asignación no tiene elementos de acción adicionales para profesores y alumnos. POST /education/classes/{id}/assignments/{id}/deactivate

En el diagrama siguiente se muestran las transiciones de estado que pueden producirse para las asignaciones.

Diagrama de transiciones de estado de asignación

Comprobación de que se publica una asignación

El autor de la llamada debe usar la operación de asignación GET para comprobar el estado de la asignación actual y comprobar que el proceso de publicación se realizó correctamente.

Transiciones de estado de asignación basadas en las acciones permitidas

Estado de asignación actual Nueva acción Nuevo estado
Borrador El profesor programa la asignación Scheduled
Borrador Publicar Published
Borrador Editado Borrador
Borrador Descartado
Published Publicación finalizada Asignado
Published Error al publicar Borrador
Published Descartado
Scheduled Fecha de vencimiento de alcance Published
Scheduled Cancelar programación Borrador
Scheduled Reprogramar Scheduled
Asignado Descartado
Asignado Deactivated Inactivo
Pending Copia completada Borrador
Pending Descartado
Inactivo Activated Asignado

Nota:

Solo se permiten las acciones y las transiciones de estado enumeradas en la tabla.

Sincronización frente a operaciones asincrónicas a través de llamadas API de asignaciones

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

Las operaciones sincrónicas se ejecutan de uno en uno. Cada operación debe completarse antes de que pueda comenzar la siguiente y el resultado final solo se devuelve una vez finalizadas todas las operaciones. Las operaciones asincrónicas permiten que varias tareas se ejecuten simultáneamente. Mientras una operación está en curso, otra operación puede iniciarse antes de que finalice la anterior. Las operaciones asincrónicas suelen implicar actividades en segundo plano y el autor de la llamada debe comprobar activamente el resultado mediante sondeo o supervisión hasta que esté disponible.

API Sincronización o sincronización asincrónica Mecanismo para obtener el estado más reciente
DELETE /education/classes/{id}/assignments/{id} Async Sondeo
POST /education/classes/{id}/assignments/{id}/publish Async Sondeo
PATCH /education/classes/{id}/assignments/{id} Async Sondeo
POST /education/classes/{id}/assignments Async Sondeo
POST /education/classes/{id}/assignments/{id}/deactivate Async Sondeo
POST /education/classes/{id}/assignments/{id}/activate Async Sondeo

Límites

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

  • El número máximo de recursos de asignación es de 10 para el profesor.
  • 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