Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Namespace: microsoft.graph
Wichtig
Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.
Stellt eine bestimmte Arbeitsplan-instance für einen bestimmten Tag oder Zeitraum in Ihrem Arbeitsplan dar.
Ihre Arbeitsplanvorkommen können automatisch aus wiederkehrenden Arbeitsmustern generiert oder für spezielle Absprachen manuell erstellt werden. Diese Vorkommen sind nützlich für die Behandlung von Ausnahmen von Ihren regulären Zeitplänen. Die folgende Liste enthält Beispiele:
- Unterschiedliche Arbeitszeiten für einen bestimmten Tag
- Arbeiten von einem anderen Standort aus
- Auszeit nehmen
Wenn ein Arbeitsplanvorkommen für den gleichen Zeitraum wie ein wiederkehrendes Muster vorhanden ist, hat das Auftreten Vorrang, was flexible Zeitplananpassungen ermöglicht.
Methoden
| Methode | Rückgabetyp | Beschreibung |
|---|---|---|
| Create | workPlanOccurrence | Erstellen Sie ein neues workPlanOccurrence-Objekt in Ihrem eigenen Arbeitsplan. |
| Update | workPlanOccurrence | Aktualisieren Sie die Eigenschaften eines workPlanOccurrence-Objekts in Ihrem eigenen Arbeitsplan. |
| Löschen | Keine | Löschen Sie ein workPlanOccurrence-Objekt aus Ihrem eigenen Arbeitsplan. |
| Aktuellen Standort festlegen | Keine | Aktualisieren Sie Ihren Arbeitsort für den aktuellen Tag oder das aktuell aktive Segment. |
| Ansicht "Vorkommen" | workPlanOccurrence-Sammlung | Abrufen von Arbeitsplanvorkommen aus Ihrem eigenen Arbeitsplan innerhalb eines angegebenen Datumsbereichs. |
Eigenschaften
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| end | dateTimeTimeZone | Das Enddatum und die Endzeit für dieses Vorkommen. |
| id | Zeichenfolge | Eindeutiger Bezeichner für das Vorkommen. |
| placeId | Zeichenfolge | Bezeichner eines Ortes aus der Microsoft Graph Places Directory-API. Nur zutreffend, wenn workLocationType festgelegt ist auf office. |
| recurrenceId | Zeichenfolge | Der Bezeichner des übergeordneten Serienmusters, das dieses Vorkommen generiert hat. Der Wert gilt null für Abwesenheitsereignisse, da sie keine übergeordnete Wiederholung haben. |
| start | dateTimeTimeZone | Das Startdatum und die Startzeit für dieses Vorkommen. |
| timeOffDetails | timeOffDetails | Die Details zur arbeitsfreien Zeit. Nur zutreffend, wenn workLocationType festgelegt ist auf timeOff. |
| workLocationType | workLocationType | Die Art des Arbeitsortes. Mögliche Werte sind: unspecified, office, remote, timeOff, unknownFutureValue. |
workLocationType-Werte
| Member | Beschreibung |
|---|---|
| Nicht spezifiziert | Gibt an, dass der Benutzer den Speicherort nicht angegeben hat. |
| Büro | Gibt an, dass der Benutzer von einem Bürostandort aus arbeitet. |
| Remoterepository | Gibt an, dass der Benutzer remote arbeitet. |
| timeOff | Gibt an, dass der Benutzer in Abwesenheit ist. |
| unknownFutureValue | Evolvable Enumeration Sentinel-Wert. Nicht verwenden. |
Beziehungen
Keine.
JSON-Darstellung
Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.
{
"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"
}