Ressourcen > Abwesenheiten

Eine Abwesenheit ist ein Zeitraum, in dem ein Mitarbeiter abwesend ist. Das Feld AbsenceReasonID verweist auf den zugehörigen Abwesenheitsgrund.

Pfad

https://api.logmytime.de/v1/api.svc/Absences

Eigenschaften

Name	Typ	Beschreibung
ID	Integer	Eine eindeutige Abwesenheits-ID
UserID	Integer	Die ID des Mitarbeiters, dem die Abwesenheit zugewiesen ist
AbsenceReasonID	Integer	Die ID des zugehörigen Abwesenheitsgrundes
IsPublicHoliday	Boolean (read only)	Gibt an, ob es sich um einen Feiertag handelt. Feiertags-Abwesenheiten werden vom System verwaltet und können über die API nicht erstellt, geändert oder gelöscht werden.
Comment	String, Max. Länge: 4000	Ein optionaler Kommentar zur Abwesenheit
StartDate	Datum/Uhrzeit	Der erste Tag der Abwesenheit. Die Uhrzeit liegt immer zu Mitternacht.
EndDate	Datum/Uhrzeit	Der letzte Tag der Abwesenheit. Die Uhrzeit liegt immer zu Mitternacht.
FirstDayIsHalfDay	Boolean	Gibt an, ob der erste Tag der Abwesenheit nur ein halber Tag ist
LastDayIsHalfDay	Boolean	Gibt an, ob der letzte Tag der Abwesenheit nur ein halber Tag ist
Certified	Boolean	Der Nachweisstatus der Abwesenheit: "true" = Nachweis erbracht, "false" = Nachweis ausstehend, "null" = kein Nachweis erforderlich
LastChangeTime	Datum/Uhrzeit	Der Zeitpunkt, zu dem die Abwesenheit zuletzt verändert wurde
EditAccessGranted	Boolean (read only)	Gibt an, ob der aktuelle Nutzer diese Abwesenheit ändern darf. Wird immer nur serverseitig gesetzt.
DeleteAccessGranted	Boolean (read only)	Gibt an, ob der aktuelle Nutzer diese Abwesenheit löschen darf. Wird immer nur serverseitig gesetzt.

Zugriffsrechte

	Lesen	Schreiben
Admin	ja	ja
Erweiterte Nutzerrechte	Einstellbar in Firmenweiten Einstellungen	Einstellbar in Firmenweiten Einstellungen
Standardnutzer	ja (nur eigene Abwesenheiten)	Einstellbar in Firmenweiten Einstellungen (nur eigene Abwesenheiten)

Für Schreibzugriffe auf Abwesenheiten gelten zusätzliche Einschränkungen:

• Abwesenheiten für Feiertage (IsPublicHoliday = true) können über die API nicht erstellt, geändert oder gelöscht werden. Sie werden ausschließlich vom System verwaltet.
• Nutzer ohne Administratorrechte können eine Abwesenheit nur innerhalb von 30 Minuten nach der letzten Änderung bearbeiten, und nur, wenn sie diese Änderung selbst vorgenommen haben.
• Nutzer ohne Administratorrechte können keine Abwesenheiten erstellen, ändern oder löschen, deren Zeitraum vor dem Buchungsschluss beginnt.
• Ob Standardnutzer und Nutzer mit erweiterten Rechten Abwesenheiten erfassen dürfen, und ob auch für andere Mitarbeiter, legen die firmenweiten Einstellungen fest.

Die Felder EditAccessGranted und DeleteAccessGranted geben an, ob der aktuelle Nutzer eine bestimmte Abwesenheit ändern oder löschen darf. Das Feld WriteAccessGranted der Ressource Abwesenheitsgründe gibt an, ob er Abwesenheiten mit einem bestimmten Abwesenheitsgrund anlegen darf. Datumswerte in Schreibanfragen müssen dem ISO-8601-Format entsprechen (yyyy-MM-ddTHH:mm:ss.fffZ).

Beispiel

Alle Abwesenheiten mit Beginn im Jahr 2024 nach Startdatum sortiert auflisten:

GET https://api.logmytime.de/v1/api.svc/Absences?$filter=year(StartDate) eq 2024&$orderby=StartDate&ApiKey={apischluessel}

<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<feed ...>
   ...
   <entry>
      ...
      <content type="application/xml">
        <m:properties>
          <d:ID m:type="Edm.Int32">8842</d:ID>
          <d:UserID m:type="Edm.Int32">58934</d:UserID>
          <d:AbsenceReasonID m:type="Edm.Int32">31204</d:AbsenceReasonID>
          <d:IsPublicHoliday m:type="Edm.Boolean">false</d:IsPublicHoliday>
          <d:Comment m:null="true" />
          <d:StartDate m:type="Edm.DateTime">2024-07-15T00:00:00</d:StartDate>
          <d:EndDate m:type="Edm.DateTime">2024-07-26T00:00:00</d:EndDate>
          <d:FirstDayIsHalfDay m:type="Edm.Boolean">false</d:FirstDayIsHalfDay>
          <d:LastDayIsHalfDay m:type="Edm.Boolean">false</d:LastDayIsHalfDay>
          <d:Certified m:type="Edm.Boolean" m:null="true" />
          <d:LastChangeTime m:type="Edm.DateTime">
            2024-06-01T10:22:00
          </d:LastChangeTime>
          <d:EditAccessGranted m:type="Edm.Boolean">true</d:EditAccessGranted>
          <d:DeleteAccessGranted m:type="Edm.Boolean">true</d:DeleteAccessGranted>
        </m:properties>
      </content>
    </entry>
    ...weitere Abwesenheiten...
</feed>