Ana içeriğe atla

Documentation Index

Fetch the complete documentation index at: https://docs.azalt.co/llms.txt

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

ImportResult, belirli bir site ve zaman dönemi için bir içe aktarma yürütmesinin sonucunu saklar. Her sonuç, işlenmiş veri anlık görüntüsünü ve form gönderimlerini oluşturan eşlemeleri içerir.

​
Temel Amaç

  • Sonuç Takibi: Site/dönem başına neyin içe aktarıldığını kaydeder
  • Veri Anlık Görüntüsü: İşlenmiş çıkış değerlerini korur
  • Eşleme Kaydı: Hangi form elemanlarının değer aldığını takip eder
  • Denetlenebilirlik: Bir içe aktarmanın gerçekte neyi değiştirdiğini incelemeyi sağlar

​
Varlık Yapısı

ImportResult {
  id: "impres-...",
  importId: "imp-...",           // Üst içe aktarma yürütmesi
  formSiteId: "fs-...",          // Hedef form-site kombinasyonu
  year: 2024,                    // Hedef yıl
  periodUnit: "MONTHLY",         // YEARLY, MONTHLY, QUARTERLY
  period: 1,                     // Dönem numarası (aylık için 1-12, çeyreklik için 1-4)
  processedData: {...},          // İşlemciden çıkış
  mapping: [...],                // Alan-eleman eşlemeleri
  rowsProcessed: 12              // Kullanılan giriş satırı sayısı
}

​
İşlenmiş Veri

processedData alanı, işlemci kodundan çıkışı saklar: Basit çıkış: 
{
  "toplam_enerji": 15420.5,
  "enerji_kaynagi": "Şebeke Elektriği"
}
Dönemsel çıkış (sonuç başına saklanır): 
{
  "aylik_tuketim": 1250
}
Bu alan tam çıkış türlerini korur:
  • Sayılar sayı olarak kalır
  • Metinler metin olarak kalır
  • Boolean’lar boolean olarak kalır

​
Eşleme Yapısı

mapping alanı, çıkış değerlerinin nasıl eklendiğini kaydeder: 
[
  {
    "outputKey": "toplam_enerji",
    "formElementId": "fe-abc123",
    "valueInserted": 15420.5
  },
  {
    "outputKey": "enerji_kaynagi",
    "formElementId": "fe-def456",
    "valueInserted": "Şebeke Elektriği"
  }
]
Her eşleme girişi şunları gösterir:
  • outputKey: İşlemci çıkış alanı
  • formElementId: Değeri alan form elemanı
  • valueInserted: Saklanan gerçek değer

​
Dönem İşleme

ImportResult farklı dönem ayrıntılarını destekler: Yıllık (periodUnit: “YEARLY”, period: 1):
  • Yıl başına tek sonuç
  • Yıllık toplamlar veya ortalamalar için kullanılır
Aylık (periodUnit: “MONTHLY”, period: 1-12):
  • Her ay için ayrı sonuç
  • Period 1 = Ocak, Period 12 = Aralık
Çeyreklik (periodUnit: “QUARTERLY”, period: 1-4):
  • Her çeyrek için ayrı sonuç
  • Period 1 = Q1 (Oca-Mar), Period 4 = Q4 (Eki-Ara)

​
Çoklu Site Sonuçları

Gruplu içe aktarmalar için, her site kendi ImportResult’ını alır: 
Import (imp-123) üretir:
├── Site A için ImportResult, 2024, YEARLY
├── Site B için ImportResult, 2024, YEARLY
└── Site C için ImportResult, 2024, YEARLY
formSiteId her sonucu belirli FormSite kombinasyonuna bağlar.

​
İşlenen Satırlar

rowsProcessed alanı, bu sonuca kaç kaynak satırın katkıda bulunduğunu gösterir:
  • Grupsuz içe aktarmalar için: toplam satır sayısına eşittir
  • Gruplu içe aktarmalar için: bu sitenin grup anahtarıyla eşleşen satırlara eşittir

​
Erişim Kontrolü

ImportResult erişimi üst Import’tan devralınır:
  • Kullanıcılar yalnızca kuruluşlarındaki içe aktarmalardan sonuçları görebilir
  • RLS politikaları üst Import’un organizationId’sini kontrol eder

​
Sonuçları Sorgulama

Belirli bir içe aktarma için sonuçlar: 
SELECT * FROM "ImportResult"
WHERE "importId" = 'imp-123'
ORDER BY "formSiteId", year, period;
Belirli bir site için sonuçlar: 
SELECT ir.*, i."createdAt" as "importedAt"
FROM "ImportResult" ir
JOIN "Import" i ON i.id = ir."importId"
WHERE ir."formSiteId" = 'fs-456'
ORDER BY i."createdAt" DESC;

​
Veri Bütünlüğü

ImportResult kayıtları şunları sağlar: İzlenebilirlik: Hangi değerlerin içe aktarmalardan, hangilerinin manuel girişten geldiğini bilme Tekrar Üretilebilirlik: processedData anlık görüntüsü işlemcinin ne ürettiğini gösterir Hata Ayıklama: Eşleme kayıtları yanlış değerleri teşhis etmeye yardımcı olur

​
İlgili Varlıklar