Zum Hauptinhalt springen
Die Konfigurationsebene einer Twenty-App beschreibt die App für die Plattform – ihre Identität, die Berechtigungen, die sie hält, und den Code, der während der Installation oder Aktualisierung ausgeführt wird. Diese Deklarationen fügen keine neuen Datentypen oder Laufzeitverhalten hinzu; sie teilen Twenty mit, wer die App ist und wie sie eingerichtet werden soll. 
┌────────────────────────────────────────────────────────┐
│ Application — identity, default role, variables,       │
│               marketplace metadata                     │
│                                                        │
│   ┌──────────────────────────────────────────────────┐ │
│   │ Role — what the app's logic functions can read   │ │
│   │ and write (referenced by Application)            │ │
│   └──────────────────────────────────────────────────┘ │
└────────────────────────────────────────────────────────┘
                          │
                          ▼  (at install / upgrade time)
       ┌──────────────────────────────────┐
       │ Pre-install hook                 │  before metadata migration
       └──────────────────────────────────┘
       ┌──────────────────────────────────┐
       │ Post-install hook                │  after metadata migration
       └──────────────────────────────────┘

​
In diesem Abschnitt

App-Konfiguration

defineApplication – Identität, Standardrolle, Variablen, Marketplace-Metadaten.

Rollen & Berechtigungen

defineRole – deklariert, was die Logikfunktionen Ihrer App lesen und schreiben können.

Installations-Hooks

definePreInstallLogicFunction und definePostInstallLogicFunction – Daten sichern, Standardwerte befüllen, Aktualisierungen validieren.

​
Wie die Bausteine zusammenhängen

  • Application ist der Einstiegspunkt. Jede App hat genau einen defineApplication()-Aufruf, und dieser verweist auf eine Rolle als Standard.
  • Die Rolle steuert, was die Logikfunktionen und Frontend-Komponenten der App lesen und schreiben können. Folgen Sie dem Prinzip der geringsten Privilegien: Gewähren Sie nur die Berechtigungen, die Ihr Code tatsächlich benötigt.
  • Install Hooks laufen während der Installation oder Aktualisierung – Pre-Install vor der Metadatenmigration (so kann ein riskantes Upgrade abgelehnt werden), Post-Install nach der Migration (so können Standarddaten gegen das neue Schema befüllt werden).
Installations-Hooks nutzen die Laufzeit der Logikfunktion – gleiche Handler-Signatur, gleiche Umgebungsvariablen, gleicher typisierter API-Client –, werden aber mit ihren eigenen Define-Funktionen deklariert und leben außerhalb des regulären Trigger-Modells (HTTP, Cron, Datenbankereignisse).