tipo de recurso plannerTaskRecurrence

Namespace: microsoft.graph

Importante

As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.

Representa a periodicidade de uma tarefa do Planner no Microsoft 365, permitindo que os clientes definam e editem periodicidade para uma tarefa do Planner. Para adicionar ou editar periodicidade, os clientes especificam a agenda. Para obter detalhes, veja plannerRecurrenceSchedule. Para cancelar a periodicidade, os clientes definem a mesma agenda como null. O recurso plannerTaskRecurrence também fornece propriedades geradas pelo sistema e só de leitura que são úteis para controlar e compreender a periodicidade. Para uma tarefa do Planner, após a periodicidade ter sido definida, não pode ser definida como null. Para tarefas que nunca tiveram a periodicidade definida, a periodicidade é null.

Tendo em conta uma tarefa não periódica, um cliente pode transformá-la numa tarefa periódica ao especificar a agenda. Quando a agenda é adicionada, o Planner preenche as propriedades seriesId e occurrenceId , bem como outras propriedades. Um occurrenceId de 1 indica que esta é a primeira tarefa da série. A segunda tarefa da série tem um occurrenceId de 2. O seriesId é uma nova cadeia exclusiva, criada para a primeira tarefa. A segunda tarefa e todas as tarefas futuras da série herdam o seriesId da primeira tarefa, indicando que fazem parte da mesma série periódica.

Quando uma tarefa com periodicidade ativa é marcada como concluída (percentComplete definida como 100), é criada uma nova tarefa para continuar a série. Em alternativa, se uma tarefa com periodicidade ativa for eliminada sem cancelar a periodicidade, também é criada uma nova tarefa para continuar a série. Se a série tiver de ser descontinuada, a agenda deve primeiro ser definida como nulle, em seguida, a tarefa pode ser eliminada e a periodicidade para.

Para obter mais detalhes, veja Configurar a periodicidade de tarefas no Planner.

Propriedades

Propriedade	Tipo	Descrição
nextInSeriesTaskId	Cadeia de caracteres	O taskId da tarefa seguinte nesta série. Este valor é atribuído no momento em que a próxima tarefa da série é criada e é null anterior a essa hora.
occurrenceId	Int32	O índice baseado em 1 desta tarefa na série de periodicidade. A primeira tarefa de uma série tem o valor 1, a tarefa seguinte na série tem o valor 2e assim sucessivamente.
previousInSeriesTaskId	Cadeia de caracteres	O taskId da tarefa anterior nesta série. null para a primeira tarefa de uma série, uma vez que não tem antecessor. Todas as tarefas subsequentes na série têm um valor que corresponde aos seus antecessores.
recurrenceStartDateTime	DateTimeOffset	A data e hora em que esta série de periodicidade começa. Para a primeira tarefa de uma série (occurrenceId = 1), este valor é copiado de schedule.patternStartDateTime. Para tarefas subsequentes na série (occurrenceId>= 2), este valor é copiado da tarefa anterior e nunca é alterado; preserva a data de início da série periódica. O tipo Timestamp representa informações de data e hora usando o formato ISO 8601 e está sempre no horário UTC. Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é 2014-01-01T00:00:00Z.
Cronograma	plannerRecurrenceSchedule	A agenda de periodicidade. Os clientes definem e editam a periodicidade ao especificar a agenda. Se nextInSeriesTaskId não estiver atribuído, os clientes poderão terminar a série ao atribuir a null esta propriedade.
seriesId	Cadeia de caracteres	A série de periodicidade a que esta tarefa pertence. Um valor baseado em GUID que serve de identificador exclusivo para uma série.

Relações

Nenhum

Representação JSON

A representação JSON seguinte mostra o tipo de recurso. Para obter exemplos reais que incluam este recurso, veja Configurar a periodicidade da tarefa no Planner.

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