Partager via

Configuration des règles de tâche dans Planificateur (préversion)

  • Article

L’API Planificateur dans Microsoft Graph prend en charge les règles, qui permettent de personnaliser ce qui peut et ne peut pas être effectué sur les tâches. Les règles de tâche peuvent être spécifiées pour les tâches créées à partir de différentes sources, telles que des scénarios métier.

Les règles de propriété de tâche sont représentées par l’entité plannerTaskPropertyRule et décrivent les actions autorisées au niveau de la tâche et les règles relatives à chaque propriété configurable.

Selon l’entrée spécifique, les règles spécifient une collection de valeurs ou un objet fieldRules . Les règles de champ spécifient une collection de valeurs par défaut et fournissent une collection distincte de valeurs pour les conditions de remplacement. Pour toute collection de valeurs, les valeurs spécifiées sont celles autorisées ; les valeurs omises ne sont pas autorisées.

Dans cet article, vous allez découvrir les comportements associés à chaque entrée et les conditions de remplacement prises en charge par chaque propriété.

Actions configurables

delete

Spécifie si la tâche peut être supprimée. Les valeurs acceptées sont les suivantes :

  • block: la tâche ne peut pas être supprimée.
  • allow: la tâche peut être supprimée.

La collection ne doit contenir qu’une seule de ces valeurs.

move

Spécifie si la tâche peut être déplacée. Cela inclut uniquement une tâche se déplaçant entre des compartiments et des plans avec des conteneurs identiques ou différents. Toutefois, elle n’inclut pas d’autres opérations similaires aux déplacements, qui peuvent être configurées indépendamment, telles que les affectations, l’ordre de la tâche, le pourcentage d’achèvement ou la priorité. Les valeurs acceptées sont les suivantes :

  • block: la tâche ne peut pas être déplacée.
  • moveBetweenBuckets: la tâche ne peut être déplacée qu’entre les compartiments du plan dans lequel elle se trouve.
  • moveBetweenPlans: la tâche peut être déplacée entre les compartiments et entre les plans qui appartiennent au même conteneur.
  • allow: la tâche peut être déplacée d’un compartiment à l’autre et d’un plan à l’autre.

La collection ne doit contenir qu’une seule de ces valeurs.

commande

Spécifie si la tâche peut être réorganisée dans les vues partagées. Les valeurs acceptées sont les suivantes :

  • block: la tâche ne peut pas être réorganisée.
  • allow: la tâche peut être réorganisée.

La collection ne doit contenir qu’une seule de ces valeurs.

Propriétés configurables

appliedCategories

La propriété appliedCategories est configurée avec fieldRules, en fournissant des valeurs par défaut et des remplacements pour des conditions spécifiques. Les valeurs acceptées sont les suivantes :

  • block: les catégories appliquées ne peuvent pas être modifiées.
  • allow: les catégories peuvent être ajoutées ou supprimées.

La collection ne doit contenir qu’une seule de ces valeurs.

Cette propriété ne prend pas en charge les conditions de remplacement. Les règles doivent être spécifiées dans la propriété defaultRules .

affectations

La propriété assignments est configurée avec fieldRules, en fournissant des valeurs par défaut et des remplacements pour des conditions spécifiques. Les valeurs acceptées sont les suivantes :

  • block: les affectations de la tâche ne peuvent pas être modifiées.
  • addSelf: les utilisateurs peuvent s’attribuer la tâche.
  • removeSelf: les utilisateurs peuvent se supprimer eux-mêmes en tant qu’ayants droit.
  • addOther: les utilisateurs peuvent attribuer la tâche à d’autres personnes qu’eux-mêmes.
  • removeOther: les utilisateurs peuvent supprimer d’autres personnes qu’eux-mêmes.
  • add: les personnes assignées peuvent être ajoutées.
  • remove: les personnes assignées peuvent être supprimées.
  • allow: les personnes assignées peuvent être ajoutées ou supprimées.

La collection peut spécifier une valeur unique allow ou block une valeur, ou toute combinaison d’autres valeurs.

Cette propriété prend en charge les conditions de remplacement suivantes. Si aucune règle n’est spécifiée pour un remplacement, les valeurs spécifiées pour la propriété defaultRules s’appliquent à la place. Les defaultRules doivent être spécifiées.

  • userCreated: les règles s’appliquent si l’affectation a été créée par un utilisateur.
  • applicationCreated: les règles s’appliquent si l’affectation a été créée à l’aide d’autorisations d’application.

Listes

La propriété checkLists est configurée avec fieldRules, en fournissant des valeurs par défaut et des remplacements pour des conditions spécifiques. Les valeurs acceptées sont les suivantes :

  • block: la liste de contrôle ne peut pas être modifiée.
  • check: les éléments de liste de contrôle peuvent être vérifiés.
  • reorder: les éléments de liste de contrôle peuvent être réorganisés.
  • add: de nouveaux éléments de liste de contrôle peuvent être ajoutés.
  • update: les éléments de liste de contrôle existants peuvent être mis à jour.
  • remove: les éléments de liste de contrôle existants peuvent être supprimés.
  • allow: toutes les actions de liste de contrôle sont autorisées.

La collection peut spécifier une valeur unique allow ou block une valeur, ou toute combinaison d’autres valeurs.

