workPlanOccurrence type de ressource

Espace de noms: microsoft.graph

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 .

Représente une instance de planification de travail spécifique pour un jour ou une période spécifique dans le plan de travail d’un utilisateur.

Les occurrences de plan de travail peuvent être générées automatiquement à partir des modèles de travail récurrents d’un utilisateur ou créées manuellement pour des arrangements spéciaux. Ces occurrences sont utiles pour gérer les exceptions aux planifications régulières de l’utilisateur. La liste suivante présente des exemples :

  • Travailler à des heures différentes pour un jour spécifique
  • Travail à partir d’un autre emplacement
  • Prendre des congés

Lorsqu’une occurrence de plan de travail existe pour la même période qu’un modèle récurrent, l’occurrence est prioritaire, ce qui permet des ajustements flexibles du calendrier.

Méthodes

Méthode Type renvoyé Description
Créer workPlanOccurrence Créez un objet workPlanOccurrence dans le plan de travail d’un utilisateur.
Mettre à jour workPlanOccurrence Mettez à jour les propriétés d’un objet workPlanOccurrence dans le plan de travail d’un utilisateur.
Supprimer Aucun Supprimez un objet workPlanOccurrence du plan de travail d’un utilisateur.
Définir l’emplacement actuel Aucun Mettez à jour le lieu de travail d’un utilisateur pour le jour en cours ou le segment actif actuel.
Vue Occurrences workPlanOccurrence collection Obtenir des occurrences de plan de travail à partir du plan de travail d’un utilisateur dans une plage de dates spécifiée.

Propriétés

Propriété Type Description
end dateTimeTimeZone Date et heure de fin de cette occurrence.
id String Identificateur unique de l’occurrence.
id de lieu String Identificateur d’un lieu de l’API Microsoft Graph Places Directory. S’applique uniquement lorsque workLocationType est défini sur office.
recurrenceId String Identifiant du modèle de périodicité parent qui a généré cette occurrence. La valeur est null pour les occurrences de congé, car elles n’ont pas de récurrence parent.
start dateTimeTimeZone Date et heure de début de cette occurrence.
timeOffDetails timeOffDetails Les détails sur le congé. S’applique uniquement lorsque workLocationType est défini sur timeOff.
workLocationType workLocationType Type de lieu de travail. Les valeurs possibles sont : unspecified, office, remote, timeOff, unknownFutureValue.

workLocationType valeurs

Member Description
Non spécifié Indique que l’utilisateur n’a pas spécifié l’emplacement.
Bureau Indique que l’utilisateur travaille à partir d’un emplacement de bureau.
Distant Indique que l’utilisateur travaille à distance.
timeOff Indique que l’utilisateur est en congé.
unknownFutureValue Valeur sentinelle d’énumération évolutive. Ne pas utiliser.

Relations

Aucun.

Représentation JSON

La représentation JSON suivante montre le type de ressource.

{
  "end": {"@odata.type": "microsoft.graph.dateTimeTimeZone"},
  "id": "String (identifier)",
  "placeId": "String",
  "recurrenceId": "String",
  "start": {"@odata.type": "microsoft.graph.dateTimeTimeZone"},
  "timeOffDetails": {"@odata.type": "microsoft.graph.timeOffDetails"},
  "workLocationType": "String"
}
  • Dernière mise à jour :