Office365 List Mails By Folder, Office365 üzerinde belirli bir klasörün (mailFolderId) içindeki e-postaları listeler. Kkullanıcı bir klasör seçtiğinde (ör. Inbox, Sent, Archive) o klasördeki maillerin görüntülenmesini sağlar.

Teknik Özellikler

Klasör Bazlı Mail Listeleme: Belirtilen mailFolderId değerine sahip klasördeki mailleri döndürür. Dönen veri tipi Office365MailResult (One)’dır.

Parametreler:

• settings (Object – zorunlu): Office365 bağlantı ayarları. Configuration Manager’da tanımlı Office365 entegrasyonu seçilmelidir.
• mailFolderId (String – zorunlu): Hangi klasörün mailleri listelenecekse o klasörün kimliği. (Örn. Inbox klasör ID’si).
• search (String – opsiyonel): Konu, gönderen veya içerik bazlı arama yapılabilir.
• filter (String – opsiyonel): Belirli koşullara göre mailler filtrelenebilir (örn. sadece okunmamış mailler).

Office365 List Mails By Folder Uygulama Adımları

1. UI Design’da Aksiyon Tanımlama

• Ekrana bir Select Box ekleyin.
• Kullanıcının seçtiği klasörün ID’sini almak için bu bileşeni Office365 List Mail Folders aksiyonuyla bağlayın.
• Sonrasında + ADD ACTION → Office365 → Office365 List Mails By Folder seçin.

2. Parametreleri Yapılandırma

• settings: Configuration Manager’dan Office365 entegrasyonunu seçin.
• mailFolderId: Kullanıcının seçtiği klasörün id değeri buraya bağlanmalıdır.
• search: Örn. “project meeting” girilirse sadece bu kelimeyi içeren mailler döner.
• filter: Örn. isRead eq false girilirse sadece okunmamış mailler listelenir.

3. Dönen Veriyi Kullanma

Sonuçta dönen Office365MailResult tipinde veriler şunları içerir:

• id: Mail kimliği
• subject: Mail başlığı
• from: Gönderen kişi
• toRecipients: Alıcı listesi
• receivedDateTime: Alınma zamanı
• isRead: Okunup okunmadığı
• bodyPreview: İçeriğin kısa özeti

Bu bilgiler UI’daki listeye bağlanarak kullanıcıya gösterilebilir.

Kullanım Senaryosu: Inbox’taki Mailleri Listeleme

Adımlar:

1. Office365 List Mail Folders aksiyonu çalıştırılır, kullanıcıya Inbox, Sent, Archive gibi klasörler gösterilir.
2. Kullanıcı Inbox’ı seçer.
3. Seçilen klasörün id değeri → Office365 List Mails By Folder aksiyonuna parametre olarak gider.
4. Inbox’taki mailler listelenir.
5. Kullanıcı bir maili seçtiğinde messageId, Office365 Get Mail aksiyonuna gönderilerek detaylar açılır.

Office365 List Mails By Folder İleri Seviye Özelleştirmeler

• Dinamik Mail Kutusu: Kullanıcı farklı klasör seçtikçe otomatik olarak ilgili klasördeki mailler listelenir.
• Filtreleme: Sadece okunmamış mailleri veya belirli tarihten sonraki mailleri gösterebilirsiniz.
• Arama: search parametresi ile kullanıcı yazdığı anahtar kelimeye göre klasörde arama yapabilir.

Teknik Riskler ve Kontroller

• mailFolderId doğru olmalıdır. Yanlış ID girilirse sonuç dönmez.
• settings bağlantısı: Office365 entegrasyonu doğru yapılandırılmalıdır.
• search + filter kombinasyonu fazla kısıtlama yaparsa boş sonuç dönebilir.