Plannerでのタスク ルールの構成 (プレビュー)

Microsoft Graph の Planner API では、タスクで実行できる操作と実行できない操作をカスタマイズできるルールがサポートされています。 タスク ルールは、 ビジネス シナリオなど、さまざまなソースから作成されたタスクに対して指定できます。

タスク プロパティ ルールは plannerTaskPropertyRule エンティティによって表され、タスク レベルで許可されるアクションと、構成可能な各プロパティに関するルールについて説明します。

特定のエントリに応じて、ルールは値のコレクションまたは fieldRules オブジェクトを指定します。 フィールド ルールでは、既定値として値のコレクションを指定し、オーバーライド条件に個別の値のコレクションを指定します。 値のコレクションの場合、指定した値が許可されます。省略された値は許可されません。

この記事では、各エントリに関連付けられている動作と、各プロパティでサポートされるオーバーライド条件について説明します。

構成可能なアクション

delete

タスクを削除できるかどうかを指定します。 受け入れられる値は次のとおりです。

• block: タスクを削除できません。
• allow: タスクを削除できます。

コレクションには、これらの値の 1 つだけを含む必要があります。

move

タスクを移動できるかどうかを指定します。 これには、同じコンテナーまたは異なるコンテナーを持つ バケット と プラン 間を移動するタスクのみが含 まれます。 ただし、割り当て、タスクの順序付け、達成率、優先度など、個別に構成できる移動に似た他の操作は含まれません。 受け入れられる値は次のとおりです。

• block: タスクを移動できません。
• moveBetweenBuckets: タスクは、その中のプランのバケット間でのみ移動できます。
• moveBetweenPlans: タスクは、バケット間、および同じコンテナーに属するプラン間で移動できます。
• allow: タスクは、バケット間とプラン間で移動できます。

コレクションには、これらの値の 1 つだけを含む必要があります。

順序

共有ビューでタスクを並べ替えることができるかどうかを指定します。 受け入れられる値は次のとおりです。

• block: タスクを並べ替えることはできません。
• allow: タスクを並べ替えることができます。

コレクションには、これらの値の 1 つだけを含む必要があります。

構成可能なプロパティ

appliedCategories

appliedCategories プロパティは fieldRules で構成され、特定の条件の既定値とオーバーライドが提供されます。 受け入れられる値は次のとおりです。

• block: 適用されたカテゴリは変更できません。
• allow: カテゴリは追加または削除できます。

コレクションには、これらの値の 1 つだけを含む必要があります。

このプロパティでは、オーバーライド条件はサポートされていません。 規則は defaultRules プロパティで指定する必要があります。

assignments

assignments プロパティは fieldRules で構成され、特定の条件の既定値とオーバーライドが提供されます。 受け入れられる値は次のとおりです。

• block: タスクの割り当てを変更できません。
• addSelf: ユーザーは自分にタスクを割り当てることができます。
• removeSelf: ユーザーは、割り当てユーザーとして自分自身を削除できます。
• addOther: ユーザーは自分以外のユーザーにタスクを割り当てることができます。
• removeOther: ユーザーは自分以外の担当者を削除できます。
• add: 担当者を追加できます。
• remove: 担当者は削除できます。
• allow: 担当者は追加または削除できます。

コレクションでは、単一 allow または値、または block 他の値の任意の組み合わせを指定できます。

このプロパティでは、次のオーバーライド条件がサポートされています。 オーバーライドにルールが指定されていない場合は、 defaultRules プロパティに指定された値が代わりに適用されます。 defaultRules を指定する必要があります。

• userCreated: 割り当てがユーザーによって作成された場合、ルールが適用されます。
• applicationCreated: 割り当てがアプリケーションのアクセス許可を使用して作成された場合、ルールが適用されます。

チェックリスト

checkLists プロパティは fieldRules で構成され、特定の条件の既定値とオーバーライドが提供されます。 受け入れられる値は次のとおりです。

• block: チェックリストは変更できません。
• check: チェックリスト項目を確認できます。
• reorder: チェックリスト項目を並べ替えることができます。
• add: 新しいチェックリスト項目を追加できます。
• update: 既存のチェックリスト項目を更新できます。
• remove: 既存のチェックリスト項目を削除できます。
• allow: すべてのチェックリスト アクションが許可されます。

コレクションでは、単一 allow または値、または block 他の値の任意の組み合わせを指定できます。

このプロパティでは、次のオーバーライド条件がサポートされています。 オーバーライドにルールが指定されていない場合は、 defaultRules プロパティに指定された値が代わりに適用されます。 defaultRules を指定する必要があります。

