Compartilhar via


Criar 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.

Crie um novo objeto businessScenarioTask .

Esta API está disponível nas seguintes implementações de cloud nacionais.

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

Permissões

Escolha a permissão ou permissões marcadas como menos privilegiadas para esta API. Utilize uma permissão ou permissões com privilégios mais elevados apenas se a sua aplicação o exigir. Para obter detalhes sobre as permissões delegadas e de aplicação, veja Tipos de permissão. Para saber mais sobre estas permissões, veja a referência de permissões.

Tipo de permissão Permissões com menos privilégios Permissões com privilégios superiores
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

POST /solutions/businessScenarios/{businessScenarioId}/planner/tasks

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.

Corpo da solicitação

No corpo do pedido, forneça uma representação JSON do objeto businessScenarioTask .

Pode especificar as seguintes propriedades ao criar um businessScenarioTask.

Propriedade Tipo Descrição
appliedCategories plannerAppliedCategories As categorias às quais a tarefa foi aplicada. Para obter os valores possíveis, veja plannerAppliedCategories. Herdado do plannerTask.
assigneePriority String Sugestão utilizada para ordenar itens deste tipo numa vista de lista. Para obter detalhes sobre o formato suportado, consulte Utilizar sugestões de encomenda no Planner. Herdado do plannerTask.
assignments plannerAssignments O conjunto de destinatários aos quais a tarefa é atribuída. Herdado do plannerTask.
bucketId String ID do bucket ao qual a tarefa pertence. O bucket precisa estar no plano no qual a tarefa está. Tem 28 carateres de comprimento e é sensível às maiúsculas e minúsculas. A validação do formato é feita no serviço. Herdado do plannerTask.
businessScenarioProperties businessScenarioProperties Propriedades específicas do cenário da tarefa. as propriedades externalObjectId e externalBucketId têm de ser especificadas ao criar uma tarefa. Obrigatório.
conversationThreadId String ID do tópico da conversação na tarefa. Este ID referencia o objeto de thread de conversação criado no grupo. Herdado do 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 do plannerTask.
orderHint String Sugestão utilizada para ordenar itens deste tipo numa vista de lista. Para obter detalhes sobre o formato suportado, consulte Utilizar sugestões de encomenda no Planner. Herdado do plannerTask.
percentComplete Int32 Percentagem de conclusão da tarefa. Quando definida como 100, a tarefa é considerada concluída. Herdado do plannerTask.
planId String Identificador do plano ao qual a tarefa pertence. Herdado do plannerTask.
prioridade Int32 Prioridade da tarefa. O intervalo de valores válido é entre 0 e 10 (inclusive), com o aumento do valor a ser de prioridade mais baixa (0 tem a prioridade mais alta e 10 tem a prioridade mais baixa). Atualmente, Planner interpreta valores 0 e 1 como "urgente"; 2, 3e 4 como "importante"; 5, 6e 7 como "médio"; e 8, 9e 10 como "baixo". Atualmente, Planner define o valor 1 para "urgente", 3 para "importante", 5 para "médio" e 9 para "baixo". Herdado do 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 do plannerTask.
destino businessScenarioTaskTargetBase Destino da tarefa que especifica onde a tarefa deve ser colocada. Obrigatório.
title String Título da tarefa. Herdado do plannerTask.

Resposta

Se for bem-sucedido, este método devolve um 201 Created código de resposta e um objeto businessScenarioTask no corpo da resposta.

Exemplos

Solicitação

O exemplo a seguir mostra uma solicitação.

POST https://graph.microsoft.com/beta/solutions/businessScenarios/c5d514e6c6864911ac46c720affb6e4d/planner/tasks
Content-Type: application/json

{
  "title": "Customer order #12010",
  "percentComplete": 0,
  "priority": 5,
  "target": {
    "@odata.type": "microsoft.graph.businessScenarioGroupTarget",
    "taskTargetKind": "group",
    "groupId": "7a339254-4b2b-4410-b295-c890a16776ee"
  },
  "businessScenarioProperties": {
    "externalObjectId": "Order#12010",
    "externalContextId": "Warehouse-CA-36",
    "externalObjectVersion": "000001",
    "webUrl": "https://ordertracking.contoso.com/view?id=12010",
    "externalBucketId": "deliveryBucket"
  }
}

Resposta

O exemplo a seguir mostra a resposta.

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

HTTP/1.1 201 Created
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.businessScenarioTask",
  "title": "Customer order #12010",
  "percentComplete": 0,
  "priority": 5,
  "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": "000001",
    "webUrl": "https://ordertracking.contoso.com/view?id=12010",
    "externalBucketId": "deliveryBucket"
  }
}