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 番目のタスクの 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"
}
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示