Büyük Rapor Dışa Aktarma: Uzun İsteği Asenkron İşe Dönüştürmek

İstek kabulünü işin bitişi gibi göstermeyin

Microsoft’un asenkron istek-yanıt deseni, uzun işi kabul edip durum takibi için ayrı bir yol sunmayı açıklar. HTTP 202 yanıtı, durum adresi ve uygun sorgulama aralığı bu modelde değerlendirilebilir. [1] Ancak kabul yanıtı raporun başarıyla üretildiği anlamına gelmez; arayüz de bu farkı korumalıdır.

Önerilen akışta kullanıcı bir iş kimliği alır. Kuyrukta, çalışıyor, tamamlandı, başarısız veya iptal edildi durumları tanımlı olur. Gerçek ilerleme ölçülemiyorsa uydurma yüzde göstermek yerine aşama bilgisi verin. Kullanıcı sayfayı kapattığında işi yeniden başlatmadan durumuna ulaşabilsin.

Raporun veri kapsamını başlatırken kaydedin

Filtreler, hesap bağlamı, saat dilimi ve sütun seçimi iş kaydında saklanmalıdır. Kullanıcı sonra başka sayfaya geçtiğinde arayüzdeki güncel filtreler eski işin anlamını değiştirmesin. Bir raporun hangi ana veya döneme ait olduğunu dosyada ve durum ekranında açıklayın.

Varsayımsal stok raporu hazırlanırken ürünler güncelleniyor olsun. Rapordan tutarlı bir anlık görünüm bekleniyorsa buna uygun okuma yöntemi gerekir. Sadece işi kuyruğa almak tutarlılık sorununu çözmez. Kaynak sistemin sınırları nedeniyle sonuç farklı anlardan oluşuyorsa bu sınırlama dürüstçe belirtilmelidir.

Yetkiyi yalnızca düğmeye basarken kontrol etmeyin

Rapor üretildiği sırada kullanıcının görevi veya hesabı değişebilir. Dosya indirilirken güncel yetki tekrar değerlendirilsin. Bir rapor kimliğinin bilinmesi dosyaya erişim hakkı sağlamamalıdır. Üretilen dosyanın depolandığı yer ve paylaşım bağlantısının ömrü ayrıca tasarlansın.

İşçi süreç, rapor sahibinin hesap bağlamını açık biçimde taşımalıdır. Aynı anda iki şirketin işi işlendiğinde birinin filtresi diğerine karışmasın. Ortak geçici dosya adları veya yanlış önbellek anahtarları bu izolasyonu bozabilir. Testler dosyanın içindeki gerçek hesap sınırını kontrol etmelidir.

Örnek export kabul tablosu

İptal işleminin anlamını da belirleyin. Kuyruktaki işi kaldırmakla çalışmaya başlamış işi durdurmak aynı değildir. İptalden sonra yarım dosya kullanıcıya sunulmamalıdır. Yeniden deneme, önceki başarısız dosyayı yanlışlıkla tamamlandı olarak işaretlememelidir.

Kaynak kullanımını sınırlayın

Tek kullanıcının aynı anda çok büyük raporlar başlatması diğer işleri engelleyebilir. İş adedi, veri hacmi ve saklama için projenin kapasitesine uygun sınırlar belirleyin. Sınırı aşan isteğe anlaşılır geri bildirim verin; sadece bağlantının kesilmesini beklemeyin. Kritik operasyonel sorgularla rapor yükünün etkisi birlikte ölçülsün.

Teslim testinde küçük rapor kadar büyük, boş ve hatalı kapsamlı rapor bulunsun. Dosya adı, sütun başlıkları, satır toplamları ve hassas alanlar kontrol edilsin. Başarılı iş adedinin yanında başarısızlık nedeni ve bekleme süresi de izlenebilsin. Böylece export, tek bir düğmenin arkasındaki görünmez sorun olmaktan çıkar.

Sık sorulan sorular

Her rapor için kuyruk gerekir mi?

Hayır. Küçük ve hızlı işler doğrudan tamamlanabilir. Uzunluk, kaynak yükü ve kullanıcı deneyimi asenkron tasarım kararını belirler.

İndirme bağlantısını e-postaya koymak yeterli mi?

Hayır. Alıcı, yetki, süre ve bağlantının başkasına aktarılması değerlendirilmelidir. Mesaj gönderimi dosyanın güvenli erişimi yerine geçmez.