Atualizar businessScenarioTask

Namespace: microsoft.graph

Importante

As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.

Atualize as propriedades de um objeto businessScenarioTask .

Essa API está disponível nas seguintes implantações de nuvem nacional.

Serviço global Governo dos EUA L4 US Government L5 (DOD) China operada pela 21Vianet

Permissões

Escolha a(s) permissão(s) marcada(s) como menos privilegiada(s) para essa API. Use uma permissão ou permissões com privilégios mais altos somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.

Tipo de permissão Permissões menos privilegiadas Permissões com privilégios mais elevados
Delegado (conta corporativa ou de estudante) BusinessScenarioData.ReadWrite.OwnedBy Indisponível.
Delegado (conta pessoal da Microsoft) Sem suporte. Sem suporte.
Application BusinessScenarioData.ReadWrite.OwnedBy Indisponível.

Solicitação HTTP

PATCH /solutions/businessScenarios/{businessScenarioId}/planner/tasks/{businessScenarioTaskId}

Cabeçalhos de solicitação

Nome Descrição
Autorização {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.
Content-Type application/json. Obrigatório.
If-Match Último valor de ETag conhecido para businessScenarioTask a ser atualizado. Obrigatório.

Corpo da solicitação

No corpo da solicitação, forneça apenas os valores das propriedades a serem atualizadas. As propriedades existentes que não estão incluídas no corpo da solicitação mantêm seus valores anteriores ou são recalculadas com base nas alterações de outros valores de propriedade.

A tabela a seguir especifica as propriedades que podem ser atualizadas.

Propriedade Tipo Descrição
appliedCategories plannerAppliedCategories As categorias às quais a tarefa foi aplicada. Para valores possíveis, consulte plannerAppliedCategories. Herdado de plannerTask.
assigneePriority String Dica usada para solicitar itens desse tipo em uma exibição de lista. Para obter detalhes sobre o formato com suporte, consulte Usando dicas de pedido no Planner. Herdado de plannerTask.
assignments plannerAssignments O conjunto de destinatários aos quais a tarefa é atribuída. Herdado de plannerTask.
bucketId String ID do bucket ao qual a tarefa pertence. O bucket precisa estar no plano no qual a tarefa está. Tem 28 caracteres e diferencia maiúsculas de minúsculas. A validação de formato é feita no serviço. Herdado de plannerTask.
businessScenarioProperties businessScenarioProperties Propriedades específicas do cenário da tarefa. Opcional.
conversationThreadId String ID do thread da conversa sobre a tarefa. Essa é a ID do objeto thread de conversa criado no grupo. Herdado de plannerTask.
dueDateTime DateTimeOffset A data e a hora que a tarefa já deve estar concluída. O tipo Timestamp representa informações de data e hora usando o formato ISO 8601 e está sempre no horário UTC. Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é 2014-01-01T00:00:00Z. Herdado de plannerTask.
orderHint String Dica usada para solicitar itens desse tipo em uma exibição de lista. Para obter detalhes sobre o formato com suporte, consulte Usando dicas de pedido no Planner. Herdado de plannerTask.
percentComplete Int32 Porcentagem de conclusão da tarefa. Quando definida como 100, a tarefa é considerada concluída. Herdado de plannerTask.
planId String Identificador do plano ao qual a tarefa pertence. Herdado de plannerTask.
prioridade Int32 Prioridade da tarefa. O intervalo válido de valores está entre 0 e 10 (inclusivo), com o valor crescente sendo a prioridade mais baixa (0 tem a prioridade mais alta e 10 tem a prioridade mais baixa). Atualmente, o Planner interpreta valores 0 como 1 "urgente", 2, 3, e 4 como "importante", 5, 6, e 7 como "médio" e 8, 9, e 10 como "baixo". Atualmente, o Planner define o valor 1 para "urgente", 3 para "importante", 5 para "médio" e 9 para "baixo". Herdado de plannerTask.
startDateTime DateTimeOffset A data e a hora que a tarefa começa. O tipo Timestamp representa informações de data e hora usando o formato ISO 8601 e está sempre no horário UTC. Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é 2014-01-01T00:00:00Z. Herdado de plannerTask.
destino businessScenarioTaskTargetBase Destino da tarefa que especifica onde a tarefa deve ser colocada. Opcional.
title String Título da tarefa. Herdado de plannerTask.

Resposta

Se for bem-sucedido, esse método retornará um código de 200 OK resposta e um objeto businessScenarioTask atualizado no corpo da resposta.

Exemplos

Solicitação

O exemplo a seguir mostra uma solicitação.

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

Resposta

O exemplo a seguir mostra a resposta.

Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.

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