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"
}