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 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"
}