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 planificador en Microsoft 365. Una tarea de Planner está contenida en un plan y se puede asignar a un cubo en un plan. Cada objeto de tarea tiene un objeto details 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 de REST de Planner.

Métodos

Método Tipo de valor devuelto Descripción
Crear plannerTask Crear un objeto plannerTask .
Get plannerTask Lee las propiedades y relaciones del objeto plannerTask .
Update plannerTask Actualizar un objeto plannerTask .
Delete Ninguno Eliminar un objeto plannerTask .
Obtener delta Colección plannerTask Obtenga objetos plannerTask recién creados, actualizados o eliminados en un plan de planificación o asignados al usuario que ha iniciado sesión sin tener que realizar una lectura completa de toda la colección de recursos.
Enumerar mensajes colección plannerTaskChatMessage Obtener los mensajes de chat asociados a un plannerTask.
Crear mensaje plannerTaskChatMessage Crear un mensaje de chat en una tarea de Planner.

Propiedades

Propiedad Tipo Descripción
activeChecklistItemCount Int32 El 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 aplica la tarea. Consulte el tipo de recurso plannerAppliedCategories para ver los valores posibles.
archivalInfo plannerArchivalInfo Solo lectura. Admite valores NULL. Contiene información sobre quién archivó o desarchivó la tarea y por qué.
assigneePriority Cadena Una sugerencia que se utiliza 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 El número de elementos de la lista de comprobación que están presentes en la tarea.
completedBy identitySet Identidad del usuario que completó la tarea.
completedDateTime DateTimeOffset Solo lectura. La fecha y hora en que la 'percentComplete' 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 El Id. de conversación de la conversación sobre la tarea. Es el identificador del objeto de conversación creado en el grupo.
createdBy identitySet Identidad del usuario que creó la tarea.
createdDateTime DateTimeOffset Solo lectura. La 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.
origen de creación plannerTaskCreation Información sobre el origen de la tarea.
dueDateTime DateTimeOffset La 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 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.
goalIds Colección string Solo lectura. Identificadores de los objetivos asociados a la tarea.
tiene chat Booleano Solo lectura. Este valor es true si la tarea tiene mensajes de chat asociados. De lo contrario, false.
hasDescription Boolean Solo lectura. Este valor es true si el objeto details 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 quiere mostrar esta tarea en la vista MyDay. Si true, muestra la tarea.
isOnMyDayLastModifiedDate Fecha Solo lectura. Fecha en la que se agrega o quita la tarea de MyDay.
lastModifiedBy identitySet Solo lectura. Identificador de usuario con el que se modifica por última vez.
lastModifiedDateTime DateTimeOffset Solo lectura. Fecha y hora en que se modificó por última vez. 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.
orderHint String La 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 Planner.
percentComplete Int32 Porcentaje de finalización de tareas. Cuando se establece en 100, la tarea se completa.
prioridad Int32 La prioridad de la tarea. Los valores válidos están entre 0 y 10, inclusive. Los valores mayores indican una prioridad más baja. 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 "urgente", 2 y como 4 "importante", 5, 36, y 7 como "medio", y 8, 9, y 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 El tipo de vista previa que aparece en la tarea. Los valores posibles son: automatic, noPreview, checklist, description, reference.
recurrence plannerTaskPeriodence Define la periodicidad activa o inactiva de 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, approvalCompletion. Solo lectura. Use el encabezado de Prefer: include-unknown-enum-members solicitud para obtener los siguientes valores en esta enumeración evolutiva: formCompletion, approvalCompletion. plannerTaskCompletionRequirementDetails en 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 de plannerTaskCompletionRequirements

Member Descripción
ninguno No hay requisitos.
checklistCompletion Es necesario comprobar algunos o todos los elementos de la lista de comprobación.
unknownFutureValue Valor centinela de enumeración evolutiva. No usar.
formCompletion Algunos o todos los formularios deben enviarse para completar la tarea de planificador.
approvalCompletion Se requiere aprobación.

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 cubo.
detalles plannerTaskDetails Solo lectura. Admite valores NULL. Más detalles sobre la tarea.
messages colección plannerTaskChatMessage Solo lectura. Admite valores NULL. Mensajes de chat asociados a 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)",
  "goalIds": ["String"],
  "hasChat": "Boolean",
  "hasDescription": "Boolean",
  "id": "String (identifier)",
  "isOnMyDay": "Boolean",
  "isOnMyDayLastModifiedDate": "Date",
  "lastModifiedBy": {"@odata.type": "microsoft.graph.identitySet"},
  "lastModifiedDateTime": "String (timestamp)",
  "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"
}
  • Last updated on