Type de ressource de planification

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 collection d’objets schedulingGroup , d’objets shift , d’objets timeOffReason et d’objets timeOff pour une équipe.

Méthodes

Méthode Type renvoyé Description
Créer ou remplacer planifier Créer ou remplacer une planification.
Obtenir planifier Obtenez une planification.
Partager Aucun Partagez une plage horaire de planification avec les membres de la planification.

Propriétés

Propriété Type Description
enabled Booléen Indique si la planification est activée pour l’équipe. Obligatoire.
id String ID de la planification.
isActivitiesIncludedWhenCopyingShiftsEnabled Booléen Indique si les shifts copiés incluent des activités du shift d’origine.
isCrossLocationShiftRequestApprovalRequired Booléen Indique si l’approbation est requise par un responsable de cette planification pour les demandes de shift inter-emplacements.
isCrossLocationShiftsEnabled Booléen Indique si la fonctionnalité de la Place de marché inter-emplacements est activée pour cette planification.
offerShiftRequestsEnabled Booléen Indique si les demandes de shift d’offre sont activées pour la planification.
openShiftsEnabled Booléen Indique si les équipes ouvertes sont activées pour la planification.
provisionStatus operationStatus Status de l’approvisionnement de la planification. Les valeurs possibles sont notStarted, running, completed, failed.
provisionStatusCode String Informations supplémentaires sur la raison de l’échec de l’approvisionnement de planification.
startDayOfWeek dayOfWeek Indique le jour de début de la semaine. Les valeurs possibles sont sunday, monday, tuesday, wednesday, thursday, friday, saturday.
swapShiftsRequestsEnabled Booléen Indique si les demandes de shifts d’échange sont activées pour la planification.
timeClockEnabled Booléen Indique si l’horloge est activée pour la planification.
timeClockSettings timeClockSettings Paramètres d’emplacement de l’horloge pour cette planification.
timeOffRequestsEnabled Booléen Indique si les demandes de congé sont activées pour la planification.
timeZone String Le fuseau horaire de l’équipe de planification en tant que nom de base de données de fuseau horaire IANA (base de données tz) ; par exemple, America/Chicago. Pour obtenir la liste complète des valeurs valides, consultez Liste des fuseaux horaires tz database. Obligatoire.
workforceIntegrationIds String collection ID pour les intégrations de main-d’œuvre associées à cette planification.
activitiesIncludedWhenCopyingShiftsEnabled (déconseillé) Booléen Indique si les shifts copiés doivent inclure les activités. Cette propriété sera supprimée avant le 20 novembre 2027. Utilisez isActivitiesIncludedWhenCopyingShiftsEnabled à la place. activitiesIncludedWhenCopyingShiftsEnabled et isActivitiesIncludedWhenCopyingShiftsEnabled ont toujours la même valeur, donc définir l’un définit automatiquement la valeur pour l’autre. Si les deux sont inclus dans la demande avec des valeurs différentes, la valeur de isActivitiesIncludedWhenCopyingShiftsEnabled est prioritaire.

Relations

Nom Type Description
dayNotes collection dayNote Notes du jour dans le planning.
offerShiftRequests collection offerShiftRequest L’offre demande des équipes dans la planification.
openShiftChangeRequests collection openShiftChangeRequest Demandes de shift ouvertes dans la planification.
openShifts collection openShift Ensemble de shifts ouverts dans un groupe de planification dans la planification.
schedulingGroups Collection schedulingGroup Regroupement logique d’utilisateurs dans la planification (généralement par rôle).
Changements shift, collection Décalages dans la planification.
shiftsRoleDefinitions collection shiftsRoleDefinition Définitions des rôles dans la planification.
swapShiftsChangeRequests swapShiftsChangeRequest, collection Demandes d’échange pour les shifts dans la planification.
timeCards Collection timeCard Cartes de temps dans la planification.
timesOff collection timeOff Instances de temps d’arrêt dans la planification.
timeOffReasons collection timeOffReason Ensemble des raisons d’un congé dans l’horaire.
timeOffRequests collection timeOffRequest Demandes de congé dans la planification.
workforceIntegrations collection workforceIntegration Une instance d’une intégration de la main-d’œuvre par équipe avec un flux de données sortant sur les notifications de modification synchrones (pour les entités prises en charge).

Représentation JSON

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

{
  "@odata.type": "#microsoft.graph.schedule",
  "id": "String (identifier)",
  "enabled": "Boolean",
  "timeZone": "String",
  "provisionStatus": "String",
  "provisionStatusCode": "String",
  "workforceIntegrationIds": [
    "String"
  ],
  "timeClockEnabled": "Boolean",
  "timeClockSettings": {
    "@odata.type": "microsoft.graph.timeClockSettings"
  },
  "openShiftsEnabled": "Boolean",
  "swapShiftsRequestsEnabled": "Boolean",
  "offerShiftRequestsEnabled": "Boolean",
  "timeOffRequestsEnabled": "Boolean",
  "startDayOfWeek": "String",
  "activitiesIncludedWhenCopyingShiftsEnabled": "Boolean",
  "isActivitiesIncludedWhenCopyingShiftsEnabled": "Boolean",
  "isCrossLocationShiftsEnabled": "Boolean",
  "isCrossLocationShiftRequestApprovalRequired": "Boolean"
}