名前空間: microsoft.graph
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
新しい businessScenarioTask オブジェクトを 作成します。
この API は、次の国内クラウド展開で使用できます。
| グローバル サービス |
米国政府機関 L4 |
米国政府機関 L5 (DOD) |
21Vianet が運営する中国 |
| ✅ |
❌ |
❌ |
❌ |
アクセス許可
この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。
アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、「アクセス許可のリファレンス」を参照してください。
| アクセス許可の種類 |
最小特権アクセス許可 |
より高い特権のアクセス許可 |
| 委任 (職場または学校のアカウント) |
BusinessScenarioData.ReadWrite.OwnedBy |
注意事項なし。 |
| 委任 (個人用 Microsoft アカウント) |
サポートされていません。 |
サポートされていません。 |
| アプリケーション |
BusinessScenarioData.ReadWrite.OwnedBy |
注意事項なし。 |
HTTP 要求
POST /solutions/businessScenarios/{businessScenarioId}/planner/tasks
| 名前 |
説明 |
| Authorization |
ベアラー {token}。 必須です。
認証と認可についての詳細をご覧ください。 |
| Content-Type |
application/json. 必須です。 |
要求本文
要求本文で、 businessScenarioTask オブジェクトの JSON 表現を指定します。
businessScenarioTask を作成するときに、次のプロパティを指定できます。
| プロパティ |
型 |
説明 |
| appliedCategories |
plannerAppliedCategories |
タスクが適用されているカテゴリ。 使用可能な値については、「 plannerAppliedCategories」を参照してください。
plannerTask から継承されます。 |
| assigneePriority |
String |
リスト ビューでこの種類の項目を注文するために使用されるヒント。 サポートされている形式の詳細については、「Plannerでの注文ヒントの使用」を参照してください。
plannerTask から継承されます。 |
| assignments |
plannerAssignments |
タスクが割り当てられている一連の担当者。
plannerTask から継承されます。 |
| bucketId |
String |
タスクが属しているバケット ID。 バケットは、タスクが存在している計画に含まれている必要があります。 28 文字の長さと大文字と小文字が区別されます。
形式の検証は、サービスで行われます。
plannerTask から継承されます。 |
| businessScenarioProperties |
businessScenarioProperties |
タスクのシナリオ固有のプロパティ。
externalObjectId プロパティと externalBucketId プロパティは、タスクの作成時に指定する必要があります。 必須です。 |
| conversationThreadId |
String |
タスク上の会話のスレッド ID。 この ID は、グループ内に作成された会話スレッド オブジェクトを参照 します。
plannerTask から継承されます。 |
| dueDateTime |
DateTimeOffset |
タスクが期限切れになる日時。 Timestamp 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC 時間です。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。
plannerTask から継承されます。 |
| orderHint |
String |
リスト ビューでこの種類の項目を注文するために使用されるヒント。 サポートされている形式の詳細については、「Plannerでの注文ヒントの使用」を参照してください。
plannerTask から継承されます。 |
| percentComplete |
Int32 |
タスク完了の割合。
100に設定すると、タスクは完了と見なされます。
plannerTask から継承されます。 |
| planId |
String |
タスクが属するプランの識別子。
plannerTask から継承されます。 |
| priority |
Int32 |
タスクの優先度。 有効な値の範囲は、 0 と 10 (包括) の間にあり、値の増加は優先順位が低くなります (0 は最も優先順位が高く、 10 は最も優先順位が低くなります)。 現在、Plannerでは、0値と1値を "緊急" として解釈し、2、3、4を "重要" として解釈し、5、6、7を "medium" として解釈し、8、9、10を "低" と解釈しています。 現在、Plannerでは、"緊急" の値1、"重要" に3、"medium" の5、"低" の9を設定します。
plannerTask から継承されます。 |
| startDateTime |
DateTimeOffset |
タスクが開始される日時。 Timestamp 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC 時間です。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。
plannerTask から継承されます。 |
| target |
businessScenarioTaskTargetBase |
タスクを配置する場所を指定するタスクのターゲット。 必須です。 |
| title |
String |
タスクのタイトル。
plannerTask から継承されます。 |
応答
成功した場合、このメソッドは応答コード 201 Created と、応答本文に businessScenarioTask オブジェクトを返します。
例
要求
次の例は要求を示しています。
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)
応答
次の例は応答を示しています。
注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。
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"
}
}