Compartir a través de


Actualizar plannerTask

Espacio de nombres: microsoft.graph

Actualice las propiedades del objeto plannerTask .

Esta API está disponible en las siguientes implementaciones nacionales de nube.

Servicio global Gobierno de EE. UU. L4 Us Government L5 (DOD) China operada por 21Vianet

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.

Tipo de permiso Permisos con privilegios mínimos Permisos con privilegios más altos
Delegado (cuenta profesional o educativa) Tasks.ReadWrite Group.ReadWrite.All
Delegado (cuenta personal de Microsoft) No admitida. No admitida.
Aplicación Tasks.ReadWrite.All No disponible.

Solicitud HTTP

PATCH /planner/tasks/{id}

Encabezados de solicitud

Nombre Descripción
Authorization {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización.
Content-Type application/json. Obligatorio.
If-Match Último valor ETag conocido para plannerTask que se va a actualizar. Obligatorio.

Cuerpo de la solicitud

En el cuerpo de la solicitud, únicamente proporcione los valores de las propiedades que deben actualizarse. Las propiedades existentes que no se incluyen en el cuerpo de la solicitud mantienen sus valores anteriores o se recalculan en función de los cambios realizados en otros valores de propiedad.

En la tabla siguiente se especifican las propiedades que se pueden actualizar.

Propiedad Tipo Descripción
appliedCategories plannerAppliedCategories Categorías a las que se ha aplicado la tarea. Para ver los valores posibles, vea appliedCategories.
assigneePriority Cadena Sugerencia usada para ordenar elementos de este tipo en una vista de lista. El formato se define en Uso de sugerencias de orden en Planner.
assignments plannerAssignments Conjunto de usuarios a los que se asigna la tarea.
bucketId Cadena Id. del depósito al que pertenece la tarea. El depósito debe estar en el plan en el que se encuentra la tarea. El valor tiene 28 caracteres y distingue mayúsculas de minúsculas. La validación del formato se efectúa en el servicio.
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.
dueDateTime DateTimeOffset 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 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 Sugerencia usada para ordenar elementos de este tipo en una vista de lista. El formato se define en Uso de sugerencias de orden en Planner.
prioridad Int32 Prioridad de la tarea. El rango de valores válido está entre 0 y 10, siendo el valor creciente de menor prioridad (0 tiene la mayor prioridad y 10 tiene la menor prioridad). Actualmente, Planner interpreta los valores 0 y 1 como "urgente", 2, 3 y 4 como "importante", 5, 6, y 7 como "medio", y 8, 9, y 10 como "bajo". Además, Planner establece el valor 1 para "urgente", 3 para "importante", 5 para "medio" y 9 para "bajo".
percentComplete Int32 Porcentaje de finalización de la tarea. Cuando se establece en 100, la tarea se considera completada.
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.

Nota:

En el caso de las tareas de Project que se replican en Planner, solo se puede actualizar la propiedad percentComplete.

Respuesta

Si se ejecuta correctamente, este método devuelve un 204 No Content código de respuesta y un contenido vacío. Si la solicitud especifica el Prefer encabezado con una return=representation preferencia, este método devuelve un 200 OK código de respuesta y un objeto plannerTask actualizado en el cuerpo de la respuesta.

Este método puede devolver cualquiera de los códigos de estado HTTP. Los errores más comunes que las aplicaciones deben controlar para este método son las respuestas 400, 403, 404, 409 y 412. Para obtener más información sobre estos errores, vea Common Planner error conditions (Condiciones de error habituales de Planner).

Ejemplo

Solicitud

En el ejemplo siguiente se muestra la solicitud.

PATCH https://graph.microsoft.com/v1.0/planner/tasks/{task-id}
Content-type: application/json
Prefer: return=representation
If-Match: W/"JzEtVGFzayAgQEBAQEBAQEBAQEBAQEBAWCc="

{
  "assignments": {
    "fbab97d0-4932-4511-b675-204639209557": {
      "@odata.type": "#microsoft.graph.plannerAssignment",
      "orderHint": "N9917 U2883!"
    }
  },
  "appliedCategories": {
    "category3": true,
    "category4": false
  }
}

Respuesta

En el ejemplo siguiente se muestra la respuesta.

Nota: se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.

HTTP/1.1 200 OK
Content-type: application/json

{
  "createdBy": {
    "user": {
      "id": "6463a5ce-2119-4198-9f2a-628761df4a62"
    }
  },
  "planId": "xqQg5FS2LkCp935s-FIFm2QAFkHM",
  "bucketId": "gcrYAaAkgU2EQUvpkNNXLGQAGTtu",
  "title": "title-value",
  "orderHint": "9223370609546166567W",
  "assigneePriority": "90057581\"",
  "createdDateTime": "2015-03-24T18:36:49.2407981Z",
  "assignments": {
    "6463a5ce-2119-4198-9f2a-628761df4a62": {
      "@odata.type": "#microsoft.graph.plannerAssignment",
      "assignedBy": {
        "user": {
          "id": "6463a5ce-2119-4198-9f2a-628761df4a62"
        }
      },
      "assignedDateTime": "2015-03-25T18:38:21.956Z",
      "orderHint": "N9917"
    },
    "fbab97d0-4932-4511-b675-204639209557": {
      "@odata.type": "#microsoft.graph.plannerAssignment",
      "assignedBy": {
        "user": {
          "id": "1e9955d2-6acd-45bf-86d3-b546fdc795eb"
        }
      },
      "assignedDateTime": "2017-04-24T22:40:44.5665917",
      "orderHint": "RWk1"
    },
    "aaa27244-1db4-476a-a5cb-004607466324": {
      "@odata.type": "#microsoft.graph.plannerAssignment",
      "assignedBy": {
        "user": {
          "id": "6463a5ce-2119-4198-9f2a-628761df4a62"
        }
      },
      "assignedDateTime": "2015-03-25T18:38:21.956Z",
      "orderHint": "U2883"
    }
  },
  "appliedCategories": {
    "category3": true,
    "category5": true,
    "category6": true,
  },
  "id":"01gzSlKkIUSUl6DF_EilrmQAKDhh",
  "priority": 5
}