Partager via


Type de ressource plannerTaskRecurrence

Espace de noms: microsoft.graph

Importante

Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .

Représente la périodicité d’une tâche Planificateur dans Microsoft 365, ce qui permet aux clients de définir et de modifier la périodicité d’une tâche planificateur. Pour ajouter ou modifier une périodicité, les clients spécifient la planification. Pour plus d’informations, consultez plannerRecurrenceSchedule. Pour annuler la périodicité, les clients définissent la même planification sur null. La ressource plannerTaskRecurrence fournit également des propriétés générées par le système et en lecture seule qui sont utiles pour le suivi et la compréhension de la périodicité. Pour une tâche Planificateur, une fois la périodicité définie, elle ne peut pas être définie sur null. Pour les tâches dont la périodicité n’a jamais été définie, la périodicité est null.

Dans le cas d’une tâche non périodique, un client peut en faire une tâche périodique en spécifiant la planification. Lorsque la planification est ajoutée, le Planificateur remplit les propriétés seriesId et occurrenceId , ainsi que d’autres propriétés. Un occurrenceId de indique qu’il s’agit de 1 la première tâche de la série. La deuxième tâche de la série a un occurrenceId de 2. SeriesId est une nouvelle chaîne unique, créée pour la première tâche. La deuxième tâche et toutes les tâches futures de la série héritent de la série SeriesId de la première tâche, ce qui indique qu’elles font partie de la même série périodique.

Lorsqu’une tâche avec une périodicité active est marquée comme terminée (percentComplete défini sur 100), une nouvelle tâche est créée pour continuer la série. Si une tâche avec une périodicité active est supprimée sans annuler la périodicité, une nouvelle tâche est également créée pour continuer la série. Si la série doit être interrompue, la planification doit d’abord être définie sur null, puis la tâche peut être supprimée et la périodicité s’arrête.

Pour plus d’informations, consultez Configuration de la périodicité des tâches dans le Planificateur.

Propriétés

Propriété Type Description
nextInSeriesTaskId Chaîne TaskId de la tâche suivante de cette série. Cette valeur est affectée au moment de la création de la tâche suivante de la série et est null antérieure à cette date.
occurrenceId Int32 Index de base 1 de cette tâche dans la série de périodicité. La première tâche d’une série a la valeur 1, la tâche suivante de la série a la valeur 2, et ainsi de suite.
previousInSeriesTaskId Chaîne TaskId de la tâche précédente de cette série. null pour la première tâche d’une série puisqu’elle n’a pas de prédécesseur. Toutes les tâches suivantes de la série ont une valeur qui correspond à leurs prédécesseurs.
recurrenceStartDateTime DateTimeOffset Date et heure de début de cette série de périodicité. Pour la première tâche d’une série (occurrenceId = 1), cette valeur est copiée à partir de schedule.patternStartDateTime. Pour les tâches suivantes de la série (occurrenceId>= 2), cette valeur est copiée à partir de la tâche précédente et ne change jamais ; elle conserve la date de début de la série périodique. Le type d’horodatage représente les informations de date et d’heure au moyen du format ISO 8601. Il est toujours au format d’heure UTC. Par exemple, le 1er janvier 2014 à minuit UTC se présente comme suit : 2014-01-01T00:00:00Z.
planifier plannerRecurrenceSchedule Planification de la périodicité. Les clients définissent et modifient la périodicité en spécifiant la planification. Si nextInSeriesTaskId n’est pas affecté, les clients peuvent mettre fin à la série en affectant null à cette propriété.
seriesId Chaîne Série de périodicité à laquelle appartient cette tâche. Valeur basée sur un GUID qui sert d’identificateur unique pour une série.

Relations

Aucun.

Représentation JSON

La représentation JSON suivante montre le type de ressource. Pour obtenir des exemples concrets qui incluent cette ressource, consultez Configuration de la périodicité des tâches dans le Planificateur.

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