Cette propriété prend en charge les conditions de remplacement suivantes. Si aucune règle n’est spécifiée pour un remplacement, les valeurs spécifiées pour la propriété defaultRules s’appliquent à la place. Les defaultRules doivent être spécifiées.

  • userCreated: les règles s’appliquent si l’élément de liste de contrôle a été créé par un utilisateur.
  • applicationCreated: les règles s’appliquent si l’élément de liste de contrôle a été créé à l’aide d’autorisations d’application.

completionRequirements

Spécifie si la propriété task completionRequirements peut être modifiée. Les valeurs acceptées sont les suivantes :

  • block: la propriété task completionRequirements ne peut pas être modifiée.
  • add: de nouvelles exigences de saisie semi-automatique peuvent être ajoutées.
  • edit: les exigences de saisie semi-automatique existantes peuvent être modifiées.
  • remove: les exigences de saisie semi-automatique existantes peuvent être supprimées.
  • allow: la propriété task completionRequirements peut être modifiée.

La collection peut spécifier une valeur unique allow ou block une valeur, ou toute combinaison d’autres valeurs.

dueDate

Spécifie si la date d’échéance de la tâche peut être modifiée. Les valeurs acceptées sont les suivantes :

  • block: la date d’échéance de la tâche ne peut pas être modifiée.
  • allow: la date d’échéance de la tâche peut être modifiée, ajoutée ou supprimée.

La collection ne doit contenir qu’une seule de ces valeurs.

notes

Spécifie si les notes de tâche peuvent être modifiées. Les valeurs acceptées sont les suivantes :

  • block: les notes de tâches ne peuvent pas être modifiées.
  • allow: les notes de tâches peuvent être modifiées.

La collection ne doit contenir qu’une seule de ces valeurs.

percentComplete

Spécifie si la propriété task percentComplete peut être modifiée. Les valeurs acceptées sont les suivantes :

  • block: la propriété percentComplete de la tâche ne peut pas être modifiée.
  • setToComplete: la propriété task percentComplete peut être définie sur 100 une fois que les exigences d’achèvement sont remplies.
  • overrideRequirements: la propriété task percentComplete peut être définie sur 100 même si les conditions d’achèvement ne sont pas remplies.
  • setToInProgress: la propriété task percentComplete peut être définie sur les valeurs de à 99partir de 1 .
  • setToNotStarted: la propriété task percentComplete peut être définie sur 0.
  • allow: la propriété task percentComplete peut être modifiée.

La collection peut spécifier une valeur unique allow ou block une valeur, ou toute combinaison d’autres valeurs.

previewType

Spécifie si le type d’aperçu de tâche peut être modifié. Les valeurs acceptées sont les suivantes :

  • block: le type d’aperçu de la tâche ne peut pas être modifié.
  • allow: le type d’aperçu de la tâche peut être modifié.

La collection ne doit contenir qu’une seule de ces valeurs.

priorité

Spécifie si la priorité de la tâche peut être modifiée. Les valeurs acceptées sont les suivantes :

  • block: la priorité de la tâche ne peut pas être modifiée.
  • allow: la priorité de la tâche peut être modifiée.

La collection ne doit contenir qu’une seule de ces valeurs.

references

La propriétéreferences est configurée avec fieldRules, en fournissant des valeurs par défaut et des remplacements pour des conditions spécifiques. Les valeurs acceptées sont les suivantes :

  • block: les références de tâche ne peuvent pas être modifiées.
  • add: de nouvelles références peuvent être ajoutées.
  • remove: les références existantes peuvent être supprimées.
  • allow: toutes les actions de référence de tâche sont autorisées.

La collection peut spécifier une valeur unique allow ou block une valeur, ou toute combinaison d’autres valeurs.

Cette propriété prend en charge les conditions de remplacement suivantes. Si aucune règle n’est spécifiée pour un remplacement, les valeurs spécifiées pour la propriété defaultRules s’appliquent à la place. Les defaultRules doivent être spécifiées.

  • userCreated: les règles s’appliquent si la référence de tâche a été créée par un utilisateur.
  • applicationCreated: les règles s’appliquent si la référence de tâche a été créée à l’aide d’autorisations d’application.

startDate

Spécifie si la date de début de la tâche peut être modifiée. Les valeurs acceptées sont les suivantes :

  • block: la date de début de la tâche ne peut pas être modifiée.
  • allow: la date de début de la tâche peut être modifiée.

La collection ne doit contenir qu’une seule de ces valeurs.

title

Spécifie si le titre de la tâche peut être modifié. Les valeurs acceptées sont les suivantes :

  • block: le titre de la tâche ne peut pas être modifié.
  • allow: le titre de la tâche peut être modifié.

La collection ne doit contenir qu’une seule de ces valeurs.

approvalAttachment

La propriété approvalAttachment est configurée avec fieldRules, en fournissant des valeurs par défaut et des remplacements pour des conditions spécifiques. Les valeurs acceptées sont les suivantes :

  • block: l’approbation ne peut pas être modifiée.
  • add: une nouvelle approbation peut être ajoutée.
  • remove: une approbation existante peut être supprimée.
  • allow: toutes les actions d’approbation sont autorisées.

Formes

La propriété forms est configurée avec fieldRules, en fournissant des valeurs par défaut et des remplacements pour des conditions spécifiques. Les valeurs possibles sont les suivantes :

  • block: Forms ne peut pas être modifié.
  • addResponse: les réponses peuvent être ajoutées au formulaire.
  • add: de nouveaux formulaires peuvent être ajoutés.
  • update: les formulaires existants peuvent être mis à jour.
  • remove: les formulaires existants peuvent être supprimés.
  • allow: toutes les actions de formulaire sont autorisées.