Tipo de recurso plannerTask

Espacio de nombres: microsoft.graph

Representa una tarea 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
Get plannerTask	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 valores NULL. Más detalles sobre la tarea.
progressTaskBoardFormat	plannerProgressTaskBoardTaskFormat	Solo lectura. Admite valores 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"
}