Freigeben über


workPlanOccurrence-Ressourcentyp

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 einen bestimmten Arbeitsplan instance für einen bestimmten Tag oder Zeitraum in Ihrem Arbeitsplan dar.

Ihre Arbeitsplan-Vorkommen können automatisch aus wiederkehrenden Arbeitsmustern generiert oder manuell für spezielle Arrangements erstellt werden. Diese Vorkommen sind nützlich, um Ausnahmen von Ihren regulären Zeitplänen zu behandeln. Die folgende Liste enthält Beispiele:

  • Arbeiten unterschiedlicher Stunden für einen bestimmten Tag
  • Arbeiten von einem anderen Standort aus
  • Freizeit nehmen

Wenn ein Arbeitsplan für denselben Zeitraum wie ein wiederkehrendes Muster vorhanden ist, hat das Vorkommen Vorrang, sodass flexible Zeitplananpassungen möglich sind.

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.
Festlegen des aktuellen Speicherorts Keine Aktualisieren Sie Ihren Arbeitsstandort für den aktuellen Tag oder das aktuelle aktive Segment.
Ansicht "Vorkommen" workPlanOccurrence-Sammlung Abrufen von Arbeitsplan-Vorkommen aus Ihrem eigenen Arbeitsplan innerhalb eines angegebenen Datumsbereichs.

Eigenschaften

Eigenschaft Typ Beschreibung
end dateTimeTimeZone Enddatum und -uhrzeit für dieses Vorkommen.
id Zeichenfolge Eindeutiger Bezeichner für das Vorkommen.
placeId Zeichenfolge Bezeichner eines Orts aus der Microsoft Graph-Places Directory-API. Gilt nur, wenn workLocationType auf officefestgelegt ist.
recurrenceId Zeichenfolge Der Bezeichner des übergeordneten Serienmusters, das dieses Vorkommen generiert hat. Der Wert gilt null für Time-Off-Vorkommen, da sie keine übergeordnete Wiederholung aufweisen.
start dateTimeTimeZone Das Startdatum und die Startzeit für dieses Vorkommen.
timeOffDetails timeOffDetails Die Details zur freien Zeit. Gilt nur, wenn workLocationType auf timeOfffestgelegt ist.
workLocationType workLocationType Der Typ des Arbeitsorts. Mögliche Werte sind: unspecified, office, remote, timeOff, unknownFutureValue.

workLocationType-Werte

Member Beschreibung
Unspecified Gibt an, dass der Benutzer den Speicherort nicht angegeben hat.
Büro Gibt an, dass der Benutzer von einem Bürostandort aus arbeitet.
Remote Gibt an, dass der Benutzer remote arbeitet.
timeOff Gibt an, dass sich der Benutzer in einer Auszeit befindet.
unknownFutureValue Wert des Sentinelwerts für die vervolvbare Enumeration. 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"
}