Tipo de recurso plannerTaskplannerTask resource type

El recurso plannerTask representa un plan de Office 365. Una tarea de Planner está contenida en una plan y puede asignarse a un depósito en un plan. Cada objeto de la tarea tiene un objeto details (detalles), que puede contener más información sobre la tarea. Vea Resumen para obtener más información sobre las relaciones entre grupo, plan y tarea.The plannerTask resource represents a Planner task in Office 365. A Planner task is contained in a plan and can be assigned to a bucket in a plan. Each task object has a details object which can contain more information about the task. See overview for more information regarding relationships between group, plan and task.

MétodosMethods

MétodoMethod Tipo de valor devueltoReturn Type DescripciónDescription
Get plannerTaskGet plannerTask plannerTaskplannerTask Leer las propiedades y las relaciones del objeto plannerTask.Read properties and relationships of plannerTask object.
UpdateUpdate plannerTaskplannerTask Actualizar el objeto plannerTask.Update plannerTask object.
DeleteDelete NingunoNone Eliminar el objeto plannerTask.Delete plannerTask object.

PropiedadesProperties

PropiedadProperty TipoType DescripciónDescription
activeChecklistItemCountactiveChecklistItemCount Int32Int32 Número de elementos de la lista de comprobación con el valor establecido en false, que representan elementos incompletos.Number of checklist items with value set to false, representing incomplete items.
appliedCategoriesappliedCategories plannerAppliedCategoriesplannerAppliedCategories Categorías a las que se ha aplicado la tarea. Consulte las categorías aplicadas para ver los posibles valores.The categories to which the task has been applied. See applied Categories for possible values.
assigneePriorityassigneePriority CadenaString Sugerencia que se usa para ordenar los elementos de este tipo en una vista de lista. El formato se define tal como se describe aquí.Hint used to order items of this type in a list view. The format is defined as outlined here.
assignmentsassignments plannerAssignmentsplannerAssignments Conjunto de usuarios al que se asigna la tarea.The set of assignees the task is assigned to.
bucketIdbucketId CadenaString Id. del depósito al que pertenece la tarea.Bucket ID to which the task belongs. El depósito debe estar en el plan en el que se encuentra la tarea.The bucket needs to be in the plan that the task is in. Tiene 28 caracteres y distingue entre mayúsculas y minúsculas.It is 28 characters long and case-sensitive. La validación del formato se efectúa en el servicio.Format validation is done on the service.
checklistItemCountchecklistItemCount Int32Int32 Número de elementos de lista de comprobación que están presentes en la tarea.Number of checklist items that are present on the task.
completedBycompletedBy identitySetidentitySet Identidad del usuario que ha completado la tarea.Identity of the user that completed the task.
completedDateTimecompletedDateTime DateTimeOffsetDateTimeOffset 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 siempre pertenecen a la zona horaria UTC. Por ejemplo, la medianoche UTC del 1 de enero de 2014 sería así: '2014-01-01T00:00:00Z'Read-only. Date and time at which the 'percentComplete' of the task is set to '100'. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'
conversationThreadIdconversationThreadId StringString Id. de subproceso de la conversación en la tarea. Es el id. del objeto de subproceso de conversación creado en el grupo.Thread ID of the conversation on the task. This is the ID of the conversation thread object created in the group.
createdBycreatedBy identitySetidentitySet Identidad del usuario que ha creado la tarea.Identity of the user that created the task.
createdDateTimecreatedDateTime DateTimeOffsetDateTimeOffset 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 siempre pertenecen a la zona horaria UTC. Por ejemplo, la medianoche UTC del 1 de enero de 2014 sería así: '2014-01-01T00:00:00Z'Read-only. Date and time at which the task is created. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'
dueDateTimedueDateTime DateTimeOffsetDateTimeOffset 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 siempre pertenece a la zona horaria UTC. Por ejemplo, la medianoche en la zona horaria UTC del 1 de enero de 2014 sería así: '2014-01-01T00:00:00Z'Date and time at which the task is due. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'
hasDescriptionhasDescription BooleanBoolean Solo lectura. El valor es true si el objeto de detalles de la tarea tiene una descripción que no está vacía y false lo contrario.Read-only. Value is true if the details object of the task has a non-empty description and false otherwise.
idid CadenaString Solo lectura.Read-only. Id. de la tarea.ID of the task. Tiene 28 caracteres y distingue entre mayúsculas y minúsculas.It is 28 characters long and case-sensitive. La validación del formato se efectúa en el servicio.Format validation is done on the service.
orderHintorderHint StringString Sugerencia que se usa para ordenar los elementos de este tipo en una vista de lista. El formato se define tal como se describe aquí.Hint used to order items of this type in a list view. The format is defined as outlined here.
percentCompletepercentComplete Int32Int32 Porcentaje de finalización de la tarea. Si se establece en 100, la tarea se considera finalizada.Percentage of task completion. When set to 100, the task is considered completed.
planIdplanId CadenaString Id. de plan al que pertenece la tarea.Plan ID to which the task belongs.
previewTypepreviewType CadenaString Establece el tipo de vista previa que aparece en la tarea.This sets the type of preview that shows up on the task. Los valores posibles son: automatic, noPreview, checklist, description, reference.The possible values are: automatic, noPreview, checklist, description, reference.
referenceCountreferenceCount Int32Int32 Número de referencias externas que existen en la tarea.Number of external references that exist on the task.
startDateTimestartDateTime DateTimeOffsetDateTimeOffset 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 siempre pertenecen a la zona horaria UTC. Por ejemplo, la medianoche UTC del 1 de enero de 2014 sería así: '2014-01-01T00:00:00Z'Date and time at which the task starts. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'
titletitle StringString Título de la tarea.Title of the task.

