Tipo de recurso de tarea

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.

Una tarea de Planner V4. planId Enruta la tarea de nuevo a su plan primario. A diferencia de la división plannerTask/plannerTaskDetails V3, una tarea V4 no tiene un objeto de detalles independiente: la descripción, las notas, la lista de comprobación, las tareas y los vínculos son propiedades y subcolecciones directamente en la tarea.

Hereda de plannerDelta.

Métodos

Método Tipo devuelto Descripción
List Colección de tareas Obtenga una lista de los objetos de tarea y sus propiedades.
Crear task Crear un nuevo objeto de tarea.
Get task Lea las propiedades y relaciones del objeto de tarea .
Actualizar task Actualizar las propiedades de un objeto de tarea.
Delete Ninguno Eliminar un objeto de tarea.
Lista de comprobación Colección checklistItemV4 Obtenga una lista de los objetos checklistItemV4 y sus propiedades.
Crear lista de comprobaciónItemV4 checklistItemV4 Cree un nuevo objeto checklistItemV4.
List customFieldValues Colección customFieldValue Obtener una lista de los objetos customFieldValue y sus propiedades.
Crear customFieldValue customFieldValue Cree un nuevo objeto customFieldValue.
Enumerar vínculos Colección de enlaces de contenido Obtener una lista de los objetos contentLink y sus propiedades.
Crear vínculo de contenido contentLink Crear un nuevo objeto contentLink.
Enumerar mensajes colección plannerChatMessage Obtener una lista de los objetos plannerChatMessage y sus propiedades.
Crear plannerChatMessage plannerChatMessage Crea un nuevo objeto plannerChatMessage.
Enumerar userAssignments Colección userAssignment Obtener una lista de los objetos userAssignment y sus propiedades.
Crear userAssignment userAssignment Cree un nuevo objeto UserAssignment.

Propiedades

Propiedad Tipo Description
archivalInfo plannerArchivalInfo Información acerca de si la entidad está archivada y cuándo se archivó.
bucketId Cadena Identificador del cubo al que pertenece la tarea.
capabilities taskCapability Indicadores de funcionalidad de solo lectura calculados por el servidor que indican qué características opcionales están habilitadas para la entidad.
completedBy identitySet Identidad del usuario que marcó la tarea como completada.
completedDateTime DateTimeOffset Fecha y hora en que se completó la tarea.
creationInfo creationInfo Metadatos de creación de solo lectura para la entidad.
displayName String Título de la tarea.
dueDateTime dateWithOptionalTime Fecha y, opcionalmente, hora de vencimiento de la tarea.
extensions extensionFieldCollection Valores de campo de extensión personalizados establecidos en la entidad. Admite $select.
finishDateTime dateWithOptionalTime Fecha y, opcionalmente, hora en que finalizó la tarea.
goalIds Colección string Identificadores de los objetivos asociados a la tarea.
tiene chat Booleano Indica si la tarea tiene un chat asociado.
tiene hijos Booleano Indica si la tarea tiene subtareas.
id Cadena El identificador único de la entidad. Solo lectura. Heredado de entidad
isCritical Booleano Indica si la tarea está en la ruta crítica, tal y como se calcula a partir de sus dependencias.
lastModifiedBy identitySet Identidad del usuario (o aplicación) que modificó por última vez la entidad. Solo lectura.
lastModifiedDateTime DateTimeOffset Fecha y hora en que se modificó por última vez la entidad. El valor se representa en formato ISO 8601 y siempre está en hora UTC. Solo lectura.
notas itemBody Detalles o notas adicionales sobre la tarea.
parentTaskId Cadena Identificador de la tarea principal, si es una subtarea.
percentComplete Int32 Porcentaje de finalización de la tarea, que va de 0 a 100.
vista personal taskPersonalView Configuración de la vista personal por usuario para la tarea, como la suscripción a Mi día.
planId Cadena Identificador del plan que contiene la tarea. Inmutable después de la creación.
planView taskPlanView Configuración de vista de tareas con ámbito del plan, como los identificadores de categoría aplicados.
prioridad Int32 Prioridad de la tarea. Los valores admitidos van de 0 (urgente) a 10 (bajo).
recurrence plannerTaskPeriodence Patrón de periodicidad de la tarea, si se repite.
startDateTime dateWithOptionalTime Fecha y, opcionalmente, la hora en que está programada el inicio de la tarea.
status plannerTaskStatus Indica el progreso de la tarea. Los valores posibles son: notStarted, inProgress, completed, blocked, unknownFutureValue.

Relaciones

Relación Tipo Description
lista de comprobación Colección checklistItemV4 La colección de elementos de la lista de comprobación de la tarea. Solo lectura. Admite valores NULL.
customFieldValues Colección customFieldValue Colección de valores de campo personalizado establecidos en la tarea. Solo lectura. Admite valores NULL.
links Colección de enlaces de contenido La colección de vínculos de contenido adjuntos a la tarea. Solo lectura. Admite valores NULL.
messages colección plannerChatMessage La colección de mensajes de chat asociados a la tarea. Solo lectura. Admite valores NULL.
userAssignments Colección userAssignment Colección de asignaciones de usuarios en la tarea. Solo lectura. Admite valores NULL.

Representación JSON

La siguiente representación JSON muestra el tipo de recurso.

{
  "@odata.type": "#microsoft.graph.task",
  "id": "String (identifier)",
  "displayName": "String",
  "planId": "String",
  "bucketId": "String",
  "goalIds": [
    "String"
  ],
  "status": "String",
  "priority": "Int32",
  "percentComplete": "Int32",
  "startDateTime": {
    "@odata.type": "microsoft.graph.dateWithOptionalTime"
  },
  "dueDateTime": {
    "@odata.type": "microsoft.graph.dateWithOptionalTime"
  },
  "finishDateTime": {
    "@odata.type": "microsoft.graph.dateWithOptionalTime"
  },
  "notes": {
    "@odata.type": "microsoft.graph.itemBody"
  },
  "creationInfo": {
    "@odata.type": "microsoft.graph.creationInfo"
  },
  "lastModifiedBy": {
    "@odata.type": "microsoft.graph.identitySet"
  },
  "lastModifiedDateTime": "String (timestamp)",
  "completedBy": {
    "@odata.type": "microsoft.graph.identitySet"
  },
  "completedDateTime": "String (timestamp)",
  "recurrence": {
    "@odata.type": "microsoft.graph.plannerTaskRecurrence"
  },
  "archivalInfo": {
    "@odata.type": "microsoft.graph.plannerArchivalInfo"
  },
  "planView": {
    "@odata.type": "microsoft.graph.taskPlanView"
  },
  "personalView": {
    "@odata.type": "microsoft.graph.taskPersonalView"
  },
  "parentTaskId": "String",
  "hasChildren": "Boolean",
  "isCritical": "Boolean",
  "hasChat": "Boolean",
  "capabilities": {
    "@odata.type": "microsoft.graph.taskCapability"
  },
  "extensions": {
    "@odata.type": "microsoft.graph.extensionFieldCollection"
  }
}
  • Se actualizó por última vez el