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 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	Atualize um objeto plannerTask .
Delete	Nenhum	Exclua um 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	O 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 é aplicada. Consulte plannerAppliedCategories tipo de recurso para obter valores possíveis.
assigneePriority	String	Uma dica usada para solicitar itens desse tipo em uma exibição de lista. Para obter mais informações, confira Usando dicas de pedido no Planner.
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 mesmo plano que a tarefa. O valor da propriedade bucketId tem 28 caracteres e é sensível a maiúsculas de minúsculas. Formatar validação é feito no serviço.
checklistItemCount	Int32	O número de itens de lista de verificação presentes na tarefa.
completedBy	identitySet	A identidade do usuário que concluiu a tarefa.
completedDateTime	DateTimeOffset	Somente leitura. A data e a hora em que a 'percentComplete' tarefa é definida 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	A ID do thread da conversa na tarefa. Essa é a ID do objeto thread de conversa criado no grupo.
createdBy	identitySet	A identidade do usuário que criou a tarefa.
createdDateTime	DateTimeOffset	Somente leitura. A data e a hora em 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	Informações sobre a origem da tarefa.
dueDateTime	DateTimeOffset	A data e a hora em que a tarefa está prevista. 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. Esse valor será true se o objeto de detalhes da tarefa tiver uma descrição não diferente. Caso contrário,false .
id	String	Somente leitura. O identificador exclusivo da tarefa. O valor dessa propriedade tem 28 caracteres e é sensível a maiúsculas de minúsculas. Formatar validação é feito no serviço.
isOnMyDay	Booliano	Um valor booliano que indica se deve mostrar essa tarefa no modo de exibição MyDay. true para mostrar a tarefa. Caso contrário, false.
isOnMyDayLastModifiedDate	Date	Somente leitura. A data em que a tarefa é adicionada ou removida do MyDay.
orderHint	String	A dica usada para solicitar itens desse tipo em uma exibição de lista. Para obter mais informações, consulte Usando dicas de pedido em Planner n.
percentComplete	Int32	O percentual de conclusão da tarefa. Quando definido como 100, a tarefa é concluída.
prioridade	Int32	A prioridade da tarefa. Os valores válidos são entre 0 e 10, inclusivos. Valores maiores indicam menor prioridade. Por exemplo, 0 tem a maior prioridade e 10 tem a menor prioridade. Atualmente, Planner interpreta valores e 1 como "urgentes0", 2 e 34 como "importantes", 5, e 76como "médios", e 8, 9e 10 como "baixos". Atualmente, 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	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, formCompletion, approvalCompletion. Somente leitura. Você deve usar o cabeçalho de Prefer: include-unknown-enum-members solicitação para obter os seguintes valores neste enumerável em evolução: formCompletion, approvalCompletion. 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.
formCompletion	Alguns ou todos os formulários devem ser enviados para concluir a tarefa de planejador.
approvalCompletion	A aprovação é necessária.

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. Mais detalhes 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

A representação JSON a seguir mostra o tipo de 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)",
  "isOnMyDay": "Boolean",
  "isOnMyDayLastModifiedDate": "Date",
  "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"
}