Get Audit Logs aksiyonu, projeye ait genel denetim (audit) kayıtlarını sayfalanmış olarak listelemek için kullanılır. Get Document Audit Logs'tan farklı olarak tek bir dokümana değil, tüm proje genelindeki denetlenebilir işlemlere odaklanır.

Kayıtlar, en güncel işlem en üstte olacak şekilde tarih alanına göre azalan sırada döner.

Get Audit Logs aksiyonu hem web hem de mobil uygulamalarda kullanılabilir.

Yetki Gereksinimi

Kullanıcının proje üzerinde denetim kayıtlarını görüntüleme (audit log görüntüleme) yetkisine sahip olması gerekir.

Get Audit Logs Aksiyonu Uygulama Adımları

1. UI Design'da Aksiyon Tanımlama

• Kuika platformunda projenizi açın.
• UI Design modülüne geçin ve bir "Denetim Kayıtları" veya "Audit Log" ekranı oluşturun.
• Bir Table elementi ekleyin.

• Bir event tanımlayın:
  
  • Initial Actions (pageInit) → Authorization → Get Audit Logs

2. Parametreleri Yapılandırma

Opsiyonel Parametreler:

• startDate (DateTime): Denetim kayıtlarının başlangıç tarihini belirtir. Belirtilmezse tüm geçmiş kayıtlar dahil edilir.
• endDate (DateTime): Denetim kayıtlarının bitiş tarihini belirtir. Belirtilmezse en güncel kayda kadar getirilir.
• targetType (String): Hangi varlık türüne ait kayıtların getirileceğini belirtir (ör. User, Role, Document).
• pageNumber (Int): Sayfa numarasıdır. (Varsayılan: 1)
• pageSize (Int): Sayfa başına kayıt sayısıdır. (Varsayılan: 50, Maksimum: 200)

Ek Yapılandırma Seçenekleri (toggle):

• Show this project's logs: Aktif edildiğinde, yalnızca içinde bulunulan projeye ait denetim kayıtları getirilir. Kapalıyken kullanıcının erişim yetkisine sahip olduğu tüm projelerin kayıtları listelenebilir.
• Don't trigger validations: Aktif edildiğinde, aksiyon çalıştırılırken standart doğrulama (validation) kontrolleri atlanır. Performans odaklı senaryolarda veya doğrulamanın gereksiz olduğu arka plan işlemlerinde kullanılabilir.
• Enable Audit Logs: Bu aksiyonun kendisinin bir denetim kaydı oluşturup oluşturmayacağını belirler. Aktif edildiğinde, audit log verisinin görüntülenmesi işlemi de sistem tarafından ayrıca loglanır.

Dönüş Değeri

AuditLogDto[] (Many): Sayfalanmış denetim kayıtları listesi.

Kayıtlar şu alanları içerebilir:

• Action
• UserId
• TargetType
• OccurredAt
• Details

Yanıt Header Bilgileri

• X-Total-Count: Toplam kayıt sayısı
• X-Page: Mevcut sayfa
• X-Page-Size: Sayfa boyutu

Kullanım Senaryosu: Proje Genelinde Denetim Kayıtlarını Görüntüleme

Bir yönetici, proje genelinde gerçekleşen kullanıcı ve yetkilendirme işlemlerini incelemek ister.

Adımlar:

• "Denetim Kayıtları" ekranı oluşturun.
• Aksiyonu çalıştırın:
  
  • Initial Actions → Get Audit Logs
• Parametreleri isteğe bağlı olarak bağlayın:
  
  • startDate, endDate → tarih aralığı seçimi için DateRange component
  • targetType → Select Box üzerinden seçim
• Aksiyon sonrası:
  
  • Dönen veriyi Table component içinde gösterin.
  • Her satırda şu bilgiler gösterilebilir:
    
    • İşlem türü (Action)
    • Kullanıcı
    • Hedef tür (TargetType)
    • Tarih (OccurredAt)
    • Ek detaylar

Örnek Kullanım

const auditLogsResult = await getAuditLogs(  this,  "2026-01-01T00:00:00",  "2026-08-01T00:00:00",  "User",  1,  50);

Get Audit Logs İleri Seviye Özelleştirmeler

• Filtreleme (tarih aralığı, hedef tür, kullanıcı) UI tarafında Select Box, DateRange gibi elementlerle desteklenebilir.
• Güvenlik ve uyumluluk (compliance) dashboard'larında kullanılabilir.
• Kritik işlemler (rol değişikliği, yetki ataması, silme) tabloda renk veya badge ile vurgulanabilir.
• Show this project's logs kapalıyken çoklu proje verisi geldiğinden, tabloya bir "Project" kolonu eklenmesi önerilir.

Teknik Riskler ve Kontroller

• pageSize değeri 200'ü geçmemelidir.
• Büyük veri setlerinde pagination mutlaka kullanılmalıdır.
• Yetki kontrolü doğru yapılmalıdır; audit log görüntüleme yetkisi olmayan kullanıcılar için aksiyon veri döndürmemelidir.
• Enable Audit Logs aktifken oluşan ek loglar, sistem performansı ve log hacmi açısından izlenmelidir.