Form

​

Form Mimarisi

• Form = Meta veriler, görünürlük ayarları ve dağıtım yapılandırması içeren konteyner
• FormElement = Form içindeki bireysel alanlar ve UI bileşenleri
• FormSite = Formları belirli site ve yıllara bağlayan dağıtım bağlantıları
• FormSubmission = Kullanıcı gönderim oturumu konteyneri
• FormElementSubmission = Bireysel alan değerleri ve veri depolama

​

Form Ayarları

​

Halka açık gönderim seçenekleri

• allowPublicSubmissionEdits: true olduğunda halka açık katılımcılar mevcut gönderimlerini (veya taslaklarını) tekrar açıp düzenleyebilir; göndermezseniz platformun varsayılan düzenleme politikası uygulanır.
• allowPublicSubmissionSupportingDocuments: Halka açık gönderimlerde destekleyici doküman çekmecesini açar ve kullanıcıların kanıt dosyası yüklemesine izin verir. Tanımsız bırakmak varsayılan belge politikasını korur.

​

İş akışı geçersiz kılma

​

Planlama ve hatırlatmalar

​

Form düzeyinde varsayılan planlar

• dataEntry: Katılımcı son tarihlerini kontrol eder
• approval: Onaylayıcı son tarihlerini kontrol eder

• dueDate: Esnek bir son tarih belirtimi (aşağıdaki türlere bakın)
• reminders: Opsiyonel hatırlatma yapılandırma bloğu:
  • enabled: Hatırlatmaları etkinleştirmek/devre dışı bırakmak için boolean değer
  • offsets: Son tarihten kaç gün önce hatırlatma gönderileceğini belirten { type: "days-before"; days: number } nesneleri dizisi. days değeri 1-30 aralığında olmalıdır. enabled true olduğunda zorunludur; enabled false olduğunda göz ardı edilir.

​

Son tarih belirtim türleri

• specific-date yalnızca YEARLY periyotlarla kullanılabilir. month değeri 1-12 aralığındadır (1 = Ocak). Ay uzunluğunu aşan günler (örn. Şubat’ta 31. gün) otomatik olarak son geçerli güne sınırlanır.
• relative-days için daysAfterPeriodEnd değeri 0-60 aralığındadır (0 = dönem bitişi günü).
• Son tarih ve hatırlatma hesaplamaları tutarlılık için UTC kullanır.

​

Element düzeyinde plan geçersiz kılma

// updateForm isteğine gönderilebilecek örnek payload
{
  settings: {
    allowPublicSubmissionSupportingDocuments: true,
    workflowOverride: { type: "REQUIRE_APPROVAL" },
    defaultSchedules: {
      MONTHLY: {
        dataEntry: {
          dueDate: { type: "fixed-day", day: 15 },
          reminders: { enabled: true, offsets: [{ type: "days-before", days: 3 }, { type: "days-before", days: 7 }] }
        },
        approval: {
          dueDate: { type: "last-weekday", weekday: 5 }, // Son Cuma
          reminders: { enabled: true, offsets: [{ type: "days-before", days: 1 }] }
        }
      },
      QUARTERLY: {
        dataEntry: {
          dueDate: { type: "relative-days", daysAfterPeriodEnd: 15 }, // Çeyrek bitiminden 15 gün sonra
          reminders: { enabled: true, offsets: [{ type: "days-before", days: 7 }] }
        }
        // approval alanı opsiyoneldir, çeyreklik dönemler için onay takvimi gerekmediğinde atlanabilir
      },
      YEARLY: {
        dataEntry: {
          dueDate: { type: "specific-date", month: 3, day: 31 }, // 31 Mart
          reminders: { enabled: true, offsets: [{ type: "days-before", days: 14 }] }
        }
        // approval alanı opsiyoneldir, yıllık dönemler için onay takvimi gerekmediğinde atlanabilir
      }
    }
  }
}

​

Form Türleri ve Dağıtım

• Ekip üyeleri verileri doğrudan platformda girer
• CSV toplu içe/dışa aktarma yetenekleri
• Otomatik veri gönderimi için API entegrasyonu
• Silinmemiş durumdayken her FormSite için tek gönderim
• Otomatik kaydetme UX’i görünüme göre değişebilir

• Her FormSite için benzersiz bir public URL
• Site/yıl başına birden çok gönderim
• Alan bazında onay (iş akışına göre)
• Marka başlığı (logo/renk) meta verileriyle

​

Akıllı Form Özellikleri

// Örnek: Yenilenebilir enerji seçilirse enerji kaynağı detaylarını göster
{
  type: "CONDITION",
  field: "energy-type",
  operator: "equals",
  value: "renewable",
  action: "show"
}

• YEARLY: Tek periyot birimi (1)
• MONTHLY: 12 periyot birimi (1–12)
• QUARTERLY: 4 periyot birimi (1–4)
• TIMESTAMP: Zaman damgalı giriş; recordedAt zorunlu, periyot birimi ay’dan türetilir

• total: Zaman içinde toplanabilen toplam değerler (ör. emisyon)
• snapshot: Zaman noktasındaki değerler (ör. faktör), dağıtılmaz

​

Gelişmiş Form Oluşturucu

