Office365 Get Mail, Microsoft Office365 üzerinde bulunan bir e-postayı messageId bilgisine göre getirir. Bu aksiyon sayesinde belirli bir mailin başlığı, içeriği, göndereni, alıcıları ve ekleri görüntülenebilir.

Teknik Özellikler

E-posta Getirme: Verilen messageId değerine karşılık gelen e-posta döndürülür. Dönen veri tipi Office365Message (One)’dır.

Parametreler:

• settings (Object – zorunlu): Office365 bağlantı ayarlarını içerir. Config Manager üzerinden tanımlanan Office365 API ayarı seçilmelidir.
• messageId (String – zorunlu): Getirilecek e-postanın Office365 üzerindeki benzersiz kimliği.

Veri Kaynağı Uyumluluğu:

• Sabit değer (Fixed Value) girilebilir (örn. AAMkAD…AAAJ).
• Dinamik kaynaklardan (Current, Action Result, Method Input) alınabilir.

Office365 Get Mail Uygulama Adımları

1. UI Design’da Aksiyon Ekleme

• Mail detayını göstermek istediğiniz ekrana gidin.
• Bir Button elementi ekleyin (örn. “Maili Getir”).
• Butona tıklayın → + ADD ACTION → Office365 → Office365 Get Mail seçin.

2. Parametreleri Tanımlama

• settings: Configuration Manager’dan Office365 bağlantınızı seçin.
• messageId: Getirmek istediğiniz mailin ID bilgisini girin veya dinamik bir kaynaktan bağlayın (örn. “Inbox Listesi”nden seçilen mailin ID’si).

3. Dönen Veriyi Kullanma

• Dönen sonuç Office365Message tipindedir. İçerisinde:
  
  • subject: Mail başlığı
  • body: Mail içeriği (HTML / text)
  • from: Gönderen bilgisi
  • toRecipients: Alıcılar listesi
  • ccRecipients / bccRecipients: CC ve BCC bilgileri
  • attachments: Ekler
    bulunur.

Kullanım Senaryosu: Mail Detaylarını Gösterme

Bir kullanıcı, gelen kutusundaki bir e-postanın detaylarını görmek istiyor.

Adımlar:

1. “Inbox” listesinde e-postalar listelenir (Office365 List Mails).
2. Kullanıcı bir maili seçer.
3. Seçilen mailin messageId değeri → Office365 Get Mail aksiyonuna parametre olarak gönderilir.
4. Mailin başlığı, içeriği ve ekleri detay ekranında gösterilir.

Office365 Get Mail İleri Seviye Özelleştirmeler

• Liste ile Kombinasyon: Office365 List Mails aksiyonu ile gelen kutusunu listeler, Office365 Get Mail aksiyonu ile seçilen mailin detayını gösterirsiniz.
• Ek Yönetimi: Dönen mail ekleri (attachments) kullanıcıya indirme veya önizleme imkanı verebilir.
• Workflow Entegrasyonu: Örneğin bir gelen maildeki içerik otomatik olarak Jira Issue oluşturmak için kullanılabilir.

Teknik Riskler ve Kontroller

• messageId doğru girilmelidir. Yanlış girilirse sonuç dönmez.
• settings doğru yapılandırılmalıdır. Office365 API bağlantısı yanlışsa hata alınır.
• Yetki sınırları: Kullanıcı yalnızca kendi erişim izni olan mailleri görüntüleyebilir.