Konnektoren (Marktplatz)
Der Konnektoren-Marktplatz bündelt die Integrationen zwischen FoxPlan und Ihren externen Werkzeugen (Messaging, CRM, ERP, ITSM, HR). Jeder Konnektor wird auf einem Arbeitsbereich installiert, einmal konfiguriert und reagiert dann automatisch auf die Fachereignisse von FoxPlan (Statuswechsel, Zuweisung, Kommentar …).
Einstellungen → Konnektoren
Der Tab Konnektoren ist nur für FoxPlan-Mitarbeiter sichtbar (Konten, deren E-Mail oder Login auf @fox-plan.com endet). Es handelt sich um eine Funktion in der Einführungsphase, die von den FoxPlan-Teams im Auftrag der Kunden betrieben wird.
Katalog
| Konnektor | Hersteller | Kategorien | Reifegrad |
|---|---|---|---|
| Slack | Slack | Kommunikation, Benachrichtigungen | Stable |
| Microsoft Teams | Microsoft | Kommunikation, Benachrichtigungen | Stable |
| Google Chat | Kommunikation, Benachrichtigungen | Stable | |
| Jira Cloud | Atlassian | ITSM, Projektmanagement | Beta |
| HubSpot | HubSpot, Inc. | CRM, Marketing | Alpha |
| Odoo | Odoo S.A. | ERP, Open Source | Alpha |
| Pennylane | Pennylane | Finanzen, Buchhaltung | Alpha |
| Sage Business Cloud Accounting | Sage Group plc | Finanzen, Buchhaltung | Alpha |
| Cegid | Cegid | ERP, Finanzen, HR | Alpha |
| HiBob | Hibob | HR, People | Alpha |
| Infor M3 | Infor | ERP, Industrie | Alpha |
| SAP S/4HANA Cloud (Public) | SAP SE | ERP, Finanzen | Alpha |
- Stable: produktionsreif.
- Beta: funktionsfähig, Umfang kann sich noch ändern.
- Alpha: Startkonnektor (Verbindungstest + ein Flow). Nur zur Evaluierung geeignet.
Einen Konnektor installieren
- Öffnen Sie Einstellungen → Konnektoren.
- Klicken Sie auf die Karte des gewünschten Konnektors, um sein Detailblatt zu öffnen.
- Tab Konfiguration: Füllen Sie die erforderlichen Felder aus (URL, Tokens, Zugangsdaten …).
- Klicken Sie auf Speichern. Der Konnektor ist damit auf dem Arbeitsbereich installiert.
- Verwenden Sie Testen, um die Verbindung zu prüfen, bevor Sie die Flows aktivieren.
Mit dem Schalter oben auf dem Detailblatt lässt sich die Installation global aktivieren / deaktivieren, ohne die Konfiguration zu verlieren.
Konfigurationsfelder
Die Detailblätter verwenden typisierte Felder: Text, URL, Zahl, Boolesch, Liste, Textbereich, Passwort und Secret. Als Secret markierte Felder (API-Tokens, signierte Webhook-URLs …) werden im Ruhezustand verschlüsselt und nie wieder im Klartext angezeigt — eine Maske (••••) zeigt an, dass bereits ein Wert gespeichert ist.
Die Authentifizierung hängt vom Konnektor ab: eingehende Webhook-URL (Chat), API-Token, Bearer, Basic oder OAuth, je nach Zielwerkzeug.
Flows und Auslöser
Ein Konnektor stellt einen oder mehrere Flows bereit. Jeder Flow wird im Tab Flows des Detailblatts unabhängig aktiviert.
Die Benachrichtigungs-Flows reagieren auf folgende Aufgabenereignisse:
- Statuswechsel einer Aufgabe
- Wechsel des Verantwortlichen (Zuweisung)
- Änderung der Planungszuweisung
- Hinzufügen eines Kommentars
Die Aufgaben-Flows werden nur ausgelöst, wenn die entsprechenden Benachrichtigungsoptionen des Projekts aktiviert sind (Bei Statuswechsel benachrichtigen, Bei Zuweisung benachrichtigen, Bei Kommentar benachrichtigen …), die in der Projektdefinition festgelegt werden. Ein frisch installierter Konnektor bleibt also stumm, solange diese Optionen in den betroffenen Projekten nicht angehakt sind.
Manuelles Auslösen
Flows „auf Abruf" (zum Beispiel eine Synchronisation) können über die Schaltfläche Ausführen im Tab Flows manuell gestartet werden. Das Ergebnis (Erfolg / Fehlschlag, HTTP-Code) wird sofort zurückgemeldet.
Überwachung und Protokolle
Der Tab Protokolle jedes Konnektors listet die letzten Ausführungen auf: Datum, Flow, Ereignistyp, Status, HTTP-Code, Dauer und Meldung.
- Der Versand an die externen Werkzeuge erfolgt asynchron: Er beeinträchtigt nie das Speichern der Aufgabe in FoxPlan. Schlägt ein Konnektor fehl, wird die FoxPlan-Aktion normal abgeschlossen und der Fehler protokolliert.
- Die Protokolle werden nach einer Aufbewahrungsfrist (standardmäßig 60 Tage) automatisch bereinigt, gesteuert durch einen MongoDB-TTL-Index.
Die direkt auf dem Projektblatt hinterlegten Webhook-URLs für Slack / Teams / Google Chat funktionieren weiterhin wie bisher, parallel zu den Konnektoren. Die Marktplatz-Konnektoren ersetzen sie nicht: Sie bieten eine zentrale Konfiguration auf Ebene des Arbeitsbereichs.
Sicherheit
- Alle Konnektor-Secrets werden mit einem dedizierten Schlüssel (
CONNECTOR_SECRETS_ENCRYPTION_KEY) verschlüsselt (AES-GCM). - Die Konnektor-Daten (Installationen, Flow-Konfiguration, Protokolle) sind pro Arbeitsbereich abgeschottet (Tenant).
- Der Zugriff auf den Bildschirm ist FoxPlan-Konten vorbehalten, und die zugehörigen API-Aufrufe sind serverseitig geschützt.