Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
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 de 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 | Obtenir un planning. |
| Partager | Aucun | Partagez un intervalle de temps planifié avec les membres du planning. |
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 d’un responsable de cette planification est requise pour les demandes de shift entre emplacements. |
| isCrossLocationShiftsEnabled | Booléen | Indique si la fonctionnalité de place de marché inter-sites 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 shifts ouverts sont activés pour la planification. |
| provisionStatus | operationStatus | Le status de la planification de l’approvisionnement. Les valeurs possibles sont notStarted, , running, failedcompleted, . |
| provisionStatusCode | String | Informations supplémentaires sur la raison pour laquelle la planification de l’approvisionnement a échoué. |
| 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 d’échange de shifts sont activées pour la planification. |
| timeClockEnabled | Booléen | Indique si la pointeuse 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 | Fuseau horaire de l’équipe de planification comme nom de la 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 de la base de données tz. Obligatoire. |
| workforceIntegrationIds | String collection | ID des 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 d’ici le 20 novembre 2027. Utilisez isActivitiesIncludedWhenCopyingShiftsEnabled plutôt l’option à la place.
activitiesIncludedWhenCopyingShiftsEnabled et isActivitiesIncludedWhenCopyingShiftsEnabled ont toujours la même valeur, donc définir l’un définit automatiquement la valeur de l’autre. Si les deux sont inclus dans la demande avec des valeurs différentes, la valeur pour isActivitiesIncludedWhenCopyingShiftsEnabled est prioritaire. |
Relations
| Nom | Type | Description |
|---|---|---|
| dayNotes | Collecte de billets de jour | Notes de jour dans le planning. |
| offerShiftRequests | collection offerShiftRequest | L’offre demande des shifts dans la planification. |
| openShiftChangeRequests | La collection openShiftChangeRequest | Demandes de shifts ouverts dans la planification. |
| openShifts | Collection openShift | L’ensemble des shifts ouverts dans un groupe de planification dans la planification. |
| schedulingGroups | Collection schedulingGroup | Regroupement logique des utilisateurs dans la planification (généralement par rôle). |
| Shifts | Shift collection | Les shifts dans la planification. |
| shiftsRoleDefinitions | collection shiftsRoleDefinition | Définitions des rôles dans la planification. |
| swapShiftsChangeRequests | collection swapShiftsChangeRequest | Demandes d’échange pour des shifts dans la planification. |
| cartes de pointage | collection de cartes de temps | Cartes de pointage dans la planification. |
| timesOff | collection de timeOff | Instances de congés dans la planification. |
| timeOffReasons | collection timeOffReason | Ensemble des raisons d’un congé dans la planification. |
| timeOffRequests | timeOffRequest collection | Demandes de congé dans la planification. |
| workforceIntegrations | collection workforceIntegration | Une instance d’intégration du personnel par équipe avec un flux de données sortant sur des 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"
}