名前空間: 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 要求
PATCH /solutions/businessScenarios/{businessScenarioId}/planner/tasks/{businessScenarioTaskId}
| 名前 |
説明 |
| Authorization |
ベアラー {token}。 必須です。
認証と認可についての詳細をご覧ください。 |
| Content-Type |
application/json. Required. |
| If-Match |
businessScenarioTask の最新の既知の ETag 値が更新されます。 必須です。 |
要求本文
要求本文で、更新するプロパティの値 のみを 指定します。 要求本文に含まれていない既存のプロパティは、以前の値を維持するか、他のプロパティ値の変更に基づいて再計算されます。
次の表に、更新できるプロパティを示します。
| プロパティ |
型 |
説明 |
| appliedCategories |
plannerAppliedCategories |
タスクが適用されているカテゴリ。 使用可能な値については、「 plannerAppliedCategories」を参照してください。
plannerTask から継承されます。 |
| assigneePriority |
String |
リスト ビューでこの種類の項目を注文するために使用されるヒント。 サポートされている形式の詳細については、「Plannerでの注文ヒントの使用」を参照してください。
plannerTask から継承されます。 |
| assignments |
plannerAssignments |
タスクが割り当てられている一連の担当者。
plannerTask から継承されます。 |
| bucketId |
String |
タスクが属しているバケット ID。 バケットは、タスクが存在している計画に含まれている必要があります。 28 文字の長さと大文字と小文字が区別されます。
形式の検証は、サービスで行われます。
plannerTask から継承されます。 |
| businessScenarioProperties |
businessScenarioProperties |
タスクのシナリオ固有のプロパティ。 省略可能。 |
| 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 から継承されます。 |
応答
成功した場合、このメソッドは 200 OK 応答コードと、応答本文で更新された businessScenarioTask オブジェクトを返します。
例
要求
次の例は要求を示しています。
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"
}
}
// 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 = 20,
Priority = 1,
BusinessScenarioProperties = new BusinessScenarioProperties
{
ExternalObjectVersion = "000003",
},
};
// 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["{businessScenarioTask-id}"].PatchAsync(requestBody, (requestConfiguration) =>
{
requestConfiguration.Headers.Add("If-Match", "W/\"JzEtVGFzayAgQEBAQEBAQEBAQEBAQEBAWCc=\"");
});
// Code snippets are only available for the latest major version. Current major version is $v0.*
// Dependencies
import (
"context"
abstractions "github.com/microsoft/kiota-abstractions-go"
msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go"
graphmodels "github.com/microsoftgraph/msgraph-beta-sdk-go/models"
graphsolutions "github.com/microsoftgraph/msgraph-beta-sdk-go/solutions"
//other-imports
)
headers := abstractions.NewRequestHeaders()
headers.Add("If-Match", "W/\"JzEtVGFzayAgQEBAQEBAQEBAQEBAQEBAWCc=\"")
configuration := &graphsolutions.BusinessScenariosItemPlannerTasksItemRequestBuilderPatchRequestConfiguration{
Headers: headers,
}
requestBody := graphmodels.NewBusinessScenarioTask()
title := "Customer order #12010"
requestBody.SetTitle(&title)
percentComplete := int32(20)
requestBody.SetPercentComplete(&percentComplete)
priority := int32(1)
requestBody.SetPriority(&priority)
businessScenarioProperties := graphmodels.NewBusinessScenarioProperties()
externalObjectVersion := "000003"
businessScenarioProperties.SetExternalObjectVersion(&externalObjectVersion)
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().ByBusinessScenarioTaskId("businessScenarioTask-id").Patch(context.Background(), requestBody, configuration)
// 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(20);
businessScenarioTask.setPriority(1);
BusinessScenarioProperties businessScenarioProperties = new BusinessScenarioProperties();
businessScenarioProperties.setExternalObjectVersion("000003");
businessScenarioTask.setBusinessScenarioProperties(businessScenarioProperties);
BusinessScenarioTask result = graphClient.solutions().businessScenarios().byBusinessScenarioId("{businessScenario-id}").planner().tasks().byBusinessScenarioTaskId("{businessScenarioTask-id}").patch(businessScenarioTask, requestConfiguration -> {
requestConfiguration.headers.add("If-Match", "W/\"JzEtVGFzayAgQEBAQEBAQEBAQEBAQEBAWCc=\"");
});
const options = {
authProvider,
};
const client = Client.init(options);
const businessScenarioTask = {
title: 'Customer order #12010',
percentComplete: 20,
priority: 1,
businessScenarioProperties: {
externalObjectVersion: '000003'
}
};
await client.api('/solutions/businessScenarios/c5d514e6c6864911ac46c720affb6e4d/planner/tasks/pmc1rS1Io0C3rXQhyXIsNmUAOeIi')
.version('beta')
.update(businessScenarioTask);
<?php
use Microsoft\Graph\Beta\GraphServiceClient;
use Microsoft\Graph\Beta\Generated\Solutions\BusinessScenarios\Item\Planner\Tasks\Item\BusinessScenarioTaskItemRequestBuilderPatchRequestConfiguration;
use Microsoft\Graph\Beta\Generated\Models\BusinessScenarioTask;
use Microsoft\Graph\Beta\Generated\Models\BusinessScenarioProperties;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestBody = new BusinessScenarioTask();
$requestBody->setTitle('Customer order #12010');
$requestBody->setPercentComplete(20);
$requestBody->setPriority(1);
$businessScenarioProperties = new BusinessScenarioProperties();
$businessScenarioProperties->setExternalObjectVersion('000003');
$requestBody->setBusinessScenarioProperties($businessScenarioProperties);
$requestConfiguration = new BusinessScenarioTaskItemRequestBuilderPatchRequestConfiguration();
$headers = [
'If-Match' => 'W/"JzEtVGFzayAgQEBAQEBAQEBAQEBAQEBAWCc="',
];
$requestConfiguration->headers = $headers;
$result = $graphServiceClient->solutions()->businessScenarios()->byBusinessScenarioId('businessScenario-id')->planner()->tasks()->byBusinessScenarioTaskId('businessScenarioTask-id')->patch($requestBody, $requestConfiguration)->wait();
Import-Module Microsoft.Graph.Beta.BusinessScenario
$params = @{
title = "Customer order #12010"
percentComplete = 20
priority = 1
businessScenarioProperties = @{
externalObjectVersion = "000003"
}
}
Update-MgBetaSolutionBusinessScenarioPlannerTask -BusinessScenarioId $businessScenarioId -BusinessScenarioTaskId $businessScenarioTaskId -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.solutions.business_scenarios.item.planner.tasks.item.business_scenario_task_item_request_builder import BusinessScenarioTaskItemRequestBuilder
from kiota_abstractions.base_request_configuration import RequestConfiguration
from msgraph_beta.generated.models.business_scenario_task import BusinessScenarioTask
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 = 20,
priority = 1,
business_scenario_properties = BusinessScenarioProperties(
external_object_version = "000003",
),
)
request_configuration = RequestConfiguration()
request_configuration.headers.add("If-Match", "W/\"JzEtVGFzayAgQEBAQEBAQEBAQEBAQEBAWCc=\"")
result = await graph_client.solutions.business_scenarios.by_business_scenario_id('businessScenario-id').planner.tasks.by_business_scenario_task_id('businessScenarioTask-id').patch(request_body, request_configuration = request_configuration)
応答
次の例は応答を示しています。
注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。
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"
}
}
関連コンテンツ