coIT.Clockodo.TimeEntriesValidator

WinForms Applikation mit der man über einen Bestimmten Zeitraum von ausgewählten Mitarbeitern Fehlerhafte Zeiteinträge rausfilern kann

Anleitung

Ersteinrichtung

.msi-Datei von GitHub Releases herunterladen und installieren

Wichtig: Es muss der verschlüsselte Datenbank ConnectionString als Benutzer-Umgebungsvariable COIT_TOOLKIT_DATABASE_CONNECTIONSTRING zur Verfügung stehen.

Updates

Beim Programmstart wird in den GitHub Releases automatisch nach Updates gesucht und diese installiert.

Filter

Man kann über den Start und Endzeitpunkt Filtern Man kann über jeden einzelnen Mitarbeiter Filtern

Zeiteinträge

• Es werden alle aktiven Mitarbeiter in Clockodo berücksichtigt.
• Es werden nur vergangene Tage berücksichtigt. D.h. wenn heute ein Zeitverstoß vorliegt, wird dieser erst morgen angezeigt.

Development

Deployment

Wenn eine neue Version released werden soll, muss nur ein neuer GitHub Release mit einem Tag im Format x.x.x erstellt werden.

Das Deployment startet daraufhin in einer GitHub Action durch den gepushten Tag automatisch.

Die .NET Version für den Publish workflow wird in der global.json festgelegt und muss in der Zukunft eventuell angepasst werden.

nuget-Packages

Um die notwendigen Packages aus dem privaten Package-Manager der co-IT aus GitHub zu laden, wird eine eigene nuget.config benötigt.

1. Stelle sicher, dass die GitHub Cli bei dir installiert ist (winget)
2. Falls du bisher noch nie eine nuget.config anlegen musstest führe gh auth login --scopes read:packages aus und verknüpfge deinen GitHub Account
3. Lege eine nuget.config Datei mit dem folgenden Inhalt an

<?xml version="1.0" encoding="utf-8"?>
<configuration>
    <packageSources>
        <clear />
        <add key="nuget.org" value="https://api.nuget.org/v3/index.json" />
        <add key="github" value="https://nuget.pkg.github.com/co-IT/index.json" />
    </packageSources>
    <packageSourceCredentials>
        <github>
            <add key="Username" value="{Nutzername}" />
            <add key="ClearTextPassword" value="{Token}" />
        </github>
    </packageSourceCredentials>
</configuration>

4. Führe gh api user -q ".login" aus und ersetze {Nutzername} in der nuget.config mit dem Ergebnis
5. Führe gh auth token aus und ersetze {Token} in der nuget.config mit dem Ergebnis

In Zukunft, kannst du diese nuget.config auch für andere Tools und Projekte nutzen, die Zugriff auf den co-IT GitHub package manager benötigen und musst nicht mehr den Schritten von oben folgen

Programmaufbau

• BusinessRules Hier werden Regeln festgelegt, welche bei der Prüfung von den Zeiteinträgen erfüllt werden muss. Bei Fehlern wird eine String mit der Fehlerbeschreibung zurückgegeben