Freigeben über

Konfigurieren von Aufgabenregeln in Planner (Vorschau)

  • Artikel

Die Planner-API in Microsoft Graph unterstützt Regeln, mit denen angepasst werden kann, was für Aufgaben ausgeführt werden kann und was nicht. Aufgabenregeln können für Aufgaben angegeben werden, die aus verschiedenen Quellen erstellt wurden, z. B. Geschäftsszenarien.

Aufgabeneigenschaftsregeln werden durch die plannerTaskPropertyRule-Entität dargestellt und beschreiben die zulässigen Aktionen auf Aufgabenebene und Regeln für jede konfigurierbare Eigenschaft.

Abhängig vom jeweiligen Eintrag geben die Regeln entweder eine Auflistung von Werten oder ein fieldRules-Objekt an. Feldregeln geben eine Auflistung von Werten als Standard an und stellen eine separate Auflistung von Werten für Außerkraftsetzungsbedingungen bereit. Für jede Auflistung von Werten sind die angegebenen Werte zulässig. Ausgelassene Werte sind nicht zulässig.

In diesem Artikel lernen Sie das verhalten, das den einzelnen Einträgen zugeordnet ist, und die von den einzelnen Eigenschaften unterstützten Außerkraftsetzungsbedingungen.

Konfigurierbare Aktionen

Löschen

Gibt an, ob die Aufgabe gelöscht werden kann. Zulässige Werte sind:

  • block: Die Aufgabe kann nicht gelöscht werden.
  • allow: Aufgabe kann gelöscht werden.

Die Auflistung darf nur einen dieser Werte enthalten.

verschieben

Gibt an, ob die Aufgabe verschoben werden kann. Dies umfasst nur eine Aufgabe, die zwischen Buckets und Plänen mit demselben oder unterschiedlichen Containern verschoben wird. Es enthält jedoch keine anderen Vorgänge, die Verschiebungen ähneln, die unabhängig konfiguriert werden können, z. B. Zuweisungen, Reihenfolge des Vorgangs, Prozentsatz abgeschlossen oder Priorität. Zulässige Werte sind:

  • block: Die Aufgabe kann nicht verschoben werden.
  • moveBetweenBuckets: Der Task kann nur zwischen den Buckets des Plans verschoben werden, in dem er sich befindet.
  • moveBetweenPlans: Der Task kann zwischen Buckets und zwischen den Plänen verschoben werden, die zum gleichen Container gehören.
  • allow: Die Aufgabe kann zwischen Buckets und planübergreifend verschoben werden.

Die Auflistung darf nur einen dieser Werte enthalten.

Bestellung

Gibt an, ob die Aufgabe in freigegebenen Ansichten neu angeordnet werden kann. Zulässige Werte sind:

  • block: Die Aufgabe kann nicht neu angeordnet werden.
  • allow: Die Aufgabe kann neu angeordnet werden.

Die Auflistung darf nur einen dieser Werte enthalten.

Konfigurierbare Eigenschaften

appliedCategories

Die appliedCategories-Eigenschaft wird mit fieldRules konfiguriert und stellt Standardwerte und Außerkraftsetzungen für bestimmte Bedingungen bereit. Zulässige Werte sind:

  • block: Angewendete Kategorien können nicht geändert werden.
  • allow: Kategorien können hinzugefügt oder entfernt werden.

Die Auflistung darf nur einen dieser Werte enthalten.

Diese Eigenschaft unterstützt keine Außerkraftsetzungsbedingungen. Die Regeln müssen in der defaultRules-Eigenschaft angegeben werden.

assignments

Die Assignments-Eigenschaft wird mit fieldRules konfiguriert und stellt Standardwerte und Außerkraftsetzungen für bestimmte Bedingungen bereit. Zulässige Werte sind:

  • block: Zuweisungen des Vorgangs können nicht geändert werden.
  • addSelf: Benutzer können die Aufgabe sich selbst zuweisen.
  • removeSelf: Benutzer können sich selbst als Zugewiesene entfernen.
  • addOther: Benutzer können die Aufgabe anderen Personen als sich selbst zuweisen.
  • removeOther: Benutzer können andere Zugewiesene als sich selbst entfernen.
  • add: Zugewiesene Können hinzugefügt werden.
  • remove: Zugewiesene Können entfernt werden.
  • allow: Zugewiesene Können hinzugefügt oder entfernt werden.

