Tipo de recurso plannerTask

  • Artículo

Espacio de nombres: microsoft.graph

Representa una tarea de Planner en Microsoft 365. Una tarea de Planner está contenida en un plan y se puede asignar a un cubo de un plan. Cada objeto de tarea tiene un objeto de detalles que puede contener más información sobre la tarea. Para obtener más información sobre las relaciones entre el grupo, el plan y la tarea, consulte Uso de la API REST de Planner.

Métodos

Método Tipo de valor devuelto Descripción
Crear plannerTask Cree un objeto plannerTask .
Get plannerTask Leer las propiedades y las relaciones del objeto plannerTask.
Update plannerTask Actualizar el objeto plannerTask.
Delete Ninguno Eliminar el objeto plannerTask.

Propiedades

Propiedad Tipo Descripción
activeChecklistItemCount Int32 Número de elementos de la lista de comprobación con el valor establecido en false, que representan elementos incompletos.
appliedCategories plannerAppliedCategories Categorías a las que se ha aplicado la tarea. Consulte Categorías aplicadas para ver los valores posibles.
assigneePriority Cadena Sugerencia usada para ordenar elementos de este tipo en una vista de lista. El formato se define como se describe aquí.
assignments plannerAssignments Conjunto de usuarios al que se asigna la tarea.
bucketId Cadena Id. del depósito al que pertenece la tarea. El depósito debe estar en el plan en el que se encuentra la tarea. Tiene 28 caracteres y distingue mayúsculas de minúsculas. La validación del formato se efectúa en el servicio.
checklistItemCount Int32 Número de elementos de lista de comprobación que están presentes en la tarea.
completedBy identitySet Identidad del usuario que ha completado la tarea.
completedDateTime DateTimeOffset Solo lectura. Fecha y hora en que 'percentComplete' de la tarea se establece en '100'. El tipo de marca de tiempo representa la información de fecha y hora con el formato ISO 8601 y está siempre en hora UTC. Por ejemplo, la medianoche en la zona horaria UTC del 1 de enero de 2014 sería 2014-01-01T00:00:00Z.
conversationThreadId String Identificador de subproceso de la conversación en la tarea. Este es el identificador del objeto de subproceso de conversación creado en el grupo.
createdBy identitySet Identidad del usuario que ha creado la tarea.
createdDateTime DateTimeOffset Solo lectura. Fecha y hora en que se crea la tarea. El tipo de marca de tiempo representa la información de fecha y hora con el formato ISO 8601 y está siempre en hora UTC. Por ejemplo, la medianoche en la zona horaria UTC del 1 de enero de 2014 sería 2014-01-01T00:00:00Z.
dueDateTime DateTimeOffset Fecha y hora en que vence la tarea. El tipo de marca de tiempo representa la información de fecha y hora con el formato ISO 8601 y está siempre en hora UTC. Por ejemplo, la medianoche en la zona horaria UTC del 1 de enero de 2014 sería 2014-01-01T00:00:00Z.
hasDescription Boolean Solo lectura. El valor es true si el objeto de detalles de la tarea tiene una descripción no vacía y false de lo contrario.
id Cadena Solo lectura. Id. de la tarea. Tiene 28 caracteres y distingue mayúsculas de minúsculas. La validación del formato se efectúa en el servicio.
orderHint String Sugerencia usada para ordenar elementos de este tipo en una vista de lista. El formato se define como se describe aquí.
percentComplete Int32 Porcentaje de finalización de la tarea. Cuando se establece en 100, la tarea se considera completada.
planId Cadena Id. de plan al que pertenece la tarea.
previewType Cadena Establece el tipo de vista previa que aparece en la tarea. Los valores posibles son: automatic, noPreview, checklist, description, reference.
prioridad Int32 Prioridad de la tarea. El rango de valores válido está entre 0 y 10, siendo el valor creciente de menor prioridad (0 tiene la mayor prioridad y 10 tiene la menor prioridad). Actualmente, Planner interpreta los valores 0 y 1 como "urgente", 2, 3 y 4 como "importante", 5, 6, y 7 como "medio", y 8, 9, y 10 como "bajo". Además, Planner establece el valor 1 para "urgente", 3 para "importante", 5 para "medio" y 9 para "bajo".
referenceCount Int32 Número de referencias externas que existen en la tarea.
startDateTime DateTimeOffset Fecha y hora en que comienza la tarea. El tipo de marca de tiempo representa la información de fecha y hora con el formato ISO 8601 y está siempre en hora UTC. Por ejemplo, la medianoche en la zona horaria UTC del 1 de enero de 2014 sería 2014-01-01T00:00:00Z.
title String Título de la tarea.

Relaciones

Relación Tipo Descripción
assignedToTaskBoardFormat plannerAssignedToTaskBoardTaskFormat Solo lectura. Admite valores NULL. Se usa para representar la tarea correctamente en la vista del panel de tareas cuando se agrupa por assignedTo.
bucketTaskBoardFormat plannerBucketTaskBoardTaskFormat Solo lectura. Admite valores NULL. Se usa para representar la tarea correctamente en la vista del panel de tareas cuando se agrupa por depósito.
detalles plannerTaskDetails Solo lectura. Admite un valor NULL. Más detalles sobre la tarea.
progressTaskBoardFormat plannerProgressTaskBoardTaskFormat Solo lectura. Admite un valor NULL. Se usa para representar la tarea correctamente en la vista del panel de tareas cuando se agrupa por progreso.

Representación JSON

La siguiente representación JSON muestra el 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)",
  "orderHint": "String",
  "percentComplete": "Int32",
  "priority": "Int32",
  "planId": "String",
  "previewType": "String",
  "referenceCount": "Int32",
  "startDateTime": "String (timestamp)",
  "title": "String"
}