businessScenarioTask の更新

名前空間: 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 では、 01 の値は "緊急"、 234 は "重要"、 567 は "中"、 8910 は "低" と解釈されます。 現時点では、Planner では値 1 が "緊急"、 3 が "重要"、 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"
  }
}

応答

次の例は応答を示しています。

注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。

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