Die Auflistung kann entweder einen einzelnen allow Wert oder block einen Wert oder eine beliebige Kombination anderer Werte angeben.

Diese Eigenschaft unterstützt die folgenden Außerkraftsetzungsbedingungen. Wenn für eine Außerkraftsetzung keine Regeln angegeben sind, gelten stattdessen die für die defaultRules-Eigenschaft angegebenen Werte. Die defaultRules müssen angegeben werden.

  • userCreated: Regeln gelten, wenn die Zuweisung von einem Benutzer erstellt wurde.
  • applicationCreated: Regeln gelten, wenn die Zuweisung mithilfe von Anwendungsberechtigungen erstellt wurde.

Checklisten

Die checkLists-Eigenschaft ist mit fieldRules konfiguriert und stellt Standardwerte und Außerkraftsetzungen für bestimmte Bedingungen bereit. Zulässige Werte sind:

  • block: Prüfliste kann nicht geändert werden.
  • check: Prüflistenelemente können überprüft werden.
  • reorder: Prüflistenelemente können neu angeordnet werden.
  • add: Neue Prüflistenelemente können hinzugefügt werden.
  • update: Vorhandene Prüflistenelemente können aktualisiert werden.
  • remove: Vorhandene Prüflistenelemente können entfernt werden.
  • allow: Alle Prüflistenaktionen sind zulässig.

Die Auflistung kann entweder einen einzelnen allow Wert oder block einen Wert oder eine beliebige Kombination anderer Werte angeben.

Diese Eigenschaft unterstützt die folgenden Außerkraftsetzungsbedingungen. Wenn für eine Außerkraftsetzung keine Regeln angegeben sind, gelten stattdessen die für die defaultRules-Eigenschaft angegebenen Werte. Die defaultRules müssen angegeben werden.

  • userCreated: Regeln gelten, wenn das Prüflistenelement von einem Benutzer erstellt wurde.
  • applicationCreated: Regeln gelten, wenn das Prüflistenelement mithilfe von Anwendungsberechtigungen erstellt wurde.

completionRequirements

Gibt an, ob die Task completionRequirements-Eigenschaft geändert werden kann. Zulässige Werte sind:

  • block: Die Task completionRequirements-Eigenschaft kann nicht geändert werden.
  • add: Neue Vervollständigungsanforderungen können hinzugefügt werden.
  • edit: Vorhandene Vervollständigungsanforderungen können bearbeitet werden.
  • remove: Vorhandene Vervollständigungsanforderungen können entfernt werden.
  • allow: Die Eigenschaft task completionRequirements kann geändert werden.

Die Auflistung kann entweder einen einzelnen allow Wert oder block einen Wert oder eine beliebige Kombination anderer Werte angeben.

Duedate

Gibt an, ob das Fälligkeitsdatum der Aufgabe geändert werden kann. Zulässige Werte sind:

  • block: Das Fälligkeitsdatum des Vorgangs kann nicht geändert werden.
  • allow: Das Fälligkeitsdatum des Vorgangs kann geändert, hinzugefügt oder entfernt werden.

Die Auflistung darf nur einen dieser Werte enthalten.

notes

Gibt an, ob die Aufgabennotizen geändert werden können. Zulässige Werte sind:

  • block: Aufgabennotizen können nicht geändert werden.
  • allow: Aufgabennotizen können geändert werden.

Die Auflistung darf nur einen dieser Werte enthalten.

percentComplete

