API Anleitung

Ressourcen > Fehlzeitengründe

Ein Fehlzeitengrund gibt an, weshalb ein Mitarbeiter abwesend ist, zum Beispiel Urlaub oder Krankheit.

Pfad

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

Eigenschaften

Name Typ Beschreibung
ID Integer Eine eindeutige Fehlzeitengrund-ID
Name String, Max. Länge: 60 Die Bezeichnung des Fehlzeitengrundes
Abbreviation String, Max. Länge: 5 Ein Kürzel für den Fehlzeitengrund, z. B. für die Anzeige in Kalenderansichten
Certifiable Boolean (read only) Gibt an, ob für Abwesenheiten mit diesem Grund ein Nachweis (z. B. eine Krankmeldung) hinterlegt werden kann
Active Boolean Nicht aktive Fehlzeitengründe gelten auf der LogMyTime Webseite als "abgelegt" und werden beim Erstellen neuer Abwesenheiten nicht mehr angeboten
CountsAsWorkTime Boolean Gibt an, ob Abwesenheiten mit diesem Grund als Arbeitszeit gewertet werden
AbsenceReasonType Integer (read only) Die Art des Fehlzeitengrundes. Folgende Werte sind möglich:
Wert Bedeutung
0 Benutzerdefiniert
2 Standard
3 Krankheit
4 Urlaub
5 Feiertag
WriteAccessGranted Boolean (read only) Gibt an, ob der aktuelle Nutzer Abwesenheiten mit diesem Fehlzeitengrund anlegen, ändern oder löschen darf. Dieses Feld bezieht sich auf die Ressource Abwesenheiten, nicht auf den Fehlzeitengrund selbst.
LastChangeAuthor Integer Die ID des Mitarbeiters, der den Fehlzeitengrund zuletzt geändert hat
LastChangeTime Datum/Uhrzeit Der Zeitpunkt, zu dem der Fehlzeitengrund zuletzt verändert wurde

Zugriffsrechte

Lesen Schreiben
Admin ja nein
Erweiterte Nutzerrechte ja nein
Standardnutzer ja nein

Schreiboperationen auf Fehlzeitengründe sind über die API nicht möglich.

Beispiel

Alle Fehlzeitengründe nach Namen sortiert auflisten:

GET https://api.logmytime.de/v1/api.svc/AbsenceReasons?$orderby=Name&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">31204</d:ID>
          <d:Name>Urlaub</d:Name>
          <d:Abbreviation>U</d:Abbreviation>
          <d:Certifiable m:type="Edm.Boolean">false</d:Certifiable>
          <d:Active m:type="Edm.Boolean">true</d:Active>
          <d:CountsAsWorkTime m:type="Edm.Boolean">false</d:CountsAsWorkTime>
          <d:AbsenceReasonType m:type="Edm.Int32">4</d:AbsenceReasonType>
          <d:WriteAccessGranted m:type="Edm.Boolean">true</d:WriteAccessGranted>
          <d:LastChangeAuthor m:type="Edm.Int32">58812</d:LastChangeAuthor>
          <d:LastChangeTime m:type="Edm.DateTime">
            2024-03-12T09:15:00
          </d:LastChangeTime>
        </m:properties>
      </content>
    </entry>
    ...weitere Fehlzeitengründe...
</feed>