Skip to main content
ImportDefinition, dış kaynaklardan (CSV, Excel) form gönderimlerine otomatik veri aktarımı sağlar. Her tanım, giriş sütunlarını, dönüşüm mantığını ve form elemanlarına çıkış eşlemelerini belirtir.

Temel Amaç

  • Veri Dönüşümü: Harici veri formatlarını form uyumlu değerlere dönüştürür
  • Çoklu Site Desteği: Tek bir içe aktarmada birden fazla site için veri işler
  • Tür Koruma: Sayısal, metin ve boolean çıkış değerlerini destekler
  • Dönem İşleme: Verileri YILLIK, AYLIK veya ÇEYREKLİK dönemlere eşler

Tanım Yapısı

Giriş Şeması

Kaynak dosyadan beklenen sütunları tanımlar:
Sütun Türleri:
  • string: Metin değerleri
  • number: Sayısal değerler (metinden otomatik dönüştürülür)
  • boolean: Doğru/yanlış (“true”, “1”, “evet” kabul eder)
Sütun Rolleri:
  • site_identifier: Gruplu çıktılarda satırları sitelerle eşleştirmek için kullanılır

Çıkış Şeması

Dönüşüm tarafından üretilen alanları tanımlar:
Dönem Birimleri:
  • YEARLY: Yıl başına tek değer (varsayılan)
  • MONTHLY: 1-12 dönemleri için değerler
  • QUARTERLY: 1-4 dönemleri için değerler

İşlemci Kodu

Giriş satırlarını çıkış değerlerine dönüştüren JavaScript kodu:
Kullanılabilir Değişkenler:
  • inputValues: Giriş satır nesnelerinin dizisi
  • $year: İçe aktarma için hedef yıl
Çıkış Formatları: Tekil çıkış (tüm siteler):
Gruplu çıkış (site başına):
Aylık veri:

Değer Türü Desteği

İçe aktarma sistemi tüm çıkış türlerini korur: Sayısal değerler:
Metin değerler:
Boolean değerler:
Null değerler (mevcutu sil):

İçe Aktarma Yürütme Akışı

1. Sütun Algılama: Sistem dosya sütunlarını giriş şemasıyla eşleştirir 2. Sütun Eşleme: Kullanıcı sütun atamalarını onaylar veya düzenler 3. Önizleme: İşlemci örnek veriler üzerinde çalışarak beklenen sonuçları gösterir 4. Çıkış Eşleme: Kullanıcı çıkış alanlarını form elemanlarıyla eşler 5. Yürütme: Sistem tüm satırları işler ve gönderimleri oluşturur 6. Sonuçlar: ImportResult kayıtları neyin içe aktarıldığını takip eder

Çoklu Site İçe Aktarmaları

Birden fazla site için veri içeren dosyalar için: Giriş dosyası:
Gruplama ile işlemci:
Sistem grup anahtarlarını otomatik olarak site adlarıyla eşleştirir ve her site için ayrı gönderimler oluşturur.

Erişim Kontrolü

  • İçe aktarmalar site erişim izinlerine uyar
  • Kullanıcılar yalnızca erişim yetkisi olan sitelere içe aktarabilir
  • Erişilemeyen siteler için gruplar sessizce atlanır

İçe Aktarma Kayıtları

Her içe aktarma yürütmesi şunları oluşturur: Import: Durum ve satır sayısı ile ana kayıt ImportResult: Site başına sonuçlar:
  • İşlenmiş veri anlık görüntüsü
  • Eklenen değerlerle alan eşlemeleri
  • Dönem meta verileri

Gerçek Dünya Örnekleri

Fatura İçe Aktarma:
  • Giriş: CSV formatında aylık faturalar
  • Çıkış: Site başına aylık enerji tüketimi
  • Eşleme: Tüketim alanı → Enerji form elemanı
Tedarikçi Veri Toplama:
  • Giriş: Tedarikçi emisyon tablosu
  • Çıkış: Kategori etiketleriyle Kapsam 1, 2, 3 değerleri
  • Eşleme: Birden fazla çıkış → Değerlendirme formu
Çeyreklik Finansal Veri:
  • Giriş: Çeyreklik rakamlarla finansal raporlar
  • Çıkış: Çeyrek bazında gelir ve maliyet
  • Eşleme: Q1-Q4 değerleri → Finansal form elemanları

Operasyonel Faydalar

Verimlilik: Saniyeler içinde yüzlerce değeri toplu içe aktar Doğruluk: Otomatik dönüşüm manuel giriş hatalarını azaltır Esneklik: Özel işlemciler her veri formatını işleyebilir Denetlenebilirlik: Veri anlık görüntüleriyle tam içe aktarma geçmişi Tür Güvenliği: Sayısal, metin ve boolean değerleri doğru şekilde korur