Gibt an, ob die percentComplete-Eigenschaft der Aufgabe geändert werden kann. Zulässige Werte sind:

  • block: Die percentComplete-Eigenschaft des Tasks kann nicht geändert werden.
  • setToComplete: Die PercentComplete-Eigenschaft des Vorgangs kann auf festgelegt werden, 100 nachdem die Abschlussanforderungen erfüllt wurden.
  • overrideRequirements: Die PercentComplete-Eigenschaft des Vorgangs kann auf 100 festgelegt werden, auch wenn die Abschlussanforderungen nicht erfüllt sind.
  • setToInProgress: Die percentComplete-Eigenschaft des Tasks kann auf Werte von 1 bis 99festgelegt werden.
  • setToNotStarted: Die percentComplete-Eigenschaft des Tasks kann auf 0festgelegt werden.
  • allow: Die PercentComplete-Eigenschaft der Aufgabe kann geändert werden.

Die Auflistung kann entweder einen einzelnen allow Wert oder block einen Wert oder eine beliebige Kombination anderer Werte angeben.

previewType

Gibt an, ob der Typ der Aufgabenvorschau geändert werden kann. Zulässige Werte sind:

  • block: Der Typ der Aufgabenvorschau kann nicht geändert werden.
  • allow: Der Typ der Aufgabenvorschau kann geändert werden.

Die Auflistung darf nur einen dieser Werte enthalten.

priority

Gibt an, ob die Aufgabenpriorität geändert werden kann. Zulässige Werte sind:

  • block: Die Aufgabenpriorität kann nicht geändert werden.
  • allow: Die Aufgabenpriorität kann geändert werden.

Die Auflistung darf nur einen dieser Werte enthalten.

Verweise

DieReferences-Eigenschaft wird mit fieldRules konfiguriert und stellt Standardwerte und Außerkraftsetzungen für bestimmte Bedingungen bereit. Zulässige Werte sind:

  • block: Aufgabenverweise können nicht geändert werden.
  • add: Neue Verweise können hinzugefügt werden.
  • remove: Vorhandene Verweise können entfernt werden.
  • allow: Alle Aufgabenverweisaktionen sind zulässig.

Die Auflistung kann entweder einen einzelnen allow Wert oder block einen Wert oder eine beliebige Kombination anderer Werte angeben.

Diese Eigenschaft unterstützt die folgenden Außerkraftsetzungsbedingungen. Wenn für eine Außerkraftsetzung keine Regeln angegeben sind, gelten stattdessen die für die defaultRules-Eigenschaft angegebenen Werte. Die defaultRules müssen angegeben werden.

  • userCreated: Regeln gelten, wenn der Aufgabenverweis von einem Benutzer erstellt wurde.
  • applicationCreated: Regeln gelten, wenn der Aufgabenverweis mithilfe von Anwendungsberechtigungen erstellt wurde.

startDate

Gibt an, ob der Anfangstermin des Vorgangs geändert werden kann. Zulässige Werte sind:

  • block: Das Startdatum des Vorgangs kann nicht geändert werden.
  • allow: Der Anfangstermin des Vorgangs kann geändert werden.

Die Auflistung darf nur einen dieser Werte enthalten.

title

Gibt an, ob der Aufgabentitel geändert werden kann. Zulässige Werte sind:

  • block: Der Aufgabentitel kann nicht geändert werden.
  • allow: Der Aufgabentitel kann geändert werden.

Die Auflistung darf nur einen dieser Werte enthalten.

approvalAttachment

Die eigenschaft approvalAttachment wird mit fieldRules konfiguriert und stellt Standardwerte und Außerkraftsetzungen für bestimmte Bedingungen bereit. Zulässige Werte sind:

  • block: Die Genehmigung kann nicht geändert werden.
  • add: Eine neue Genehmigung kann hinzugefügt werden.
  • remove: Eine vorhandene Genehmigung kann entfernt werden.
  • allow: Alle Genehmigungsaktionen sind zulässig.

Formen

Die forms-Eigenschaft wird mit fieldRules konfiguriert und stellt Standardwerte und Außerkraftsetzungen für bestimmte Bedingungen bereit. Die folgenden Werte sind möglich:

  • block: Forms kann nicht geändert werden.
  • addResponse: Antworten können dem Formular hinzugefügt werden.
  • add: Neue Formulare können hinzugefügt werden.
  • update: Vorhandene Formulare können aktualisiert werden.
  • remove: Vorhandene Formulare können entfernt werden.
  • allow: Alle Formularaktionen sind zulässig.