tipo de recurso plannerTask

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 uma tarefa planner no Microsoft 365. Uma tarefa Planner está contida em um plano e pode ser atribuída a um bucket em um plano. Cada objeto de tarefa tem um objeto de detalhes que pode conter mais informações sobre a tarefa. Para obter mais informações sobre relações entre grupo, plano e tarefa, consulte Usar a API REST do Planner

Métodos

Método Tipo de retorno Descrição
Obter plannerTask plannerTask Leia as propriedades e as relações do objeto plannerTask.
Update plannerTask Atualizar o objeto plannerTask.
Delete Nenhum Excluir o objeto plannerTask.
Obter delta Coleção plannerTask Obtenha objetos plannerTask recém-criados, atualizados ou excluídos em um plannerPlan ou atribuídos ao usuário conectado sem precisar executar uma leitura completa de toda a coleção de recursos.

Propriedades

Propriedade Tipo Descrição
activeChecklistItemCount Int32 Número de itens de lista de verificação com valor definido como false, representando itens incompletos.
appliedCategories plannerAppliedCategories As categorias às quais a tarefa foi aplicada. Consulte Categorias aplicadas para obter valores possíveis.
assigneePriority String Dica usada para solicitar itens desse tipo em uma exibição de lista. O formato é definido como descrito aqui.
assignments plannerAssignments O conjunto de destinatários aos quais a tarefa é atribuída.
bucketId String ID do bucket ao qual a tarefa pertence. O bucket precisa estar no plano no qual a tarefa está. Tem 28 caracteres e diferencia maiúsculas de minúsculas. Formatar validação é feito no serviço.
checklistItemCount Int32 Número de itens de lista de verificação que estão presentes na tarefa.
completedBy identitySet Identidade do usuário que concluiu a tarefa.
completedDateTime DateTimeOffset Somente leitura. A data e a hora na qual o 'percentComplete' da tarefa está definido como '100'. 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
conversationThreadId String ID do thread da conversa na tarefa. Essa é a ID do objeto thread de conversa criado no grupo.
createdBy identitySet Identidade do usuário que criou a tarefa.
createdDateTime DateTimeOffset Somente leitura. A data e a hora que a tarefa é criada. 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
creationSource plannerTaskCreation Contém informações sobre a origem da tarefa.
dueDateTime DateTimeOffset A data e a hora que a tarefa já deve estar concluída. 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
hasDescription Booliano Somente leitura. O valor será true se o objeto de detalhes da tarefa tiver uma descrição nãompty e false de outra forma.
id String Somente leitura. A ID da tarefa. Tem 28 caracteres e diferencia maiúsculas de minúsculas. Formatar validação é feito no serviço.
orderHint String Dica usada para solicitar itens desse tipo em uma exibição de lista. O formato é definido como descrito aqui.
percentComplete Int32 Percentual de conclusão da tarefa. Quando definida como 100, a tarefa é considerada concluída.
prioridade Int32 Prioridade da tarefa. O intervalo válido de valores é entre 0 e 10 (inclusivo), com o aumento do valor sendo de menor prioridade (0 tem a maior prioridade e 10 tem a menor prioridade). Atualmente, o Planner interpreta valores 0 e como "urgentes", 2 e 34 como "importantes", 5, e 67 como "médios", e 8, 9e 10 como "baixos1". Atualmente, o Planner define o valor 1 para "urgente", 3 para "importante", 5 para "médio" e 9 para "baixo".
planId String ID do plano ao qual a tarefa pertence.
previewType String Isso define o tipo de visualização que aparece na tarefa. Os valores possíveis são: automatic, noPreview, checklist, description, reference.
recurrence plannerTaskRecurrence Define a recorrência ativa ou inativa para a tarefa. null quando a recorrência nunca tiver sido definida para a tarefa.
referenceCount Int32 Número de referências externas existentes na tarefa.
especificadoCompletionRequirements plannerTaskCompletionRequirements Indica todos os requisitos especificados no plannerTask. Os valores possíveis são: none, checklistCompletion, unknownFutureValue. Somente leitura. O plannerTaskCompletionRequirementDetails no plannerTaskDetails tem detalhes dos requisitos especificados, se houver.
startDateTime DateTimeOffset A data e a hora que a tarefa começa. 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
title String Título da tarefa.

valores plannerTaskCompletionRequirements

Member Descrição
none Nenhum requisito.
checklistCompletion Alguns ou todos os itens da lista de verificação são necessários para serem verificados.
unknownFutureValue Valor sentinela de enumeração evoluível. Não usar.

Relações

Relação Tipo Descrição
assignedToTaskBoardFormat plannerAssignedToTaskBoardTaskFormat Somente leitura. Anulável. Usada para renderizar a tarefa corretamente no modo de exibição do quadro de tarefas quando agrupada por assignedTo.
bucketTaskBoardFormat plannerBucketTaskBoardTaskFormat Somente leitura. Anulável. Usada para renderizar a tarefa corretamente no modo de exibição do quadro de tarefas quando agrupada por bucket.
detalhes plannerTaskDetails Somente leitura. Anulável. Detalhes adicionais sobre a tarefa.
progressTaskBoardFormat plannerProgressTaskBoardTaskFormat Somente leitura. Anulável. Usada para renderizar a tarefa corretamente no modo de exibição do quadro de tarefas quando agrupada pelo progresso.

Representação JSON

Aqui está uma representação JSON do recurso.

{
  "activeChecklistItemCount": "Int32",
  "appliedCategories": {"@odata.type": "microsoft.graph.plannerAppliedCategories"},
  "assigneePriority": "String",
  "assignments": {"@odata.type": "microsoft.graph.plannerAssignments"},
  "bucketId": "String",
  "checklistItemCount": "Int32",
  "completedBy": {"@odata.type": "microsoft.graph.identitySet"},
  "completedDateTime": "String (timestamp)",
  "conversationThreadId": "String",
  "createdBy": {"@odata.type": "microsoft.graph.identitySet"},
  "createdDateTime": "String (timestamp)",
  "dueDateTime": "String (timestamp)",
  "hasDescription": "Boolean",
  "id": "String (identifier)",
  "orderHint": "String",
  "percentComplete": "Int32",
  "planId": "String",
  "previewType": "String",
  "priority": "Int32",
  "recurrence": {"@odata.type": "microsoft.graph.plannerTaskRecurrence"},
  "referenceCount": "Int32",
  "specifiedCompletionRequirements": "String",
  "startDateTime": "String (timestamp)",
  "title": "String"
}