Ana içeriğe atla
FormElement’ler formları oluşturan bireysel yapı taşlarıdır - kullanıcıların etkileşimde bulunduğu gerçek giriş alanları, metin alanları, açılır menüler ve UI bileşenleridir.

​
FormElement Türleri ve Yetenekleri

Veri Toplama Elementleri:
  • NUMBER: Birim entegrasyonu, ondalık hassasiyet, min/max doğrulama ile sayısal girişler
  • SHORT_TEXT: Karakter sınırları ve format doğrulama ile tek satırlı metin
  • LONG_TEXT: Açıklamalar ve yorumlar için çok satırlı metin alanları
  • SINGLE_CHOICE: Özel seçenek değerleri ve etiketleri ile radyo butonları
  • MULTIPLE_CHOICE: Birden fazla seçime izin veren onay kutuları
  • FILE_UPLOAD: Tür kısıtlamaları ve boyut sınırları ile dosya ekleri
UI ve Organizasyon Elementleri:
  • TITLE: Özel stil ve hiyerarşi ile bölüm başlıkları
  • PARAGRAPH: Talimatlar ve açıklamalar için zengin metin içeriği
  • DIVIDER: Form organizasyonu için görsel ayırıcılar
  • GROUP: İlgili alanları organize etmek için daraltılabilir bölümler
  • PAGE: Navigasyon kontrolleri ile çok sayfalı formlar
  • IMAGE: Görsel rehberlik için gömülü resimler
Gelişmiş Elementler:
  • ACTIVITY: Aktivite tanımlarına dayalı özel hesaplamalar (TIMESTAMP periyodu kullanılamaz)

​
Veri ve Periyotlar

FormElementSubmission, gelişmiş değer yönetimini işleyen temel veri depolama bileşenidir: Çok dönemli veri: Değerler dönem bazında saklanır 
FormElementSubmission {
  formElementId: "energy-consumption-field",
  periodUnit: 3,        // Mart (aylık: 1..12)
  sequence: 0,          // Bu periyot için ilk giriş
  value: 1250.5,        // Gerçek kWh değeri
  activityId: null      // Karmaşık hesaplama gerekli değil
}
Karmaşık Hesaplama Depolama: Gelişmiş hesaplamalar için Activity sonuçlarına bağlantı 
FormElementSubmission {
  formElementId: "emissions-calculation",
  periodUnit: 1,        // Q1 (çeyreklik: 1..4)
  sequence: 0,
  value: 2847.3,        // Hesaplanan tCO2e sonucu
  activityId: "act_123" // Activity hesaplamasına referans
}
Çoklu Giriş Desteği: Alan/periyot başına birden fazla gönderimi işleme (özellikle dış formlar için) 
// Tedarikçi A'nın verisi
FormElementSubmission { periodUnit: 6, sequence: 0, value: 850 }
// Tedarikçi B'nin verisi
FormElementSubmission { periodUnit: 6, sequence: 1, value: 1200 }
// İç tahmin
FormElementSubmission { periodUnit: 6, sequence: 2, value: 1000 }
Esnek değer depolama: value JSON farklı türleri destekler
  • Sayılar: 1250.5
  • Metin: "Sertifikalı tedarikçiden doğal gaz"
  • Diziler: ["Şebeke elektriği", "Güneş panelleri"]
  • Nesneler: {"scope1": 450, "scope2": 280, "total": 730}

​
Yapılandırma Seçenekleri

Birimler: Alanlara ölçü birimi bağlayarak etiketleme ve doğrulama sağlar Doğrulama Kuralları: Veri kalitesi ve tutarlılığını sağlayın
  • Gerekli alan zorunluluğu
  • Min/max değer doğrulaması
  • Metin alanları için format doğrulaması
  • Yüklemeler için dosya türü ve boyut kısıtlamaları
Koşullu Mantık: Diğer alan değerlerine dayalı dinamik davranış
  • Yanıtlara göre elementleri göster/gizle
  • Koşullu olarak doğrulama kurallarını değiştir
  • Mevcut seçenekleri dinamik olarak güncelle
Periyot yapılandırması: YEARLY, MONTHLY, QUARTERLY, TIMESTAMP (TIMESTAMP ACTIVITY için geçersiz) Dağıtım modu (NUMBER): total veya snapshot.

​
İş Akışı Durumu

Her kayıtlı değerin iş akışına bağlı bir durumu vardır (COMPLETED, APPROVED, REJECTED). Onaylar değer bazında uygulanır; ACTIVITY alanları için aynı dönem ve gönderimdeki tüm satırlar topluca güncellenebilir.

​
Gerçek Dünya Örnekleri

Enerji Tüketimi Alanı:
  • Tür: NUMBER
  • Birim: kWh
  • Doğrulama: Min 0, Max 1.000.000
  • Periyot: Aylık
  • Gerekli: Evet
Enerji Kaynağı Seçimi:
  • Tür: SINGLE_CHOICE
  • Seçenekler: [“Şebeke Elektriği”, “Güneş”, “Rüzgar”, “Doğal Gaz”]
  • Koşullu: Güneş/rüzgar seçilirse yenilenebilir detayları gösterir
Destekleyici Dokümantasyon:
  • Tür: FILE_UPLOAD
  • Kabul edilen: PDF, Excel, CSV
  • Max boyut: 10MB
  • Gerekli: Hayır
  • Metadata: Formlar publicSupportingDocumentsMode = "opt-in" şeklinde yapılandırıldığında bu alan için belge yükleme ikonunu göstermek için allowSupportingDocumentsUpload: true değerini ekleyin. Bu seçenek oluşturucuda Destekleyici belgeler (genel) anahtarı olarak görünür.

​
Satır içi seçim alt alanları

Bir seçenek seçildiğinde hemen altında yeni bir alan göstermek istediğinizde:
  • İlgili alt alan için yalnızca tek bir show grubu ve tek bir equals koşulu oluşturun; koşul tek bir SINGLE_CHOICE / MULTIPLE_CHOICE üst alanını ve tek bir seçenek değerini hedeflemelidir (toplayıcı SINGLE kalmalıdır).
  • Oluşturucuda Seçenek altında satır içi göster anahtarını etkinleştirin (koşul uygun değilse anahtar devre dışı kalır).
  • Çocuk alanlar seçilen seçeneğin altında ve tüm periyotlarda (TIMESTAMP satırları dahil) otomatik olarak yerleştirilir. config.inlineChoiceDisplay ayarlanmamış alanlar klasik düzeni kullanmaya devam eder.
Emisyon Hesaplaması:
  • Tür: ACTIVITY
  • Girişler: Yakıt tüketimi, emisyon faktörü
  • Çıktı: Toplam CO2e emisyonları
  • Otomatik hesaplama: Evet