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 Bildschirm Konnektoren ist Arbeitsbereichs- oder Unternehmensadministratoren vorbehalten, wie der Rest des Menüs Einstellungen. Er hat zwei Tabs: den Marktplatz (ausgehende Konnektoren) und API (API-Konten, Swagger-Dokumentation, Aufrufprotokoll). Der Marktplatz ist eine Funktion in der Einführungsphase: FoxPlan gibt den gesamten Katalog oder nur bestimmte Konnektoren für Ihre Instanz frei, und Sie sehen nur die freigegebenen — solange keiner freigegeben ist, sagt der Tab das. Um Zugriff anzufordern, wenden Sie sich an Ihren FoxPlan-Ansprechpartner.
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 |
| Zapier | Zapier | Middleware, iPaaS, Automatisierung | Beta — Standard |
| Make | Celonis (Make.com) | Middleware, iPaaS, Automatisierung | Beta — Standard |
| n8n | n8n | Middleware, iPaaS, Automatisierung | Beta — Standard |
| Microsoft Power Automate | Microsoft | Middleware, iPaaS, Automatisierung | Beta — Standard |
| Workato | Workato | Middleware, iPaaS, Automatisierung | Beta — Standard |
- 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.
iPaaS-Middleware (Zapier, Make, n8n, Power Automate, Workato)
Fünf Konnektoren zu No-Code-Automatisierungsplattformen werden standardmäßig auf jeder Instanz geliefert: Sie erscheinen unter Einstellungen → Konnektoren für Ihre Administratoren, ohne Freischaltungsanfrage. Sie arbeiten in beide Richtungen — ausgehende JSON-Ereignisse per Webhook, eingehende Aktionen über die REST-API (Registerkarte API der Konnektorseite) — und können nur auf die Instanz wirken, an die sie angebunden sind.
Die Einrichtung je Tool, das Format des gesendeten Ereignisses und der API-Katalog sind auf der eigenen Seite beschrieben: iPaaS-Middleware.
Ü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.