tipo de recurso de tarefa

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.

Uma tarefa do Planner V4. planId Encaminha a tarefa de volta para seu plano pai. Ao contrário da divisão plannerTask/plannerTaskDetails V3, uma tarefa V4 não tem nenhum objeto de detalhes separado - descrição, notas, lista de verificação, atribuições e links são propriedades e subcoleções diretamente na tarefa.

Herda de plannerDelta.

Métodos

Método Tipo de retorno Descrição
List Coleção de tarefas Obtenha uma lista dos objetos de tarefa e suas propriedades.
Create task Crie um novo objeto de tarefa.
Get task Leia as propriedades e relações do objeto de tarefa .
Atualizar task Atualizar as propriedades de um objeto de tarefa.
Delete Nenhum Exclua um objeto de tarefa.
Lista de verificação coleção checklistItemV4 Obtenha uma lista dos objetos checklistItemV4 e suas propriedades.
Criar checklistItemV4 checklistItemV4 Criar um novo objeto checklistItemV4.
Listar customFieldValues Coleção customFieldValue Obtenha uma lista dos objetos customFieldValue e suas propriedades.
Create customFieldValue customFieldValue Crie um novo objeto customFieldValue.
Links de lista coleção contentLink Obtenha uma lista dos objetos contentLink e suas propriedades.
Criar contentLink contentLink Crie um novo objeto contentLink.
Listar mensagens Coleção plannerChatMessage Obtenha uma lista dos objetos plannerChatMessage e suas propriedades.
Criar plannerChatMessage plannerChatMessage Crie um novo objeto plannerChatMessage.
Listar userAssignments Coleção userAssignment Obtenha uma lista dos objetos userAssignment e suas propriedades.
Criar userAssignment userAssignment Crie um novo objeto userAssignment.

Propriedades

Propriedade Tipo Descrição
archiveInfo plannerArchivalInfo Informações sobre se a entidade está arquivada e quando foi arquivada.
bucketId String ID do bucket ao qual a tarefa pertence.
capabilities taskCapability Sinalizadores de capacidade somente leitura e computação do servidor que indicam quais recursos opcionais estão habilitados para a entidade.
completedBy identitySet Identidade do usuário que marcou a tarefa como concluída.
completedDateTime DateTimeOffset Data e hora em que a tarefa foi concluída.
creationInfo creationInfo Metadados de criação somente leitura para a entidade.
displayName String Título da tarefa.
dueDateTime dateWithOptionalTime Data e, opcionalmente, hora em que a tarefa deve ser concluída.
extensions extensionFieldCollection Valores do campo de extensão personalizados definidos na entidade. Suporta $select.
finishDateTime dateWithOptionalTime Data e, opcionalmente, hora em que a tarefa foi concluída.
goalIds String collection IDs das metas às quais a tarefa está associada.
hasChat Booliano Indica se a tarefa tem um chat associado.
hasChildren Booliano Indica se a tarefa tem subtarefas.
id Cadeia de caracteres Identificador exclusivo da entidade. Somente leitura. Herdado da entidade
isCritical Booliano Indica se a tarefa está no caminho crítico, conforme calculado a partir de suas dependências.
lastModifiedBy identitySet Identidade do usuário (ou aplicativo) que modificou a entidade pela última vez. Somente leitura.
lastModifiedDateTime DateTimeOffset Data e hora em que a entidade foi modificada pela última vez. O valor é representado no formato ISO 8601 e está sempre no horário UTC. Somente leitura.
notes itemBody Detalhes ou anotações adicionais sobre a tarefa.
parentTaskId Cadeia de caracteres ID da tarefa pai, se essa tarefa for uma subtarefa.
percentComplete Int32 Porcentagem de conclusão da tarefa, variando de 0 a 100.
personalView taskPersonalView Configurações de exibição pessoal por usuário para a tarefa, como a associação do Meu Dia.
planId String ID do plano que contém a tarefa. Imutável após a criação.
planView taskPlanView Configurações de exibição de tarefas com escopo para o plano, como IDs de categoria aplicadas.
prioridade Int32 Prioridade da tarefa. Os valores com suporte variam de 0 (urgente) a 10 (baixo).
recurrence plannerTaskRecurrence Padrão de recorrência da tarefa, se ela se repetir.
startDateTime dateWithOptionalTime Data e, opcionalmente, hora em que a tarefa está agendada para iniciar.
status plannerTaskStatus Indica o progresso da tarefa. Os valores possíveis são: notStarted, inProgress, completed, blocked, unknownFutureValue.

Relações

Relação Tipo Descrição
Lista de verificação coleção checklistItemV4 A coleção de itens da lista de verificação na tarefa. Somente leitura. Anulável.
customFieldValues Coleção customFieldValue A coleção de valores de campos personalizados definidos na tarefa. Somente leitura. Anulável.
links coleção contentLink A coleção de links de conteúdo anexados à tarefa. Somente leitura. Anulável.
messages Coleção plannerChatMessage A coleção de mensagens de chat associadas à tarefa. Somente leitura. Anulável.
userAssignments Coleção userAssignment A coleção de atribuições de usuário na tarefa. Somente leitura. Anulável.

Representação JSON

A representação JSON a seguir mostra o tipo de recurso.

{
  "@odata.type": "#microsoft.graph.task",
  "id": "String (identifier)",
  "displayName": "String",
  "planId": "String",
  "bucketId": "String",
  "goalIds": [
    "String"
  ],
  "status": "String",
  "priority": "Int32",
  "percentComplete": "Int32",
  "startDateTime": {
    "@odata.type": "microsoft.graph.dateWithOptionalTime"
  },
  "dueDateTime": {
    "@odata.type": "microsoft.graph.dateWithOptionalTime"
  },
  "finishDateTime": {
    "@odata.type": "microsoft.graph.dateWithOptionalTime"
  },
  "notes": {
    "@odata.type": "microsoft.graph.itemBody"
  },
  "creationInfo": {
    "@odata.type": "microsoft.graph.creationInfo"
  },
  "lastModifiedBy": {
    "@odata.type": "microsoft.graph.identitySet"
  },
  "lastModifiedDateTime": "String (timestamp)",
  "completedBy": {
    "@odata.type": "microsoft.graph.identitySet"
  },
  "completedDateTime": "String (timestamp)",
  "recurrence": {
    "@odata.type": "microsoft.graph.plannerTaskRecurrence"
  },
  "archivalInfo": {
    "@odata.type": "microsoft.graph.plannerArchivalInfo"
  },
  "planView": {
    "@odata.type": "microsoft.graph.taskPlanView"
  },
  "personalView": {
    "@odata.type": "microsoft.graph.taskPersonalView"
  },
  "parentTaskId": "String",
  "hasChildren": "Boolean",
  "isCritical": "Boolean",
  "hasChat": "Boolean",
  "capabilities": {
    "@odata.type": "microsoft.graph.taskCapability"
  },
  "extensions": {
    "@odata.type": "microsoft.graph.extensionFieldCollection"
  }
}
  • Última atualização a