Marketplace

Zum Stöbern und Übernehmen brauchst du kein Konto beim Marketplace. Zum Veröffentlichen meldest du dich dort mit GitHub oder einem E-Mail-Link an. Jede Einreichung wird geprüft, bevor sie öffentlich wird.

#Was sich teilen lässt

Gäste veröffentlichen nie etwas.

#Veröffentlichen

Was nie mitkommt: Zugangsdaten, Läufe und Webhook-Adressen eines Workflows, die Adresse deiner Instanz, Namen von Personen, hochgeladene Bilder eines Whiteboards (nur Bilder mit https-Adresse) und Datensatzkarten. Verweise eines Workflows auf Seiten, Datenbanken und Personen werden beim Übernehmen über den Namen neu zugeordnet oder bleiben leer. Bei Erscheinungsbildern mit eigenen Schriften: Veröffentliche nur Schriften, deren Lizenz das Weitergeben erlaubt.

#Übernehmen

Kommst du aus Flowplan in den Marketplace – über Mehr Vorlagen im Marketplace in der Vorlagen-Galerie, Marketplace öffnen unter Einstellungen → Import & Export oder beim Veröffentlichen –, merkt sich der Marketplace deine Instanz von selbst und zeigt einmal kurz Instanz übernommen: · ändern. Du musst die Adresse dann gar nicht eintippen.

Workflows kommen immer pausiert, als Entwurf an. Prüfe sie, ergänze fehlende Angaben und aktiviere sie selbst.

Eine heruntergeladene .flowplan-template-Datei übernimmst du unter Einstellungen → Import & Export → Vorlage aus dem Marketplace oder in der Vorlagengalerie über Vorlage importieren.

Flowplan prüft jede Datei selbst noch einmal: Größe (höchstens 25 MB), Aufbau der Datei, Pfade, Kompression und den Inhalt jeder Art – genau wie beim Import aus einer anderen Instanz.

#Import prüfen Neu

Bevor eine Einreichung öffentlich wird, prüft das Team des Marketplace sie in flowplan-admin auf zwei Arten: Eine Sicherheitsprüfung sucht im Paket nach riskanten Inhalten – etwa ausführbaren Dateien, Skripten in Dokumenten oder Anhängen, Zugangsdaten, persönlichen Daten oder Workflow-Schritten, die interne Adressen ansprechen –, und ein Import-Test spielt den Import in einem eigenen Test-Arbeitsbereich einer Flowplan-Instanz durch. Ein Paket mit einem blockierenden Fund wird nur veröffentlicht, wenn das Team das ausdrücklich begründet.

Den Import-Test kannst du auch selbst machen: Ob sich ein Paket in deiner Instanz importieren ließe, beantwortet POST /api/marketplace/check.

1. Flowplan liest das Paket genau wie beim Import: Größe (höchstens 25 MB), ZIP-Sicherheit, template.json, das Format der Art.
2. Dann folgt ein Probelauf im Arbeitsbereich: Der Import der Art läuft in einer Datenbank-Transaktion, die immer zurückgenommen wird – die Vorlage und eine Seite daraus mit Eigenschaften, Ansichten, Einträgen und Anhängen, die Whiteboard-Vorlage, das Erscheinungsbild mit seinen Schriften, die Linkregeln. So fallen auch Fehler auf, die erst beim Anlegen entstehen (doppelte Kennungen in einer Datenbank, Speicherplatz). Workflows werden gelesen, mit dem Arbeitsbereich abgeglichen und geprüft, aber nicht angelegt.

Es bleibt nichts zurück: keine Seite, keine Datei, kein Protokolleintrag, keine Webhooks oder Benachrichtigungen.

curl -X POST https://flowplan.example.com/api/marketplace/check \
  -H "Authorization: Bearer fp_…" \
  -F [email protected] -F workspaceId=<Arbeitsbereichs-ID>

• workspaceId (optional): der Arbeitsbereich des Probelaufs – du musst Mitglied sein (nicht Gast); Vorlagen brauchen Bearbeitungsrechte, Erscheinungsbild und Linkregeln Besitzerrechte. Ohne die Angabe nimmt Flowplan einen Arbeitsbereich, der dir gehört, sonst einen, in dem du bearbeiten darfst.
• dryRun=0: nur lesen, kein Probelauf.
• Die Antwort ist 200, auch wenn sich das Paket nicht importieren ließe, mit ok: true|false, kind, creates (was angelegt würde: templates, pages, fields, views, records, files, nodes, items, fonts, rules, theme), errors und warnings (jeweils code, de, en, ggf. at) und dryRun (ran, rolledBack, ms).
• Grenzen: 25 MB pro Paket, 30 Prüfungen in 10 Minuten pro Person. Ist der Marketplace ausgeschaltet, antwortet der Endpunkt mit 404.
• API-Tokens brauchen die Berechtigung Marketplace-Prüfung (siehe API und Webhooks).

Für flowplan-admin: Lege in einem eigenen Konto einen Test-Arbeitsbereich an, darin ein Token Nur lesen mit Marketplace-Prüfung, und trage Adresse, Token und Arbeitsbereichs-ID in flowplan-admin als MARKETPLACE_IMPORT_CHECK_URL, MARKETPLACE_IMPORT_CHECK_TOKEN und MARKETPLACE_IMPORT_CHECK_WORKSPACE ein.

#Datenschutz

• Deine Instanz verbindet sich nie mit dem Marketplace. Die Übergabe läuft in deinem Browser zwischen den beiden Fenstern; Flowplan schickt nur an die eingestellte Marketplace-Adresse und nimmt nur von dort etwas an.
• Der Marketplace-Server erfährt die Adresse deiner Instanz nicht. Flowplan hängt sie an seine Marketplace-Links nur als Teil hinter dem # an, den Browser nie an einen Server schicken; der Marketplace speichert sie in deinem Browser und entfernt sie sofort aus der Adresszeile. Er zählt nur anonym, wie oft eine Vorlage heruntergeladen oder in Flowplan geöffnet wurde – ohne IP-Adressen und ohne Cookies für Besucher.
• Beim Veröffentlichen geht nur die Datei an den Marketplace, die du im Dialog gesehen hast.

#Ausschalten

Über die Umgebung geht es auch: FLOWPLAN_MARKETPLACE_URL=off schaltet den Marketplace ab, eine andere Adresse (etwa ein eigener Marketplace) ersetzt https://marketplace.flowplan.org.