Partager via


Type de ressource workPlanOccurrence

Espace de noms: microsoft.graph

Représente une planification de travail spécifique instance pour un jour ou une période spécifique dans votre plan de travail.

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

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

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

Méthodes

Méthode Type renvoyé Description
Créer workPlanOccurrence Créez un objet workPlanOccurrence dans votre propre plan de travail.
Mettre à jour workPlanOccurrence Mettez à jour les propriétés d’un objet workPlanOccurrence dans votre propre plan de travail.
Supprimer Aucun Supprimez un objet workPlanOccurrence de votre propre plan de travail.
Définir l’emplacement actuel Aucun Mettez à jour votre emplacement de travail pour le jour actuel ou le segment actif actuel.
Vue Occurrences collection workPlanOccurrence Obtenez des occurrences de plan de travail à partir de votre propre plan de travail 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.
placeId String Identificateur d’un emplacement à partir de l’API Répertoire Places Microsoft Graph. Applicable uniquement lorsque workLocationType a la valeur office.
recurrenceId String Identificateur du modèle de périodicité parente qui a généré cette occurrence. La valeur est null pour les occurrences de congé, car elles n’ont pas de périodicité parente.
start dateTimeTimeZone Date et heure de début de cette occurrence.
timeOffDetails timeOffDetails Détails sur le temps de congé. Applicable uniquement lorsque workLocationType a la valeur timeOff.
workLocationType workLocationType Type d’emplacement de travail. Les valeurs possibles sont : unspecified, office, remote, timeOff, unknownFutureValue.

Valeurs workLocationType

Member Description
Quelconque Indique que l’utilisateur n’a pas spécifié l’emplacement.
Bureau Indique que l’utilisateur travaille à partir d’un bureau.
Distance Indique que l’utilisateur travaille à distance.
timeOff Indique que l’utilisateur est en congé.
unknownFutureValue Valeur sentinel de l’é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"
}