RelacionesRelationships

RelaciónRelationship TipoType DescripciónDescription
assignedToTaskBoardFormatassignedToTaskBoardFormat plannerAssignedToTaskBoardTaskFormatplannerAssignedToTaskBoardTaskFormat Solo lectura. Admite valores NULL. Se utiliza para representar la tarea correctamente en la vista del panel de la tarea cuando se agrupan por assignedTo.Read-only. Nullable. Used to render the task correctly in the task board view when grouped by assignedTo.
bucketTaskBoardFormatbucketTaskBoardFormat plannerBucketTaskBoardTaskFormatplannerBucketTaskBoardTaskFormat Solo lectura. Admite valores NULL. Se utiliza para representar la tarea correctamente en la vista del panel de la tarea cuando se agrupan por depósito.Read-only. Nullable. Used to render the task correctly in the task board view when grouped by bucket.
detallesdetails plannerTaskDetailsplannerTaskDetails Solo lectura. Admite valores NULL. Detalles adicionales sobre la tarea.Read-only. Nullable. Additional details about the task.
progressTaskBoardFormatprogressTaskBoardFormat plannerProgressTaskBoardTaskFormatplannerProgressTaskBoardTaskFormat Solo lectura. Admite valores NULL. Se utiliza para representar la tarea correctamente en la vista del panel de la tarea cuando se agrupan por progreso.Read-only. Nullable. Used to render the task correctly in the task board view when grouped by progress.

Representación JSONJSON representation

Aquí tiene una representación JSON del recurso.Here is a JSON representation of the resource.

{
  "activeChecklistItemCount": 1024,
  "appliedCategories": {"@odata.type": "microsoft.graph.plannerAppliedCategories"},
  "assigneePriority": "String",
  "assignments": {"@odata.type": "microsoft.graph.plannerAssignments"},
  "bucketId": "String",
  "checklistItemCount": 1024,
  "completedBy": {"@odata.type": "microsoft.graph.identitySet"},
  "completedDateTime": "String (timestamp)",
  "conversationThreadId": "String",
  "createdBy": {"@odata.type": "microsoft.graph.identitySet"},
  "createdDateTime": "String (timestamp)",
  "dueDateTime": "String (timestamp)",
  "hasDescription": true,
  "id": "String (identifier)",
  "orderHint": "String",
  "percentComplete": 1024,
  "planId": "String",
  "previewType": "String",
  "referenceCount": 1024,
  "startDateTime": "String (timestamp)",
  "title": "String"
}