• userCreated: チェックリスト項目がユーザーによって作成された場合、ルールが適用されます。
• applicationCreated: チェックリスト項目がアプリケーションのアクセス許可を使用して作成された場合、ルールが適用されます。

completionRequirements

タスク の completionRequirements プロパティを変更できるかどうかを指定します。 受け入れられる値は次のとおりです。

• block: タスク の完了Requirements プロパティは変更できません。
• add: 新しい完了要件を追加できます。
• edit: 既存の完了要件を編集できます。
• remove: 既存の完了要件を削除できます。
• allow: タスク の完了Requirements プロパティを変更できます。

コレクションでは、単一 allow または値、または block 他の値の任意の組み合わせを指定できます。

dueDate

タスクの期限を変更できるかどうかを指定します。 受け入れられる値は次のとおりです。

• block: タスクの期限を変更できません。
• allow: タスクの期限は、変更、追加、または削除できます。

コレクションには、これらの値の 1 つだけを含む必要があります。

notes

タスクノートを変更できるかどうかを指定します。 受け入れられる値は次のとおりです。

• block: タスクノートは変更できません。
• allow: タスクノートを変更できます。

コレクションには、これらの値の 1 つだけを含む必要があります。

percentComplete

タスク の percentComplete プロパティを変更できるかどうかを指定します。 受け入れられる値は次のとおりです。

• block: タスク percentComplete プロパティは変更できません。
• setToComplete: 完了要件が満たされた後、タスク の percentComplete プロパティを に 100 設定できます。
• overrideRequirements: 完了要件が満たされていない場合でも、タスク の percentComplete プロパティを に 100 設定できます。
• setToInProgress: タスク percentComplete プロパティは、 から 1 の値に 99設定できます。
• setToNotStarted: タスク percentComplete プロパティを に 0設定できます。
• allow: タスク の percentComplete プロパティを変更できます。

コレクションでは、単一 allow または値、または block 他の値の任意の組み合わせを指定できます。

previewType

タスク プレビューの種類を変更できるかどうかを指定します。 受け入れられる値は次のとおりです。

• block: タスク プレビューの種類は変更できません。
• allow: タスク プレビューの種類を変更できます。

コレクションには、これらの値の 1 つだけを含む必要があります。

priority

タスクの優先度を変更できるかどうかを指定します。 受け入れられる値は次のとおりです。

• block: タスクの優先度を変更できません。
• allow: タスクの優先度を変更できます。

コレクションには、これらの値の 1 つだけを含む必要があります。

references

references プロパティは fieldRules で構成され、特定の条件の既定値とオーバーライドが提供されます。 受け入れられる値は次のとおりです。

• block: タスク参照は変更できません。
• add: 新しい参照を追加できます。
• remove: 既存の参照を削除できます。
• allow: すべてのタスク参照アクションが許可されます。

コレクションでは、単一 allow または値、または block 他の値の任意の組み合わせを指定できます。

このプロパティでは、次のオーバーライド条件がサポートされています。 オーバーライドにルールが指定されていない場合は、 defaultRules プロパティに指定された値が代わりに適用されます。 defaultRules を指定する必要があります。

• userCreated: タスク参照がユーザーによって作成された場合、ルールが適用されます。
• applicationCreated: タスク参照がアプリケーションのアクセス許可を使用して作成された場合、ルールが適用されます。

startDate

タスクの開始日を変更できるかどうかを指定します。 受け入れられる値は次のとおりです。

• block: タスクの開始日は変更できません。
• allow: タスクの開始日を変更できます。

コレクションには、これらの値の 1 つだけを含む必要があります。

title

タスク タイトルを変更できるかどうかを指定します。 受け入れられる値は次のとおりです。

• block: タスク タイトルは変更できません。
• allow: タスク タイトルは変更できます。

コレクションには、これらの値の 1 つだけを含む必要があります。

approvalAttachment

approvalAttachment プロパティは fieldRules で構成され、特定の条件の既定値とオーバーライドが提供されます。 受け入れられる値は次のとおりです。

• block: 承認は変更できません。
• add: 新しい承認を追加できます。
• remove: 既存の承認を削除できます。
• allow: すべての承認アクションが許可されます。

フォーム

forms プロパティは fieldRules で構成され、特定の条件の既定値とオーバーライドが提供されます。 使用可能な値は次のとおりです。

• block: Formsは変更できません。
• addResponse: 応答をフォームに追加できます。
• add: 新しいフォームを追加できます。
• update: 既存のフォームを更新できます。
• remove: 既存のフォームを削除できます。
• allow: すべてのフォーム アクションが許可されます。