Studio-Leitfaden

Was ist Studio?

Module Studio ist der visuelle Modul-Builder von dForge. Sie gestalten Entitäten, Ansichten, Menüs, Rollen und Aktionen im Browser und veröffentlichen sie dann als echte installierte Module — identisch zu handgeschriebenen.

Keine CLI, keine Code-Dateien, keine Deployment-Pipeline. Einfach gestalten, validieren und veröffentlichen.

Ein Projekt anlegen

1. Navigieren Sie in der Sidebar zu Studio
2. Klicken Sie auf + Neues Projekt
3. Geben Sie ein:
   • Modul-Code — Kleinbuchstaben-Identifier (z. B. tickets, assets)
   • Anzeigename — menschenlesbarer Name (z. B. „IT-Tickets“, „Asset-Verwaltung“)
   • Beschreibung — was dieses Modul macht

Entitäten gestalten

Entitäten sind Ihre Geschäftsobjekte (Tabellen). Jede Entität wird zu einer Datenbanktabelle.

Eine Entität hinzufügen

1. Öffnen Sie Ihr Projekt und gehen Sie zu Entitäten
2. Klicken Sie auf + Neue Entität
3. Definieren Sie:
   • Code — Tabellenname (z. B. ticket, asset)
   • Anzeigename — wird in der Oberfläche angezeigt
   • Beschreibung — optional

Felder hinzufügen

Für jede Entität fügen Sie Felder (Spalten) hinzu:

1. Klicken Sie auf einer Entität auf + Feld hinzufügen
2. Wählen Sie einen Feldtyp (Text, Zahl, Datum, Dropdown, Lookup usw.)
3. Setzen Sie Eigenschaften:
   • Spalten-Code — Datenbank-Spaltenname
   • Anzeigename — in der Oberfläche angezeigte Bezeichnung
   • Pflichtfeld — ob das Feld einen Wert haben muss
   • Standardwert — vorab gesetzter Wert für neue Datensätze
   • Maximale Länge — für Textfelder

Siehe die Felder-Referenz für alle verfügbaren Feldtypen und ihre Optionen.

Beziehungen

Um Entitäten zu verbinden:

1. Fügen Sie ein Lookup-Feld auf der Kind-Entität hinzu
2. Verweisen Sie damit auf die Eltern-Entität
3. dForge erstellt den Fremdschlüssel und die Referenz-Navigation automatisch

Beispiel: Eine ticket-Entität mit einem customer_id-Lookup-Feld, das auf die customer-Entität zeigt.

Constraints

Fügen Sie Check-Constraints hinzu, um Geschäftsregeln durchzusetzen:

• [quantity] > 0
• [end_date] >= [start_date]
• [status] IN ('Open', 'In Progress', 'Closed')

Ansichten gestalten

Ansichten definieren, wie Anwender Entitätsdaten sehen und mit ihnen interagieren.

Eine Ansicht erstellen

1. Gehen Sie in Ihrem Projekt zu Ansichten
2. Klicken Sie auf + Neue Ansicht
3. Wählen Sie:
   • Entität — welche Entität diese Ansicht darstellt
   • Ansichtstyp — Grid, Kanban, Liste, Kalender oder Timeline
   • Slug — URL-freundlicher Identifier

Spalten konfigurieren

Wählen Sie aus, welche Felder in der Ansicht erscheinen und in welcher Reihenfolge. Für Grid-Ansichten setzen Sie Spaltenbreiten. Master-Detail-Ansichten (z. B. Bestellungen mit Bestellpositionen) werden konfiguriert, indem Sie eine Kind-Entität auf Level 1 mit einem Eltern-Set-Feld hinzufügen.

Datenquellen

Jede Ansicht hat eine oder mehrere Datenquellen, die definieren, welche Entität abgefragt wird, Standard-Filter, Sortierreihenfolge und gegebenenfalls die Master-Detail-Beziehung.

Menüs und Ordner gestalten

Bauen Sie die Navigation Ihres Moduls:

1. Gehen Sie zu Menüs, um Menüpunkte zu erstellen, die auf Ihre Ansichten, Berichte und Unterordner verweisen
2. Gehen Sie zu Ordner, um die Ordnerstruktur zu definieren, mit der Ihr Modul ausgeliefert wird, einschließlich des Zeilenfilters jedes Ordners
3. Binden Sie Entitäten an Ordner, sodass dieselbe Entität in verschiedenen Ordnern unterschiedliche Spalten zeigen kann
4. Weisen Sie Symbole und Farben zu

Rollen gestalten

Definieren Sie, wer was tun kann:

1. Gehen Sie in Ihrem Projekt zu Rollen
2. Erstellen Sie Rollen (z. B. manager, accountant, viewer) — Modul-Rollen sind auf Ihr Modul namespaced
3. Weisen Sie für jede Rolle Rechte auf Sicherheitsobjekte zu:
   • Entitätsrechte: S (Select), I (Insert), U (Update), D (Delete), C (Clone)
   • Aktions- / Berichts- / Ordner-Rechte: E (Execute / Zugriff)
4. Rollen sind additiv — ein Anwender mit mehreren Rollen erhält die Vereinigung aller seiner Berechtigungen

Aktionen und Trigger gestalten

Studio kümmert sich auch um serverseitige Logik:

• Aktionen — serverseitige Skripte, in der dForge-DSL mit params:-, canExecute:- und execute:-Blöcken geschrieben. Siehe Aktionen & Workflows.
• Trigger — Automatisierung, die Aktionen auslöst, wenn Datensätze eingefügt, aktualisiert, gelöscht oder ein bestimmtes Feld geändert wird.

Einstellungen und Übersetzungen

• Einstellungen — konfigurierbare Werte, die Admins pro Ordner überschreiben können. Verwenden Sie sie in Formeln über $[SettingName].
• Übersetzungen — Bezeichnungen und Beschreibungen für Entitäten, Felder, Menüs und Aktionen in jeder Sprache, die Ihr Modul unterstützt.

Veröffentlichen

Wenn Ihr Design bereit ist:

1. Klicken Sie auf Validieren — Studio prüft auf Konsistenzfehler (fehlende Pflichtfelder, kaputte Referenzen, ungültige Formeln usw.)
2. Beheben Sie alle Validierungsfehler
3. Klicken Sie auf Exportieren, um ein .dforge-Paket herunterzuladen, oder auf Veröffentlichen, um das Modul direkt in den aktuellen Mandanten zu installieren
4. Sie können optional ein bestehendes Projekt forken, um ein neues Modul von einer funktionierenden Basis zu starten

Das veröffentlichte Modul verhält sich identisch zu handgeschriebenen Modulen — dieselben Datenbanktabellen, dasselbe Sicherheitsmodell, dasselbe Paketformat. Es gibt keine „Studio-Modus“-Laufzeit; der Output ist einfach ein normales dForge-Modul.

Iterieren

Nach dem Veröffentlichen können Sie weiter in Studio bearbeiten und erneut veröffentlichen, um Änderungen anzuwenden. Studio kümmert sich automatisch um Schema-Migrationen (Spalten hinzufügen, Constraints ändern).