Übersicht

Konfigurieren Sie die App selbst – ihre Identität, Standardberechtigungen und das, was zur Installationszeit ausgeführt wird.

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
       └──────────────────────────────────┘
                          │
                          ▼  (at uninstall time)
       ┌──────────────────────────────────┐
       │ Uninstall hook                   │  before app removal
       └──────────────────────────────────┘

​

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, definePostInstallLogicFunction und defineUninstallLogicFunction – Daten sichern, Standardwerte befüllen, Aktualisierungen validieren, beim Entfernen aufräumen.

​

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). Der Uninstall-Hook wird direkt ausgeführt, bevor die App entfernt wird, sodass er externe Ressourcen bereinigen kann, während die Daten der App noch lesbar sind.

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).