Office365 List Mails, seçilen bir klasör (örn. Inbox, Sent Items) içindeki e-postaları listeler. Kullanıcının gelen kutusu veya belirli klasörleri uygulama ekranında görüntülemesi için kullanılır.

Teknik Özellikler

Mail Listeleme: Belirtilen klasördeki e-postaları döndürür. Dönen veri tipi Office365MailResult (One)’dır.

Parametreler:

• settings (Object – zorunlu): Office365 bağlantı ayarları. Config Manager üzerinden tanımlanmış Office365 API bağlantısı seçilmelidir.
• includeHiddenMessages (Boolean – opsiyonel): Gizli veya sistem mesajlarını listeye dahil eder (true/false).
• search (String – opsiyonel): Mailleri konu, içerik veya gönderen bazlı aramak için kullanılabilir. Örn: “invoice”.
• filter (String – opsiyonel): Mailleri filtrelemek için kullanılır. Örn: sadece “unread” mailleri getirmek için kullanılabilir.

Office365 List Mails Uygulama Adımları

1. UI Design’da Aksiyon Tanımlama

• Mail kutusunu göstereceğiniz ekrana bir Table elementi ekleyin.
• Bu listeye veri sağlamak için + ADD ACTION → Office365 → Office365 List Mails seçin.

2. Parametreleri Yapılandırma

• settings: Configuration Manager’dan Office365 entegrasyonunu seçin.
• includeHiddenMessages: Eğer true seçerseniz sistem/gizli mailler de listelenir.
• search: Belirli bir kelimeye göre arama yapılabilir (örn. “Meeting”).
• filter: İhtiyaca göre belirli tür mailleri listeleyebilirsiniz (örn. isRead eq false).

3. Dönen Veriyi Kullanma

Sonuçta dönen Office365MailResult tipinde veriler:

• id: Mail kimliği
• subject: Konu
• from: Gönderen
• toRecipients: Alıcılar
• receivedDateTime: Alınma tarihi
• isRead: Okunma durumu
• bodyPreview: İçeriğin kısa özeti
  gibi alanları içerir.

Bu alanlar UI’daki liste bileşenine bağlanarak “Mail Kutusu Görünümü” oluşturulabilir.

Kullanım Senaryosu: Inbox’ı Listeleme

Bir uygulamada kullanıcının gelen kutusunu listelemek istiyoruz.

Adımlar:

1. Kullanıcı giriş yaptıktan sonra Office365 List Mail Folders ile klasörler listelenir.
2. Kullanıcı “Inbox” klasörünü seçer.
3. Seçilen klasörün kimliği parametre olarak Office365 List Mails aksiyonuna gönderilir.
4. Sonuç olarak, Inbox’taki tüm mailler uygulamada listelenir.
5. Kullanıcı listeden bir mail seçtiğinde, ilgili messageId Office365 Get Mail aksiyonuna gönderilerek detay açılır.

Office 365 List Mails İleri Seviye Özelleştirmeler

• Arama: Kullanıcı arama kutusuna bir kelime yazar (örn. “Fatura”), aksiyon search parametresi ile filtrelenmiş sonuç döndürür.
• Okunmamış Mailleri Gösterme: filter parametresine isRead eq false girilerek yalnızca okunmamış mailler listelenebilir.
• Dinamik Yenileme: Liste belirli aralıklarla yenilenerek sürekli güncel kalabilir.

Teknik Riskler ve Kontroller

• settings doğru yapılandırılmalıdır. Bağlantı ayarları yanlışsa sonuç dönmez.
• search ve filter aynı anda kullanıldığında API’den dönen sonuçlar daralır, bu yüzden doğru kombinasyon yapılmalı.
• Yetki kısıtlamaları: Kullanıcı sadece erişim izni olan klasör ve mailleri görüntüleyebilir.