Utiliser l’API de scénarios métier dans Microsoft Graph pour l’intégration à Planificateur (préversion)

Importante

Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .

L’API de scénarios métier permet de créer des tâches Planificateur avec des stratégies contrôlées par scénario, dans une cible spécifiée.

Planificateur configuration

Les applications peuvent configurer Planificateur entités de deux manières lorsqu’elles utilisent l’API des scénarios métier. Les méthodes prises en charge sont les suivantes :

• Configuration du plan qui définit les éléments des plans créés pour héberger des tâches de scénario
• Configuration des tâches qui contrôle le comportement des tâches créées pour les utilisateurs et les applications

Configuration du plan

La configuration du plan est représentée par l’entité plannerPlanConfiguration . Dans la configuration du plan, l’application peut configurer les compartiments qui apparaissent dans le plan, l’ordre de ces compartiments, ainsi que le titre du plan et le nom des compartiments. Chaque compartiment est identifié par un ID externe qui peut être utilisé lorsque vous créez ou mettez à jour des tâches pour les placer dans le compartiment approprié. Les compartiments configurés dans la configuration du plan ne spécifient aucun nom à utiliser. Ces informations font plutôt partie des noms localisés. La configuration du plan spécifie également des noms localisés pour le plan et les compartiments, ainsi que le code de langue par défaut. Actuellement, les éléments créés utilisent la langue par défaut.

Configuration des tâches

La configuration des tâches est représentée par l’entité plannerTaskConfiguration . Dans la configuration des tâches, l’application peut configurer les stratégies qui limitent l’accès aux applications et aux utilisateurs qui utilisent les tâches gérées par le scénario. Les stratégies sont regroupées par rôles. Chaque rôle identifie un groupe d’appelants, et chaque groupe peut avoir des règles différentes spécifiées pour eux. Les règles qui s’appliquent à un appel spécifique sont sélectionnées dans l’ordre suivant. Seules les premières règles spécifiées s’appliquent lorsqu’une requête modifie une tâche.

• taskAssignees: s’applique si la tâche cible est affectée à l’utilisateur qui effectue l’appel.
• groupOwners: s’applique si l’utilisateur qui effectue l’appel est propriétaire du conteneur dans lequel se trouve le plan de la tâche cible.
• groupMembers: s’applique si l’utilisateur qui effectue l’appel est membre du conteneur dans lequel se trouve le plan de la tâche.
• applications: S’applique si l’appelant dispose d’autorisations d’application, l’appel n’est donc pas associé à un utilisateur.
• defaultRules: s’applique quand aucune des autres conditions ne correspond.

Note: Ces règles limitent ce que l’appelant peut faire, mais elles ne peuvent pas autoriser l’appelant à effectuer des opérations auxquelles il ne serait pas autorisé autrement.

Chaque rôle spécifie une règle par défaut et des règles pour des actions et des champs spécifiques sur la tâche. La règle par défaut doit être ou allowblock. Si aucune règle n’est définie pour une action ou un champ, la règle par défaut est utilisée pour la garder illimitée pour allowou pour empêcher l’utilisation pour block. Gardez à l’esprit que cela s’applique lorsque de nouvelles propriétés et actions sont disponibles pour être configurées, mais que la configuration du scénario n’est pas encore mise à jour pour spécifier des règles pour ces.

Pour plus d’informations sur l’utilisation des règles, consultez Configuration de règles de tâche dans Planificateur.

Guide pratique pour cibler des tâches

Les tâches créées sont placées dans des plans basés sur la cible spécifiée lors de leur création. Dans la version actuelle, un groupe peut être ciblé. La tâche est placée dans le plan associé au scénario dans ce groupe. Si le groupe n’a pas de plan pour le scénario, un nouveau plan est créé en fonction de la configuration du plan.

Métadonnées et comportement des tâches

Dans le cadre des tâches, les propriétés de scénario sont requises. Ces propriétés incluent l’ID externe de la tâche, qui doit être spécifié pour chaque tâche. Cette valeur doit être unique au sein du locataire. Si vous créez une deuxième tâche avec le même ID externe, la première tâche est retournée sans aucune modification. Vous pouvez également utiliser l’ID externe comme clé de remplacement lorsque vous travaillez avec des tâches. En outre, vous pouvez spécifier un ID de contexte pour chaque tâche. Cette valeur peut être utilisée pour interroger les tâches avec le même ID de contexte, ce qui permet aux applications de regrouper les tâches entre les plans.