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 planejador no Microsoft 365. Uma tarefa do planejador 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 planejador.

Métodos

Método Tipo de retorno Descrição
Criar plannerTask Crie um objeto plannerTask .
Get plannerTask Leia as propriedades e relações do objeto plannerTask .
Update plannerTask Atualize um objeto plannerTask .
Delete Nenhum Exclua um objeto plannerTask .
Obter delta Coleção plannerTask Obter 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.
Listar mensagens Coleção plannerTaskChatMessage Obtenha as mensagens de chat associadas a um plannerTask.
Criar mensagem plannerTaskChatMessage Criar uma nova mensagem de chat em uma tarefa do Planner.

Propriedades

Propriedade Tipo Descrição
activeChecklistItemCount Int32 O número de itens da lista de verificação com valor definido falsecomo , representando itens incompletos.
appliedCategories plannerAppliedCategories As categorias às quais a tarefa é aplicada. Confira o tipo de recurso plannerAppliedCategories para obter os valores possíveis.
archiveInfo plannerArchivalInfo Somente leitura. Anulável. Contém informações sobre quem arquivou ou desarquivou a tarefa e por quê.
assigneePriority String Uma dica usada para solicitar itens desse tipo em uma exibição de lista. Para obter mais informações, consulte 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 diferencia maiúsculas de 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 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 da conversa sobre a 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 deve ser concluída. O tipo de carimbo de data/hora 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
goalIds String collection Somente leitura. As IDs das metas associadas à tarefa.
hasChat Booliano Somente leitura. Esse valor é true se a tarefa tem mensagens de chat associadas a ela. Caso contrário, false.
hasDescription Booliano Somente leitura. Esse valor é true se o objeto de detalhes da tarefa tem uma descrição não vazia. Caso contrário, false.
id String Somente leitura. O identificador exclusivo da tarefa. O valor dessa propriedade tem 28 caracteres e diferencia maiúsculas de minúsculas. Formatar validação é feito no serviço.
isArchived Booliano Somente leitura. Se definido como true, a tarefa é arquivada. Uma tarefa arquivada é somente leitura.
isOnMyDay Booliano Indica se essa tarefa deve ser mostrada no modo de exibição MyDay. Se true, mostra a tarefa.
isOnMyDayLastModifiedDate Data Somente leitura. A data em que a tarefa é adicionada ou removida de MyDay.
lastModifiedBy identitySet Somente leitura. ID do usuário pela qual foi modificada pela última vez.
lastModifiedDateTime DateTimeOffset Somente leitura. Data e hora em que isto é modificado pela última vez. 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
orderHint String A dica usada para ordenar itens desse tipo em uma exibição de lista. Para obter mais informações, consulte Usando dicas de pedido no Planner.
percentComplete Int32 A porcentagem de conclusão da tarefa. Quando definido como 100, a tarefa é concluída.
prioridade Int32 A prioridade da tarefa. Os valores válidos estão entre 0 e 10, inclusive. Valores maiores indicam prioridade mais baixa. Por exemplo, 0 tem a prioridade mais alta e 10 tem a prioridade mais baixa. Atualmente, o planejador interpreta valores 0 e 1 como "urgente", 2 e 3 como 4 "importante", 5, 6, e 7 como "médio", e 8, 9, e 10 como "baixo". Atualmente, o planejador 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 foi definida para a tarefa.
referenceCount Int32 Número de referências externas existentes na tarefa.
specifiedCompletionRequirements plannerTaskCompletionRequirements Indica todos os requisitos especificados em plannerTask. Os valores possíveis são: none, checklistCompletion, unknownFutureValue, formCompletion, approvalCompletion. Somente leitura. Use o cabeçalho da Prefer: include-unknown-enum-members solicitação para obter os seguintes valores nesta enumeração evolutiva: formCompletion, approvalCompletion. O plannerTaskCompletionRequirementDetails em 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 de plannerTaskCompletionRequirements

Member Descrição
none Nenhum requisito.
checklistCompletion Alguns ou todos os itens da lista de verificação devem ser verificados.
unknownFutureValue Valor sentinela de enumeração evolutiva. Não usar.
formCompletion Alguns ou todos os formulários devem ser enviados para concluir a tarefa do planejador.
approvalCompletion A aprovação é necessária.

Relações

Relação Tipo Descrição
assignedToTaskBoardFormat plannerAssignedToTaskBoardTaskFormat Somente leitura. Anulável. Usado para renderizar a tarefa corretamente no modo de exibição Painel de tarefas quando agrupado por assignedTo.
bucketTaskBoardFormat plannerBucketTaskBoardTaskFormat Somente leitura. Anulável. Usado para renderizar a tarefa corretamente no modo de exibição Painel de tarefas quando agrupado por bucket.
detalhes plannerTaskDetails Somente leitura. Anulável. Mais detalhes sobre a tarefa.
messages Coleção plannerTaskChatMessage Somente leitura. Anulável. Mensagens de Chat associadas à tarefa.
progressTaskBoardFormat plannerProgressTaskBoardTaskFormat Somente leitura. Anulável. Usado para renderizar a tarefa corretamente no modo de exibição Painel de tarefas quando agrupada por 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)",
  "goalIds": ["String"],
  "hasChat": "Boolean",
  "hasDescription": "Boolean",
  "id": "String (identifier)",
  "isOnMyDay": "Boolean",
  "isOnMyDayLastModifiedDate": "Date",
  "lastModifiedBy": {"@odata.type": "microsoft.graph.identitySet"},
  "lastModifiedDateTime": "String (timestamp)",
  "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"
}
  • Last updated on