plannerTaskRecurrence リソースの種類
名前空間: microsoft.graph
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
Microsoft 365 の Planner タスク の繰り返しを表し、クライアントが Planner タスクの繰り返しを定義および編集できるようにします。 繰り返しを追加または編集するために、クライアントは スケジュールを指定します。 詳細については、「 plannerRecurrenceSchedule」を参照してください。 繰り返しを取り消すために、クライアントは同じ スケジュール を nullに設定します。
plannerTaskRecurrence リソースには、繰り返しの追跡と理解に役立つシステム生成および読み取り専用のプロパティも用意されています。 Planner タスクの場合、繰り返しを定義した後は、 nullに設定することはできません。 繰り返しが定義されていないタスクの場合、繰り返しは null。
非定期的なタスクを指定すると、クライアントは スケジュールを指定して定期的なタスクにすることができます。 スケジュールが追加されると、Planner によって seriesId プロパティと occurrenceId プロパティ、およびその他のプロパティが設定されます。
1の occurrenceId は、これが系列の最初のタスクであることを示します。 系列の 2 番目のタスクには、 occurrenceId の 2があります。
seriesId は、最初のタスク用に作成された一意の新しい文字列です。 2 番目のタスクとシリーズ内のすべての将来のタスクは、最初のタスクから seriesId を 継承し、それらが同じ 定期的な系列の一部であることを示します。
アクティブな繰り返しがあるタスクが完了とマークされている場合 (percentComplete が100に設定されている場合)、新しいタスクが作成され、系列が続行されます。 または、 アクティブな繰り返しを持つタスク が定期的なタスクを取り消さずに削除された場合は、新しいタスクも作成され、系列を続行します。 系列を廃止する必要がある場合は、 スケジュールを最初 に nullに設定する必要があります。その後、タスクを削除して繰り返しを停止できます。
詳細については、「 Planner でのタスクの繰り返しの構成」を参照してください。
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
| nextInSeriesTaskId | String | このシリーズの次のタスクの taskId 。 この値は、系列の次のタスクが作成された時点で割り当てられ、その時刻より前に null されます。 |
| occurrenceId | Int32 | 繰り返し系列内のこのタスクの 1 から始まるインデックス。 系列の最初のタスクには値が 1、系列の次のタスクには値 2などがあります。 |
| previousInSeriesTaskId | String | このシリーズの前のタスクの taskId 。
null 先行タスクがないため、シリーズの最初のタスクの場合は 。 系列内の後続のすべてのタスクには、先行タスクに対応する値があります。 |
| recurrenceStartDateTime | DateTimeOffset | この繰り返し系列が開始される日付と時刻。 系列の最初のタスク (occurrenceId = 1) の場合、この値は schedule.patternStartDateTime からコピーされます。 系列内の後続のタスク (occurrenceId>= 2) の場合、この値は前のタスクからコピーされ、変更されることはありません。定期的な系列の開始日が保持されます。 Timestamp 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC 時間です。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。 |
| schedule | plannerRecurrenceSchedule | 繰り返しのスケジュール。 クライアントは、スケジュールを指定して繰り返しを定義および編集します。
nextInSeriesTaskId が割り当てられない場合、クライアントはこのプロパティにnullを割り当てることでシリーズを終了できます。 |
| seriesId | String | このタスクが属する繰り返し系列。 一連の一意識別子として機能する GUID ベースの値。 |
リレーションシップ
なし。
JSON 表記
次の JSON 表現は、リソースの種類を示しています。 このリソースを含む実際の例については、「 Planner でのタスクの繰り返しの構成」を参照してください。
{
"@odata.type": "#microsoft.graph.plannerTaskRecurrence",
"nextInSeriesTaskId": "String",
"occurrenceId": "Int32",
"previousInSeriesTaskId": "String",
"recurrenceStartDateTime": "String (timestamp)",
"schedule": { "@odata.type": "#microsoft.graph.plannerRecurrenceSchedule" },
"seriesId": "String"
}