Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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.
Actualizar las propiedades de un objeto businessScenarioTask .
Esta API está disponible en las siguientes implementaciones en la nube nacional.
| Servicio global | Administración pública de EE. UU. | Gobierno de EE. UU. L5 (DOD) | China operado por 21Vianet |
|---|---|---|---|
| ✅ | ❌ | ❌ | ❌ |
Permissions
Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use uno o varios permisos con privilegios más altos 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) | BusinessScenarioData.ReadWrite.OwnedBy | No disponible. |
| Delegado (cuenta personal de Microsoft) | No admitida. | No admitida. |
| Aplicación | BusinessScenarioData.ReadWrite.OwnedBy | No disponible. |
Solicitud HTTP
PATCH /solutions/businessScenarios/{businessScenarioId}/planner/tasks/{businessScenarioTaskId}
Encabezados de solicitud
| Nombre | Descripción |
|---|---|
| Authorization | {token} de portador. Obligatorio. Obtenga más información sobre autenticación y autorización. |
| Content-Type | application/json. Obligatorio. |
| If-Match | Último valor de ETag conocido para que businessScenarioTask se actualice. Obligatorio. |
Cuerpo de la solicitud
En el cuerpo de la solicitud, proporcione solo los valores de las propiedades que se van a actualizar. Las propiedades existentes que no están incluidas 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 valores posibles, vea plannerAppliedCategories. Heredado de plannerTask. |
| assigneePriority | Cadena | Sugerencia usada para ordenar elementos de este tipo en una vista de lista. Para obtener más información sobre el formato admitido, consulte Uso de sugerencias de pedido en Planner. Heredado de plannerTask. |
| assignments | plannerAssignments | Conjunto de usuarios al que se asigna la tarea. Heredado de plannerTask. |
| 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. Tiene 28 caracteres y distingue mayúsculas de minúsculas. La validación de formato se realiza en el servicio. Heredado de plannerTask. |
| businessScenarioProperties | businessScenarioProperties | Propiedades específicas del escenario de la tarea. Opcional. |
| conversationThreadId | String | Id. de hilo de conversación de la conversación sobre la tarea. Es el identificador del objeto de conversación creado en el grupo. Heredado de plannerTask. |
| 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. Heredado de plannerTask. |
| orderHint | String | Sugerencia usada para ordenar elementos de este tipo en una vista de lista. Para obtener más información sobre el formato admitido, consulte Uso de sugerencias de pedido en Planner. Heredado de plannerTask. |
| percentComplete | Int32 | Porcentaje de finalización de tareas. Cuando se establece en 100, la tarea se considera completada. Heredado de plannerTask. |
| planId | Cadena | Identificador del plan al que pertenece la tarea. Heredado de plannerTask. |
| prioridad | Int32 | Prioridad de la tarea. El intervalo válido de valores está entre 0 y 10 (inclusive), donde el valor creciente es de menor prioridad (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, 3, y 4 como "importante", 5, 6, y 7 como "medio", y 8, 9, y 10 como "bajo". Actualmente, Planner establece el valor 1 como "urgente", 3 "importante", 5 "medio" y 9 "bajo". Heredado de plannerTask. |
| 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. Heredado de plannerTask. |
| target | businessScenarioTaskTargetBase | Destino de la tarea que especifica dónde se debe colocar la tarea. Opcional. |
| title | String | Título de la tarea. Heredado de plannerTask. |
Respuesta
Si tiene éxito, este método devuelve un 200 OK código de respuesta y un objeto businessScenarioTask actualizado en el cuerpo de la respuesta.
Ejemplos
Solicitud
En el ejemplo siguiente se muestra la solicitud.
PATCH https://graph.microsoft.com/beta/solutions/businessScenarios/c5d514e6c6864911ac46c720affb6e4d/planner/tasks/pmc1rS1Io0C3rXQhyXIsNmUAOeIi
Content-Type: application/json
If-Match: W/"JzEtVGFzayAgQEBAQEBAQEBAQEBAQEBAWCc="
{
"title": "Customer order #12010",
"percentComplete": 20,
"priority": 1,
"businessScenarioProperties": {
"externalObjectVersion": "000003"
}
}
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
{
"@odata.type": "#microsoft.graph.businessScenarioTask",
"title": "Customer order #12010",
"percentComplete": 20,
"priority": 1,
"id": "pmc1rS1Io0C3rXQhyXIsNmUAOeIi",
"target": {
"@odata.type": "microsoft.graph.businessScenarioGroupTarget",
"taskTargetKind": "group",
"groupId": "7a339254-4b2b-4410-b295-c890a16776ee"
},
"businessScenarioProperties": {
"externalObjectId": "Order#12010",
"externalContextId": "Warehouse-CA-36",
"externalObjectVersion": "000003",
"webUrl": "https://ordertracking.contoso.com/view?id=12010",
"externalBucketId": "deliveryBucket"
}
}