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
| 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"
}
}
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Beta.Models;
var requestBody = new BusinessScenarioTask
{
Title = "Customer order #12010",
PercentComplete = 0,
Priority = 5,
Target = new BusinessScenarioGroupTarget
{
OdataType = "microsoft.graph.businessScenarioGroupTarget",
TaskTargetKind = PlannerTaskTargetKind.Group,
GroupId = "7a339254-4b2b-4410-b295-c890a16776ee",
},
BusinessScenarioProperties = new BusinessScenarioProperties
{
ExternalObjectId = "Order#12010",
ExternalContextId = "Warehouse-CA-36",
ExternalObjectVersion = "000001",
WebUrl = "https://ordertracking.contoso.com/view?id=12010",
ExternalBucketId = "deliveryBucket",
},
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Solutions.BusinessScenarios["{businessScenario-id}"].Planner.Tasks.PostAsync(requestBody);
// Code snippets are only available for the latest major version. Current major version is $v0.*
// Dependencies
import (
"context"
msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go"
graphmodels "github.com/microsoftgraph/msgraph-beta-sdk-go/models"
//other-imports
)
requestBody := graphmodels.NewBusinessScenarioTask()
title := "Customer order #12010"
requestBody.SetTitle(&title)
percentComplete := int32(0)
requestBody.SetPercentComplete(&percentComplete)
priority := int32(5)
requestBody.SetPriority(&priority)
target := graphmodels.NewBusinessScenarioGroupTarget()
taskTargetKind := graphmodels.GROUP_PLANNERTASKTARGETKIND
target.SetTaskTargetKind(&taskTargetKind)
groupId := "7a339254-4b2b-4410-b295-c890a16776ee"
target.SetGroupId(&groupId)
requestBody.SetTarget(target)
businessScenarioProperties := graphmodels.NewBusinessScenarioProperties()
externalObjectId := "Order#12010"
businessScenarioProperties.SetExternalObjectId(&externalObjectId)
externalContextId := "Warehouse-CA-36"
businessScenarioProperties.SetExternalContextId(&externalContextId)
externalObjectVersion := "000001"
businessScenarioProperties.SetExternalObjectVersion(&externalObjectVersion)
webUrl := "https://ordertracking.contoso.com/view?id=12010"
businessScenarioProperties.SetWebUrl(&webUrl)
externalBucketId := "deliveryBucket"
businessScenarioProperties.SetExternalBucketId(&externalBucketId)
requestBody.SetBusinessScenarioProperties(businessScenarioProperties)
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
tasks, err := graphClient.Solutions().BusinessScenarios().ByBusinessScenarioId("businessScenario-id").Planner().Tasks().Post(context.Background(), requestBody, nil)
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
BusinessScenarioTask businessScenarioTask = new BusinessScenarioTask();
businessScenarioTask.setTitle("Customer order #12010");
businessScenarioTask.setPercentComplete(0);
businessScenarioTask.setPriority(5);
BusinessScenarioGroupTarget target = new BusinessScenarioGroupTarget();
target.setOdataType("microsoft.graph.businessScenarioGroupTarget");
target.setTaskTargetKind(PlannerTaskTargetKind.Group);
target.setGroupId("7a339254-4b2b-4410-b295-c890a16776ee");
businessScenarioTask.setTarget(target);
BusinessScenarioProperties businessScenarioProperties = new BusinessScenarioProperties();
businessScenarioProperties.setExternalObjectId("Order#12010");
businessScenarioProperties.setExternalContextId("Warehouse-CA-36");
businessScenarioProperties.setExternalObjectVersion("000001");
businessScenarioProperties.setWebUrl("https://ordertracking.contoso.com/view?id=12010");
businessScenarioProperties.setExternalBucketId("deliveryBucket");
businessScenarioTask.setBusinessScenarioProperties(businessScenarioProperties);
BusinessScenarioTask result = graphClient.solutions().businessScenarios().byBusinessScenarioId("{businessScenario-id}").planner().tasks().post(businessScenarioTask);
const options = {
authProvider,
};
const client = Client.init(options);
const businessScenarioTask = {
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'
}
};
await client.api('/solutions/businessScenarios/c5d514e6c6864911ac46c720affb6e4d/planner/tasks')
.version('beta')
.post(businessScenarioTask);
<?php
use Microsoft\Graph\Beta\GraphServiceClient;
use Microsoft\Graph\Beta\Generated\Models\BusinessScenarioTask;
use Microsoft\Graph\Beta\Generated\Models\BusinessScenarioGroupTarget;
use Microsoft\Graph\Beta\Generated\Models\PlannerTaskTargetKind;
use Microsoft\Graph\Beta\Generated\Models\BusinessScenarioProperties;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestBody = new BusinessScenarioTask();
$requestBody->setTitle('Customer order #12010');
$requestBody->setPercentComplete(0);
$requestBody->setPriority(5);
$target = new BusinessScenarioGroupTarget();
$target->setOdataType('microsoft.graph.businessScenarioGroupTarget');
$target->setTaskTargetKind(new PlannerTaskTargetKind('group'));
$target->setGroupId('7a339254-4b2b-4410-b295-c890a16776ee');
$requestBody->setTarget($target);
$businessScenarioProperties = new BusinessScenarioProperties();
$businessScenarioProperties->setExternalObjectId('Order#12010');
$businessScenarioProperties->setExternalContextId('Warehouse-CA-36');
$businessScenarioProperties->setExternalObjectVersion('000001');
$businessScenarioProperties->setWebUrl('https://ordertracking.contoso.com/view?id=12010');
$businessScenarioProperties->setExternalBucketId('deliveryBucket');
$requestBody->setBusinessScenarioProperties($businessScenarioProperties);
$result = $graphServiceClient->solutions()->businessScenarios()->byBusinessScenarioId('businessScenario-id')->planner()->tasks()->post($requestBody)->wait();
Import-Module Microsoft.Graph.Beta.BusinessScenario
$params = @{
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"
}
}
New-MgBetaSolutionBusinessScenarioPlannerTask -BusinessScenarioId $businessScenarioId -BodyParameter $params
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
from msgraph_beta.generated.models.business_scenario_task import BusinessScenarioTask
from msgraph_beta.generated.models.business_scenario_group_target import BusinessScenarioGroupTarget
from msgraph_beta.generated.models.planner_task_target_kind import PlannerTaskTargetKind
from msgraph_beta.generated.models.business_scenario_properties import BusinessScenarioProperties
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = BusinessScenarioTask(
title = "Customer order #12010",
percent_complete = 0,
priority = 5,
target = BusinessScenarioGroupTarget(
odata_type = "microsoft.graph.businessScenarioGroupTarget",
task_target_kind = PlannerTaskTargetKind.Group,
group_id = "7a339254-4b2b-4410-b295-c890a16776ee",
),
business_scenario_properties = BusinessScenarioProperties(
external_object_id = "Order#12010",
external_context_id = "Warehouse-CA-36",
external_object_version = "000001",
web_url = "https://ordertracking.contoso.com/view?id=12010",
external_bucket_id = "deliveryBucket",
),
)
result = await graph_client.solutions.business_scenarios.by_business_scenario_id('businessScenario-id').planner.tasks.post(request_body)
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"
}
}