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 do Planner no Microsoft 365. Uma tarefa do Planner está contida num plano e pode ser atribuída a um grupo num 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 as relações entre o grupo, o plano e a tarefa, veja Utilizar a API REST do planner.

Métodos

Método	Tipo de retorno	Descrição
Obter tarefa	plannerTask	Leia as propriedades e relações do objeto plannerTask .
Atualizar tarefa	plannerTask	Atualizar um objeto plannerTask .
Excluir tarefa	Nenhum	Eliminar um objeto plannerTask .
Obter delta	Coleção plannerTask	Obtenha objetos plannerTask recentemente criados, atualizados ou eliminados num plannerPlan ou atribuídos ao utilizador com sessão iniciada sem ter de efetuar uma leitura completa de toda a coleção de recursos.

Propriedades

Propriedade	Tipo	Descrição
activeChecklistItemCount	Int32	O número de itens da lista de verificação com o valor definido como false, representando itens incompletos.
appliedCategories	plannerAppliedCategories	As categorias às quais a tarefa é aplicada. Veja plannerAppliedCategories resource type (Tipo de recurso plannerAppliedCategories ) para obter os valores possíveis.
archivalInfo	plannerArchivalInfo	Somente leitura. Anulável. Contém informações sobre quem arquivou ou desarmou a tarefa e porquê.
assigneePriority	String	Uma sugestão que é utilizada para ordenar itens deste tipo numa vista de lista. Para obter mais informações, consulte Utilizar sugestões de ordem 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 registo tem de estar no mesmo plano que a tarefa. O valor da propriedade bucketId tem 28 carateres de comprimento e é sensível às maiúsculas e minúsculas. Formatar validação é feito no serviço.
checklistItemCount	Int32	O número de itens da lista de verificação que estão presentes na tarefa.
completedBy	identitySet	A identidade do utilizador que concluiu a tarefa.
completedDateTime	DateTimeOffset	Somente leitura. A data e hora em que a 'percentComplete' tarefa está 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	O ID do tópico da conversação na tarefa. Este é o ID do objeto de thread de conversação criado no grupo.
createdBy	identitySet	A identidade do utilizador que criou a tarefa.
createdDateTime	DateTimeOffset	Somente leitura. A data e 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
criaçãoOrigem	plannerTaskCreation	Informações sobre a origem da tarefa.
dueDateTime	DateTimeOffset	A data e hora para conclusão da tarefa. O tipo de carimbo de data/hora representa informações de data e hora com o formato ISO 8601 e está sempre na hora UTC. Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é 2014-01-01T00:00:00Z
hasDescription	Booliano	Somente leitura. Este valor é true se o objeto de detalhes da tarefa tiver uma descrição sem limites. Caso contrário,false .
id	String	Somente leitura. O identificador exclusivo da tarefa. O valor desta propriedade tem 28 carateres de comprimento e é sensível às maiúsculas e minúsculas. Formatar validação é feito no serviço.
isArchived	Booliano	Somente leitura. Se estiver definida como true, a tarefa será arquivada. Uma tarefa arquivada é só de leitura.
isOnMyDay	Booliano	Indica se pretende mostrar esta tarefa na vista MyDay. Se true, mostrará a tarefa.
isOnMyDayLastModifiedDate	Data	Somente leitura. A data em que a tarefa é adicionada ou removida do MyDay.
orderHint	String	A sugestão utilizada para ordenar itens deste tipo numa vista de lista. Para obter mais informações, consulte Utilizar sugestões de ordem no Plannern.
percentComplete	Int32	A percentagem de conclusão da tarefa. Quando definida como 100, a tarefa é concluída.
prioridade	Int32	A prioridade da tarefa. Os valores válidos são entre 0 e 10, inclusive. Os valores maiores indicam uma prioridade mais baixa. Por exemplo, 0 tem a prioridade mais alta e 10 tem a prioridade mais baixa. Atualmente, o Planner interpreta os valores 0 e 1 como "urgentes" 2 e 43 como "importantes", 5, 6e 7 como "médio" e 8, 9e 10 como "baixo". 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	O tipo de pré-visualização que aparece na tarefa. Os valores possíveis são: automatic, noPreview, checklist, description, reference.
recurrence	plannerTaskRecurrence	Define a periodicidade ativa ou inativa para a tarefa. null quando a periodicidade nunca foi definida para a tarefa.
referenceCount	Int32	Número de referências externas existentes na tarefa.
specifiedCompletionRequirements	plannerTaskCompletionRequirements	Indica todos os requisitos especificados no plannerTask. Os valores possíveis são: none, checklistCompletion, unknownFutureValue, formCompletion, approvalCompletion. Somente leitura. Tem de utilizar o cabeçalho do Prefer: include-unknown-enum-members pedido para obter os seguintes valores nesta enumeração evoluível: formCompletion, approvalCompletion. O plannerTaskCompletionRequirementDetails no plannerTaskDetails tem detalhes dos requisitos especificados, se existirem.
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.

plannerTaskCompletionRequirements values (valores plannerTaskCompletionRequirements)

Member	Descrição
none	Sem requisitos.
checklistCompletion	Alguns ou todos os itens da lista de verificação têm de ser verificados.
unknownFutureValue	Valor da sentinela de enumeração evoluível. Não usar.
formCompletion	Alguns ou todos os formulários têm de ser submetidos para concluir a tarefa do planeador.
approvalCompletion	A aprovação é necessária.

Relações

Relação	Tipo	Descrição
assignedToTaskBoardFormat	plannerAssignedToTaskBoardTaskFormat	Somente leitura. Anulável. Utilizado para compor a tarefa corretamente na vista do quadro de tarefas quando agrupada por atribuídoTo.
bucketTaskBoardFormat	plannerBucketTaskBoardTaskFormat	Somente leitura. Anulável. Utilizado para compor a tarefa corretamente na vista do quadro de tarefas quando agrupada por registo.
detalhes	plannerTaskDetails	Somente leitura. Anulável. Mais detalhes sobre a tarefa.
progressTaskBoardFormat	plannerProgressTaskBoardTaskFormat	Somente leitura. Anulável. Utilizado para compor a tarefa corretamente na vista do quadro de tarefas quando agrupada por progresso.

Representação JSON

A representação JSON seguinte 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"
}