Ana içeriğe atla
Unit’ler, form elemanları ve göstergelere (indicator) eklediğiniz basit ölçüm etiketleridir. Amaç, sayıları anlamlandırmak (örn. enerji alanında “kWh” göstermek) ve organizasyon içinde tutarlılık sağlamaktır.

​
Kısa Özet

  • Nedir: Sadece ad (ör. “kWh”, “tCO2e”) ve kapsam (public/organizasyon) bilgisi olan etiketlerdir. Sembol, kategori, dönüşüm vb. ek alanlar yoktur.
  • Kapsam: Public (tüm organizasyonlara açık) veya Organizasyon (sadece ilgili organizasyona özel).
  • Kullanım Alanları: Form elemanları ve Göstergeler; dashboard’da göstergeler üzerinden görünür.
  • Yönetim: Özelleştirme → Unit’ler sayfasından Ekle/Sil/Birleştir. Public unit oluşturmak yalnızca sistem yöneticilerinin (admin) yetkisindedir.

​
Ne Değildir

  • Dahili bir birim türü/kategorisi, hassasiyet veya dönüşüm bilgisi tutulmaz.
  • Otomatik birim dönüşümü (hesaplamalarda veya dashboard’da) yoktur. Unit’ler hesaplamadan ziyade gösterim/tutarlılık amaçlıdır.

​
Kapsamlar

  • Public unit: Tüm organizasyonlar tarafından görülebilir. Oluşturma ve public unit birleştirme admin yetkisi gerektirir.
  • Organizasyon unit’i: Sadece ilgili organizasyona aittir. Organizasyon sahipleri oluşturma/silme/birleştirme yapabilir.

​
Nerede Görünür

  • Form elemanları: Sayısal alanlar bir unit referansı alabilir. Form görüntüleyici, alanın yanında unit adını (örn. “kWh”) gösterir. Veritabanında FormElement.unitId olarak saklanır.
  • Göstergeler (Indicator): Gösterge bir unit referansı alabilir ve bu değer dashboard’da gösterilir. Veritabanında Indicator.unitId olarak saklanır.

​
Yönetim İşlemleri

  • Listeleme: Özelleştirme → Unit’ler sayfasında public + organizasyon unit’leri görünür.
  • Oluşturma: Yeni bir unit adı ekleyin. Admin’ler Public olarak işaretleyebilir.
  • Silme: Unit silindiğinde referanslar null olur (etiket kaybolur). Kullanımdayken silmek yerine mümkünse birleştirmeyi tercih edin.
  • Birleştirme: 2+ unit seçip yeni bir ad vererek birleştirin; mevcut organizasyondaki referanslar yeni unit’e güncellenir, eskiler silinir. Public unit birleştirme admin yetkisi gerektirir. Dikkat: Silinen public unit’e diğer organizasyonlardaki referanslar null olur.

​
Organizasyonlar Arası Form Kopyalama

Bir form başka bir organizasyona kopyalanırken “Unit Eşleme” adımı gösterilir. Kaynak unit’leri hedef organizasyonda var olan bir unit’e eşleyebilir veya yeni unit oluşturabilirsiniz.

​
API Kısa Özet

  • units.list (viewer): Public + mevcut organizasyon unit’lerini listeler.
  • units.listForOrganization (admin + üyelik): Public + hedef organizasyon unit’lerini listeler.
  • units.create (owner): Organizasyon unit’i oluşturur; isCommon=true sadece admin.
  • units.delete (owner): Organizasyon unit’i silebilir; admin public unit de silebilir.
  • units.merge (owner): 2+ unit’i yeni bir isimde birleştirir; kapsam kurallarına uyar; public için admin gerekir.
OpenAPI ile yayınlanan REST eşdeğerleri:
  • GET /units, POST /units, DELETE /units/{id}, POST /units/merge.

​
Sınırlamalar ve Notlar

  • Dönüşüm, kategori veya hassasiyet gibi meta veriler tutulmaz.
  • Unit silindiğinde referanslar null olur (otomatik yeniden atama yok). Silme öncesi etkisini gözden geçirin.
  • İsim benzersizliği veritabanında zorlanmaz; aynı kapsam içinde yinelenen isimlerden kaçının.

​
En İyi Uygulamalar

  • Standart isimleri tutarlı kullanın (örn. “kWh”, “tCO2e”, “m³”).
  • Kullanımda olan unit’leri silmek yerine birleştirmeyi tercih edin.
  • Yaygın/standart birimler için public, kurum içi/özel birimler için organizasyon unit’i kullanın.
  • Formları organizasyonlar arasında kopyalarken unit eşlemeyi dikkatle gözden geçirin.

​
Örnekler

Unit’li form alanı
  • Alan: “Aylık Elektrik Tüketimi”
  • Unit: “kWh” (public veya organizasyon)
  • Görünüm: Sayı alanının sağında “kWh” etiketi.
Unit’li gösterge
  • Gösterge: “Toplam Scope 2 Emisyon”
  • Unit: “tCO2e”
  • Dashboard: Kart/grafikler, göstergenin unit adını kullanarak değeri gösterir.