Office365 List Mail Folders, bir Office365 hesabındaki e-posta klasörlerini (Inbox, Sent Items, Drafts, Deleted Items, vb.) listelemek için kullanılır. Bu aksiyon ile kullanıcıya tüm klasörler sunulabilir ve seçilen klasördeki mailler başka bir aksiyonla görüntülenebilir.

Teknik Özellikler

Klasör Listeleme: Kullanıcının erişim izni olan tüm e-posta klasörlerini döndürür. Dönen veri tipi Office365MailFolderResult (One)’dır.

Parametreler:

• settings (Object – zorunlu): Office365 bağlantı ayarları. Config Manager üzerinden tanımlanan Office365 entegrasyonu seçilmelidir.
• includeHiddenMessages (Boolean – opsiyonel): Gizli veya sistem mesajlarını da sonuçlara dahil etmek için kullanılır. true veya false değerlerini alır.
• search (String – opsiyonel): Belirli bir kelime ile klasör araması yapılabilir. (örn. “Archive” yazıldığında sadece arşiv klasörü gelir).
• filter (String – opsiyonel): Klasörleri belirli koşullara göre filtrelemek için kullanılır.

Office365 List Mail Folders Uygulama Adımları

1. UI Design’da Aksiyon Ekleme

• Kullanıcıya e-posta klasörlerini gösterecek bir Select Box ekleyin.
• Bu elemente veri sağlamak için + ADD ACTION → Office365 → Office365 List Mail Folders seçin.

2. Parametreleri Tanımlama

• settings: Configuration Manager’da tanımladığınız Office365 bağlantısını seçin.
• includeHiddenMessages: Eğer true seçerseniz, sistem/gizli klasörler de listelenir.
• search: İstenirse klasör adı araması yapılabilir. (örn. “Sent”)
• filter: Belirli kriterlere göre sonuç daraltılabilir.

3. Dönen Veriyi Kullanma

Dönen sonuç Office365MailFolderResult tipindedir ve tipik olarak:

• id: Klasör kimliği
• displayName: Klasör adı (örn. “Inbox”, “Drafts”)
• childFolderCount: Alt klasör sayısı
• totalItemCount: İçindeki toplam mail sayısı
• unreadItemCount: Okunmamış mail sayısı
  bilgilerini içerir.

Bu veriler UI’da listelenerek kullanıcıya “Klasör Seç” imkanı sunulabilir.

Kullanım Senaryosu: Mail Klasörlerini Listeleme

Bir uygulama içinde kullanıcıya tüm e-posta klasörlerini göstermek istiyoruz.

Adımlar:

1. Kullanıcı uygulamaya giriş yaptığında Office365 List Mail Folders aksiyonu çalıştırılır.
2. Dönen klasörler bir Select Box içinde gösterilir.
3. Kullanıcı bir klasör seçtiğinde → seçilen klasörün id bilgisi Office365 List Mails aksiyonuna parametre olarak gönderilir.
4. Böylece o klasöre ait mailler listelenir.

Office365 List Mail Folder İleri Seviye Özelleştirmeler

• Inbox → Get Mails Kombinasyonu: Kullanıcı Inbox klasörünü seçtiğinde otomatik olarak mailler listelenebilir.
  
  
• Filtreleme: Sadece belirli klasörler (örn. “Inbox”, “Sent”) kullanıcıya gösterilebilir.
• Unread Count Gösterme: Dönen unreadItemCount bilgisi ile her klasör yanında okunmamış mail sayısı gösterilebilir.

Teknik Riskler ve Kontroller

• settings doğru yapılandırılmalıdır. Yanlış yapılandırma bağlantı hatasına yol açar.
• Kullanıcı yetkileri: Kullanıcı sadece erişim hakkı olduğu klasörleri görebilir.
• Gizli mesajlar: includeHiddenMessages = true kullanıldığında sistem klasörleri de dönebilir, bu durumda UI’da filtreleme yapılması gerekebilir.