Kimai
Microsoft Teams Integration
Hilft bei organisieren von projetbezogenen Dateien in Microsoft Teams
Klein IT Solutions
Microsoft Teams Integration für Kimai
Ein Kimai-Plugin zur automatischen Erstellung von Kunden- und Projektordnern in einem ausgewählten Microsoft-Team.
Basierend auf Ihren Kundendaten und Projekten in Kimai legt das Plugin die entsprechenden Ordnerstrukturen im gewünschten Team an – vollständig automatisiert und zuverlässig.
Optimieren Sie Ihre Dokumentenablage, reduzieren Sie manuellen Aufwand und stellen Sie sicher, dass Ihre Teams immer den passenden Ordner zur richtigen Zeit haben.
Perfekt für Agenturen, IT-Dienstleister und Unternehmen, die Microsoft Teams als zentrale Arbeitsplattform nutzen.
Automatische Ordnerstrukturen in Microsoft Teams
Das Plugin erstellt automatisch:
- Kundenordner
- Projektordner
- Strukturierte Ablagen unterhalb eines von Ihnen definierten Basisordners
Der gesamte Prozess geschieht über die Microsoft Graph API, ohne manuelles Eingreifen.
Was ist enthalten?
- ein neuer Konsolenbefehl
ms-teams:sync-foldersfür die Erstellung von Kunden- und Projektordnern - Validierung Ihrer Teams-Konfiguration (Team ID, Ordnerpfad)
- Unterstützung für
.env-Variablen:GRAPH_TENANT_IDGRAPH_CLIENT_IDGRAPH_CLIENT_SECRET
Systemvoraussetzungen
Sie benötigen:
- eine gültige Azure-App-Registrierung
- die Möglichkeit, Umgebungsvariablen in
.envzu setzen - Zugriff auf Microsoft Graph API
Einrichtungsschritte nach der Installation
- Fügen Sie in Ihrer Kimai-Installation eine
.envDatei hinzu:
GRAPH_TENANT_ID=
GRAPH_CLIENT_ID=
GRAPH_CLIENT_SECRET=
Wenn Sie Docker verwenden, fügen Sie die Variablen in Ihrer docker-compose.yml Datei hinzu oder setzen Sie die folgende Flags
-e GRAPH_TENANT_ID=''
-e GRAPH_CLIENT_ID=''
-e GRAPH_CLIENT_SECRET=''
beim Starten des Containers.
-
Konfigurieren Sie unter
Kimai → System → Microsoft Teams
das gewünschte Team und den Ordnerpfad. -
Führen Sie bei Bedarf den Konsolenbefehl aus:
bin/console ms-teams:sync-folders
Damit werden Kunden- und Projektordner mit Ihrem Microsoft-Team erstellt, solange Sie noch nicht existieren.
Kompatibilität
Die folgende Tabelle enthält einen Vergleich zwischen Plugin und benötigter Kimai Version.
| Plugin Version | Minimale Kimai Version |
|---|---|
| 1.0.0 | 2.44.0 |
Installation
Dateien kopieren
Extract the ZIP file and upload the included directory and all files to your Kimai installation to the new directory:
var/plugins/TeamsIntegrationBundle/The file structure needs to look like this afterwards:
var/plugins/
├── TeamsIntegrationBundle
│ ├── TeamsIntegrationBundle.php
| └ ... more files and directories follow here ...Cache leeren
After uploading the files, Kimai needs to know about the new plugin. It will be found once the cache was re-built. Call these commands from the Kimai directory:
How to reload Kimai cache
bin/console kimai:reload --env=prod
It is not advised, but in case the above command fails you could try:
rm -r var/cache/prod/*
You might have to set file permissions afterwards:
Adjust file permission
You have to allow PHP (your webserver process) to write to var/ and it subdirectories.
Here is an example for Debian/Ubuntu, to be executed inside the Kimai directory:
chown -R :www-data .
chmod -R g+r .
chmod -R g+rw var/
You might not need these commands in a shared-hosting environment.
And you probably need to prefix them with sudo and/or the group might be called different from www-data.
Datenbank erstellen
Run the following command:
bin/console ms-teams:sync-foldersThis will create the required database tables and update them to the latest version.
If you see an error like There are no commands defined in the "kimai:bundle:XYZ" namespace.,
then either the directory has a wrong name (must be var/plugins/TeamsIntegrationBundle/) or you forgot to clear the cache (look above).
Aktualisierung
Updating the plugin works exactly like the installation:
- Delete the directory
var/plugins/TeamsIntegrationBundle/ -
Execute all installation steps again:
- Dateien kopieren
- Cache leeren
- Update database with
bin/console ms-teams:sync-folders
Bilder
