Compartir a través de


Tipo de recurso plannerTask

Espacio de nombres: microsoft.graph

Importante

Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.

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 Lea las propiedades y relaciones del objeto plannerTask .
Update plannerTask Actualizar un objeto plannerTask .
Delete Ninguno Elimine un objeto plannerTask .
Obtener delta Colección plannerTask Obtenga objetos plannerTask recién creados, actualizados o eliminados en un plannerPlan o asignados al usuario que ha iniciado sesión sin tener que realizar una lectura completa de toda la colección de recursos.

Propiedades

Propiedad Tipo Descripción
activeChecklistItemCount Int32 Número de elementos de lista de comprobación con el valor establecido en false, que representa elementos incompletos.
appliedCategories plannerAppliedCategories Categorías a las que se aplica la tarea. Consulte plannerAppliedCategories resource type (Tipo de recurso plannerAppliedCategories ) para ver los valores posibles.
archivalInfo plannerArchivalInfo Solo lectura. Admite valores NULL. Contiene información sobre quién archivó o desarchó la tarea y por qué.
assigneePriority Cadena Sugerencia que se usa para ordenar elementos de este tipo en una vista de lista. Para obtener más información, consulte Uso de sugerencias de pedido en Planner.
assignments plannerAssignments Conjunto de usuarios al que se asigna la tarea.
bucketId Cadena Id. del depósito al que pertenece la tarea. El cubo debe estar en el mismo plan que la tarea. El valor de la propiedad bucketId 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 completó la tarea.
completedDateTime DateTimeOffset Solo lectura. Fecha y hora a la que el 'percentComplete' objeto 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 creó la tarea.
createdDateTime DateTimeOffset Solo lectura. Fecha y hora a la 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.
creationSource plannerTaskCreation Información sobre el origen de la tarea.
dueDateTime DateTimeOffset Fecha y hora a la 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 está 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. Este valor es true si el objeto de detalles de la tarea tiene una descripción no vacía. De lo contrario,false .
id Cadena Solo lectura. Identificador único de la tarea. El valor de esta propiedad tiene 28 caracteres y distingue mayúsculas de minúsculas. La validación del formato se efectúa en el servicio.
isArchived Booleano Solo lectura. Si se establece en true, la tarea se archiva. Una tarea archivada es de solo lectura.
isOnMyDay Booleano Indica si se va a mostrar esta tarea en la vista MyDay. Si truees , se muestra la tarea.
isOnMyDayLastModifiedDate Fecha Solo lectura. Fecha en la que se agrega o quita la tarea de MyDay.
orderHint String Sugerencia usada para ordenar elementos de este tipo en una vista de lista. Para obtener más información, consulte Uso de sugerencias de pedido en plannern.
percentComplete Int32 Porcentaje de finalización de la tarea. Cuando se establece en 100, se completa la tarea.
prioridad Int32 Prioridad de la tarea. Los valores válidos están entre 0 y 10, ambos incluidos. Los valores más grandes indican una prioridad menor. Por ejemplo, 0 tiene la prioridad más alta y 10 tiene la prioridad más baja. Actualmente, planner interpreta los valores 0 como 1 "urgentes", 2 y 34 como "importantes", 5, 6y 7 como "medio", y 8, 9y 10 como "bajo". Actualmente, planner establece el valor 1 de "urgente", 3 "importante", 5 "medio" y 9 "bajo".
planId Cadena Id. de plan al que pertenece la tarea.
previewType Cadena Tipo de vista previa que aparece en la tarea. Los valores posibles son: automatic, noPreview, checklist, description y reference.
recurrence plannerTaskRecurrence Define la periodicidad activa o inactiva para la tarea. null cuando la periodicidad nunca se ha definido para la tarea.
referenceCount Int32 Número de referencias externas que existen en la tarea.
specifiedCompletionRequirements plannerTaskCompletionRequirements Indica todos los requisitos especificados en plannerTask. Los valores posibles son: none, checklistCompletion, unknownFutureValue, formCompletion y approvalCompletion. Solo lectura. Debe usar el encabezado de Prefer: include-unknown-enum-members solicitud para obtener los siguientes valores en esta enumeración evolvable: formCompletion, approvalCompletion. PlannerTaskCompletionRequirementDetails de plannerTaskDetails tiene detalles de los requisitos especificados, si los hay.
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.

valores plannerTaskCompletionRequirements

Member Descripción
ninguno No es necesario.
checklistCompletion Algunos o todos los elementos de lista de comprobación deben comprobarse.
unknownFutureValue Valor de sentinel de enumeración evolvable. No usar.
formCompletion Algunos o todos los formularios deben enviarse para completar la tarea del planificador.
approvalCompletion Se requiere aprobación.

Relaciones

Relación Tipo Descripción
assignedToTaskBoardFormat plannerAssignedToTaskBoardTaskFormat Solo lectura. Admite un valor 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 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)",
  "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"
}