tipo de recurso plannerTaskRecurrence

Espacio de nombres: microsoft.graph

Importante

Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.

Representa la periodicidad de una tarea de Planner en Microsoft 365, lo que permite a los clientes definir y editar la periodicidad de una tarea de Planner. Para agregar o editar la periodicidad, los clientes especifican la programación. Para obtener más información, consulte plannerRecurrenceSchedule. Para cancelar la periodicidad, los clientes establecen la misma programación en null. El recurso plannerTaskRecurrence también proporciona propiedades generadas por el sistema y de solo lectura que son útiles para realizar el seguimiento y comprender la periodicidad. Para una tarea de Planner, una vez definida la periodicidad, no se puede establecer en null. Para las tareas que nunca han tenido definida la periodicidad, periodicidad es null.

Dada una tarea no periódica, un cliente puede convertirla en una tarea periódica especificando la programación. Cuando se agrega la programación, Planner rellena las propiedades seriesId y occurrenceId , así como otras propiedades. Un occurrenceId de 1 indica que esta es la primera tarea de la serie. La segunda tarea de la serie tiene un occurrenceId de 2. SeriesId es una nueva cadena única, creada para la primera tarea. La segunda tarea y todas las tareas futuras de la serie heredan el valor de seriesId de la primera tarea, lo que indica que forman parte de la misma serie periódica.

Cuando una tarea con periodicidad activa se marca como completa (percentComplete establecida en 100), se crea una nueva tarea para continuar con la serie. Como alternativa, si se elimina una tarea con periodicidad activa sin cancelar la periodicidad, también se crea una nueva tarea para continuar con la serie. Si se debe interrumpir la serie, la programación debe establecerse primero en nully, a continuación, se puede eliminar la tarea y se detiene la periodicidad.

Para obtener más información, consulte Configuración de la periodicidad de tareas en Planner.

Propiedades

Propiedad	Tipo	Descripción
nextInSeriesTaskId	Cadena	TaskId de la siguiente tarea de esta serie. Este valor se asigna en el momento en que se crea la siguiente tarea de la serie y es null anterior a ese momento.
occurrenceId	Int32	Índice basado en 1 de esta tarea dentro de la serie de periodicidad. La primera tarea de una serie tiene el valor 1, la siguiente tarea de la serie tiene el valor 2, etc.
previousInSeriesTaskId	Cadena	TaskId de la tarea anterior de esta serie. null para la primera tarea de una serie, ya que no tiene ninguna predecesora. Todas las tareas posteriores de la serie tienen un valor que corresponde a sus predecesores.
recurrenceStartDateTime	DateTimeOffset	Fecha y hora en que comienza esta serie de periodicidad. Para la primera tarea de una serie (occurrenceId = 1), este valor se copia de schedule.patternStartDateTime. Para las tareas posteriores de la serie (occurrenceId>= 2) este valor se copia de la tarea anterior y nunca cambia; conserva la fecha de inicio de la serie periódica. El tipo de marca de tiempo representa la información de fecha y hora con el formato ISO 8601 y está siempre en hora UTC. Por ejemplo, la medianoche en la zona horaria UTC del 1 de enero de 2014 sería 2014-01-01T00:00:00Z.
schedule	plannerRecurrenceSchedule	Programación de periodicidad. Los clientes definen y editan la periodicidad especificando la programación. Si nextInSeriesTaskId no está asignado, los clientes pueden finalizar la serie mediante la asignación null a esta propiedad.
seriesId	Cadena	La serie de periodicidad a la que pertenece esta tarea. Valor basado en GUID que actúa como identificador único de una serie.

Relaciones

Ninguna.

Representación JSON

La siguiente representación JSON muestra el tipo de recurso. Para ver ejemplos reales que incluyen este recurso, consulte Configuración de la periodicidad de tareas en Planner.

{
  "@odata.type": "#microsoft.graph.plannerTaskRecurrence",
  "nextInSeriesTaskId": "String",
  "occurrenceId": "Int32",
  "previousInSeriesTaskId": "String",
  "recurrenceStartDateTime": "String (timestamp)",
  "schedule": { "@odata.type": "#microsoft.graph.plannerRecurrenceSchedule" },
  "seriesId": "String"
}