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 プロパティとその他のプロパティを設定します。 の 1occurrenceId は、これが系列の最初のタスクであることを示します。 系列の 2 番目のタスクの occurrenceId2は です。 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"
}