Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
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 |
|---|---|---|
| Criar | plannerTask | Crie um objeto plannerTask . |
| Get | plannerTask | Leia as propriedades e relações do objeto plannerTask . |
| Update | plannerTask | Atualizar um objeto plannerTask . |
| Delete | 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. Utilize 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"
}