Ana içeriğe atla

Documentation Index

Fetch the complete documentation index at: https://docs.twenty.com/llms.txt

Use this file to discover all available pages before exploring further.

Bir Twenty uygulamasının config katmanı, uygulamayı platforma tanımlar — kimliğini, sahip olduğu izinleri ve kurulum veya yükseltme sırasında çalışan kodu açıklar. Bu deklarasyonlar yeni veri biçimleri veya çalışma zamanı davranışı eklemez; Twenty’ye uygulamanın kim olduğunu ve nasıl kurulacağını söyler. 
┌────────────────────────────────────────────────────────┐
│ 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
       └──────────────────────────────────┘

​
Bu bölümde

Uygulama Yapılandırması

defineApplication — kimlik, varsayılan rol, değişkenler, marketplace metaverisi.

Roller ve İzinler

defineRole — uygulamanızın mantık fonksiyonlarının neleri okuyup yazabildiğini tanımlayın.

Kurulum Kancaları

definePreInstallLogicFunction ve definePostInstallLogicFunction — verileri yedekleyin, varsayılanları tohumlayın, yükseltmeleri doğrulayın.

​
Parçaların birbiriyle ilişkisi

  • Application giriş noktasıdır. Her uygulamada tam olarak bir defineApplication() çağrısı vardır ve bu çağrı varsayılan olarak bir Role işaret eder.
  • Rol, uygulamanın mantık fonksiyonlarının ve ön bileşenlerinin neleri okuyup yazabildiğini kontrol eder. En az ayrıcalık ilkesini izleyin: kodunuzun gerçekten ihtiyaç duyduğu izinleri verin.
  • Install Hooks, kurulum veya yükseltme sırasında çalışır — ön kurulum, metadata migrasyonundan önce (böylece riskli bir yükseltmeyi reddedebilir), son kurulum migrasyondan sonra (böylece yeni şemaya karşı varsayılan verileri tohumlayabilir).
Kurulum kancaları, mantık fonksiyonu çalışma zamanını paylaşır — aynı handler imzası, aynı ortam değişkenleri, aynı türlendirilmiş API istemcisi — ancak kendi define fonksiyonlarıyla deklare edilir ve normal tetikleyici modelinin (HTTP, cron, veritabanı olayları) dışında yaşarlar.