• Oluştururken gerçek zamanlı önizleme
• Element yeniden sıralama ve iç içe geçirme
• Formlar arasında copy/paste
• CSV’den oluşturma veya mevcut formu kopyalama

• CSV içe aktarma (toplu)
• Kopyala & özelleştir
• Manuel oluşturucu

• Sürükle-bırak koşul oluşturma
• Birden fazla koşul türü (eşittir, içerir, büyüktür, vb.)
• AND/OR mantığı ile iç içe koşul grupları
• Gerçek zamanlı doğrulama ve önizleme

​

Veri Toplama İş Akışı

Üretim Tesisi A - 2024
Bölge Ofisi B - 2024, 2025
Tedarikçi Ağı - 2024 (Dış)

• Doğrudan platform girişi
• Doğrulama ile CSV içe aktarma
• API entegrasyonu
• Halka açık form gönderimleri (açıksa)

• Gerekli alan zorunluluğu
• Veri türü ve format doğrulaması
• Çapraz alan doğrulama kuralları
• Birim uyumluluğu kontrolleri

• CSV/XLSX dışa aktarma
• API uç noktaları
• Dashboard entegrasyonu
• Özet istatistikler

​

İş Akışı ve Onaylar

• DIRECT_APPROVAL: Yeni değerler APPROVED olarak kaydedilir
• REQUIRE_APPROVAL: Yeni değerler COMPLETED olarak kaydedilir ve onay bekler

• Satır içi onay kontrolleri: Her dönem satırı için Anında Onayla / Reddet / Geri Al düğmeleri ve canlı durum rozetleri bulunur. Reddedilen değerler, kullanıcı yeni veri girdiğinde otomatik olarak tekrar COMPLETED durumuna döner.
• Toplu işlemler: Aylık veya çeyreklik NUMBER / SINGLE_CHOICE / MULTIPLE_CHOICE / LONG_TEXT / SHORT_TEXT alanlarında tüm dolu dönemleri tek tıkla onaylayıp reddetmek mümkündür. ACTIVITY alanları da aynı dönem içindeki tüm satırlar için toplu onaya devam eder.
• Durum eşitlemesi: Durum değişiklikleri kullanıcı arayüzünde anında görünür ve raporlara gecikmesiz aktarılır.

​

Destekleyici Dokümanlar

• Özel gönderimler: Dosyalar doğrudan ilgili FormElementSubmission kaydına eklenir. Yetkili kullanıcılar yeni dosya yükleyebilir, var olanları indirebilir ve silebilir.
• Halka açık gönderimler: Çekmece açıldığında, oturum açmadan dosya yükleyebilmek için taslak bir gönderim oluşturulur veya mevcut taslak kullanılır. Çekmece daha önce yüklenen dosyaları listeler; silme işlemleri yalnızca yetkili iç ekip tarafından yapılır.
• Sayaçlar ve göstergeler: Ataş simgesi, bağlı dosya sayısını rozet şeklinde gösterir; yükleme ve silme işlemleri anında yenilenir.

​

Geliştirici Modu

​

Görev İlerlemesi Takibi

• Veri girişi ilerlemesi: İçinde bulunulan aya kadar olan doldurulmuş/doldurulması gereken alan sayısını hesaplar; hatırlatma günlerine göre geciken ayları vurgular.
• Onay ilerlemesi: Onay gerektiren formlarda, sıradaki onaylanması gereken değerlerin kalan/toplam sayısı ve gecikmedeki dönemler gösterilir.

​

Halka Açık Form Ayarları

• allowPublicSubmissionEdits
• allowPublicSubmissionSupportingDocuments

​

Notlar

• FormElement anahtarları bir form içinde benzersizdir
• ACTIVITY elementleri TIMESTAMP periyodunu kullanamaz
• Özel formlarda her FormSite için tek (silinmemiş) FormSubmission bulunur

​

Gerçek Dünya Örnekleri

• Aylık elektrik tüketimi (kWh birimi ile NUMBER)
• Enerji kaynağı seçimi (SINGLE_CHOICE: Şebeke/Güneş/Rüzgar)
• Koşullu yenilenebilir detayları (sadece yenilenebilir seçilirse gösterilir)
• Destekleyici dokümantasyon yüklemesi (FILE_UPLOAD)

• Çeyreklik atık akışları (birden fazla NUMBER alanı ile GROUP)
• Atık işleme yöntemi (MULTIPLE_CHOICE)
• Yönlendirme oranı hesaplaması (özel formülle ACTIVITY)
• Site-özel imha prosedürleri (LONG_TEXT)

• Şirket bilgileri (SHORT_TEXT alanları)
• Kapsam 1, 2, 3 emisyonları (tCO2e birimleri ile NUMBER)
• Aktivite tabanlı hesaplamalar (karmaşık emisyonlar için ACTIVITY)
• Aylık veri toplama (MONTHLY periyot ayarı)

​

Operasyonel Faydalar

• Tutarlılık: Tüm site ve zaman periyotları boyunca aynı form yapısı
• Verimlilik: Otomatik kaydetme, toplu işlemler ve şablon yeniden kullanımı
• Uyumluluk: Yerleşik doğrulama ve denetim izleri
• Ölçeklenebilirlik: Yüzlerce site ve binlerce gönderimi işleyin
• Esneklik: Geçmiş verileri kaybetmeden formları uyarlayın