Azure Functions Managed Connectors ile SharePoint ve Teams

Azure Functions Managed Connectors, SharePoint ve Teams gibi Microsoft 365 servisleri için webhook/OAuth altyapısını sizin adınıza yöneterek entegrasyonu genişletir. Trigger ile olaylar fonksiyona taşınır, typed istemcilerle dosya okunur ve Teams’te Adaptive

Azure Functions, trigger ve binding’ler sayesinde pek çok Azure servisine zaten bağlanabiliyor. Managed connectors (yönetilen bağlayıcılar) bu entegrasyon yüzeyini Microsoft 365, Microsoft Teams, Dataverse, SharePoint, OneDrive ve üçüncü taraf sistemleri kapsayacak şekilde genişletiyor; Microsoft’un aktardığına göre yaklaşık 1.700 connector fonksiyonların erişimine açılıyor. Webhook kayıt kodunu yazmak, her servis için OAuth token yönetmek gerekmiyor, geriye iş mantığı kalıyor.

Connector trigger ve typed client ikilisi

Programlama modeli iki parçadan oluşuyor:

  • Connector trigger: Dış servisteki bir olayı fonksiyonunuza taşır. Örneğin SharePoint’te yeni bir dosya oluşturulduğunda fonksiyon tetiklenir.
  • Typed connector client: Kodunuzun ilgili servis üzerinde işlem yapmasını sağlar. Dosya içeriğini okumak, Teams kanalına kart göndermek gibi aksiyonlar bu istemciler üzerinden yürür.

Bağlantının kendisini Azure Connector Namespace yönetiyor. Kimlik doğrulama, token yenileme, abonelik kaydı gibi altyapı işleri sizin kod tabanınızın dışında kalıyor.

Azure Functions ile Connector Namespace entegrasyonu şu an public preview aşamasında..NET isolated, Python ve Node.js destekleniyor. Güncel dil, hosting planı ve bölge desteği için managed connectors genel bakış dokümanını kontrol etmek gerekiyor, preview dönemindeki kapsam değişebilir.

Örnek senaryo: SharePoint’ten Teams bildirimine RFP akışı

Trigger ve aksiyonların birlikte nasıl çalıştığını göstermek için Microsoft.NET tabanlı bir RFP (teklif talebi) alım örneği paylaşıyor. Senaryo, paylaşılan bir SharePoint doküman kitaplığına düşen RFP belgelerinin elle okunup ilgili uzmanlara yönlendirilmesi derdini otomatikleştiriyor.

Akış şöyle ilerliyor:

  1. Müşteri, SharePoint doküman kitaplığına bir RFP yükler.
  2. Dosya oluşturulduğunda SharePoint connector trigger’ı Azure Function’ı çağırır.
  3. Fonksiyon, typed SharePoint istemcisiyle dosya içeriğini çeker.
  4. Azure Content Understanding belgenin metnini ve düzenini çıkarır.
  5. Fonksiyon, deterministik kurallarla müşteriyi, talep edilen yetkinlikleri ve önerilecek konu uzmanlarını belirler.
  6. Typed Teams istemcisi sonucu bir Adaptive Card olarak kanala gönderir.

SharePoint ve Teams bağlantılarını Connector Namespace üstleniyor; dosya işleme, belge analizi, yönlendirme kuralları, hata yönetimi ve bildirim içeriği ise tamamen fonksiyon kodunun kontrolünde kalıyor.

Kodda nasıl görünüyor?

Trigger, ConnectorTrigger özniteliğiyle tanımlanıyor ve dosyanın özelliklerini taşıyan tipli bir payload alıyor:

[Function("OnNewFile")]
public async Task OnNewFile(
[ConnectorTrigger] SharePointOnlineOnNewFileItemsTriggerPayload payload,
CancellationToken cancellationToken)
{
// Process the newly uploaded file.
}

Trigger içerik değil yalnızca dosya özelliklerini verdiğinden, belgenin kendisi typed SharePoint istemcisiyle alınıyor:

byte[] response = await _sharePoint.GetFileContentAsync(
Uri.EscapeDataString(siteAddress),
fileIdentifier,
cancellationToken: cancellationToken);
byte[] document = SharePointFileContent.Decode(response);

İstemciler dependency injection üzerinden kaydediliyor. Her istemci kendi Connector Namespace bağlantısının runtime URL’sini kullanıyor, kimlik doğrulamayı da DefaultAzureCredential ile yapıyor:

services.AddSingleton(
new SharePointOnlineClient(
new Uri(sharePointRuntimeUrl),
credential));
services.AddSingleton(
new TeamsClient(
new Uri(teamsRuntimeUrl),
credential));

Belge, Content Understanding’in prebuilt-layout analizörüne gönderiliyor, metin ve yapı bilgisi oradan çıkıyor. Ardından C# tarafındaki deterministik kurallar müşteriyi ve gerekli yetkinlikleri belirleyip bunları önceden tanımlı uzman rollerine eşliyor. Son adımda sonuç Adaptive Card olarak Teams kanalına gidiyor:

await _teams.PostCardToConversationAsync(
postAs,
postIn,
request,
cancellationToken);

Örnek depoda yalnızca fonksiyon kodu yok; Bicep ile yazılmış altyapı tanımları, Azure Developer CLI yapılandırması ve destekleyici betikler de birlikte geliyor. README dosyası akışın yerelde nasıl test edileceğini ve Azure’a nasıl dağıtılacağını anlatıyor.

Yaygın connector desenleri

Managed connectors, bir fonksiyonun dış sistemlerdeki olaylara tepki vermesi veya bu sistemler üzerinde işlem yapması gerektiğinde devreye giriyor. Microsoft’un öne çıkardığı desenler şunlar:

  • Olaydan aksiyona: Bir servisteki olaya tepki verip başka bir serviste işlem yapmak.
  • Olay → zenginleştirme → aksiyon: Harekete geçmeden önce olayla ilgili ek bilgi çekmek.
  • Olay → belge analizi → aksiyon: Belgeden metin ve yapı çıkarmak, uygulama kurallarını uygulamak ve sonucu başka bir connector üzerinden iletmek.
  • Olay → AI → aksiyon: Olay verisini bir AI servisiyle analiz edip sonucu connector aracılığıyla geri yazmak.
  • Mevcut function app’i genişletmek: HTTP, timer, queue, Service Bus, Event Grid veya Durable Functions iş yüklerinin yanına connector tabanlı entegrasyonlar eklemek.

RFP örneği bu desenlerin birkaçını birleştiriyor: SharePoint olayı akışı başlatıyor, SharePoint aksiyonu belgeyi getiriyor, Content Understanding içeriği çıkarıyor, uygulama kodu sonucu zenginleştiriyor, Teams aksiyonu bildirimi gönderiyor.

Functions mı, Logic Apps mi?

Managed connectors; SharePoint, Teams, Microsoft 365, Dataverse ve çok sayıda üçüncü taraf sistemi Azure Functions programlama modeline dahil ediyor. Altındaki webhook ve OAuth altyapısını kurmak size kalmıyor.

Microsoft’un önerdiği ayrım şöyle: Kod öncelikli bir uygulamada bu geniş entegrasyon yüzeyine ihtiyaç duyuyorsanız ve trigger ile aksiyon arasında özel dallanma, uygulama kütüphaneleri ve SDK’lar, diğer Functions binding’leri, belge veya AI işleme ya da uygulamaya özgü mantık gerekiyorsa Azure Functions’ı tercih edin. İş yükü ağırlıklı olarak connector işlemlerini orkestre ediyorsa, özel kod payı düşükse ve görsel bir tasarımcıdan fayda sağlanacaksa Azure Logic Apps genellikle daha basit seçenek oluyor.

Özellik hala preview aşamasında. Üretim planlaması yaparken dil, plan ve bölge desteğini resmi dokümandan doğrulamak gerekiyor.

Kaynaklar ve İleri Okuma

Bu yazı yapay zeka (büyük dil modelleri) ile hazırlanmış, insan editör tarafından incelenmiştir. İçerik üretim sürecimiz.
Aşkın KILIÇ

20+ yıl deneyimli Azure Solutions Architect. Microsoft sertifikalı bulut mimari ve DevOps danışmanı. Azure, yapay zekâ ve bulut teknolojileri üzerine Türkçe teknik içerikler üretiyor.

AZ-305AZ-104AZ-500AZ-400DP-203AI-102

Bu içerik işinize yaradı mı?

Benzer içerikleri kaçırmamak için YouTube ve GitHub hesaplarımı takip edin.

Haftalık Bülten

Her pazar özenle seçilmiş teknoloji yazıları doğrudan e-postanıza gelsin.

Kurumsal DevOps ve bulut dönüşümü danışmanlığı: Danışmanlık Hizmetleri

4 Yorum

  1. Managed connector’ların OAuth tarafını kendisinin halletmesi gerçekten büyük kolaylık, SharePoint webhook’larını elle yönetmek tam bir kabustu. Teams trigger’ları production’da ne kadar stabil, deneyen var mı acaba?

  2. SharePoint webhook’larını elle yönetmeye çalışırken epey uğraşmıştım, OAuth yenileme kısmını connector’ın halletmesi gerçekten büyük rahatlık. Teams trigger’ı production’da denediniz mi, gecikme süreleri nasıl? Bu arada şu yazınız da işime yaramıştı: Azure Cosmos DB RBAC: Tek Kişilik Projede Gerekli mi?

  3. SharePoint webhook’larını kendimiz yönetirken token yenileme işleri tam bir kabustu, managed connector bu derdi çözüyorsa süper. Peki Logic Apps yerine bunu tercih etmenin maliyet tarafında ciddi bir avantajı var mı?

  4. Managed Connectors sayesinde OAuth token yenileme derdinden kurtulmak gerçekten büyük rahatlık. Biz daha önce SharePoint webhook’larını elle yönetiyorduk, tam bir kabustu. Teams tarafında rate limit konusunda bir sıkıntı yaşadınız mı acaba?

Bir yanıt yazın

E-posta adresiniz yayınlanmayacak. Gerekli alanlar * ile işaretlenmişlerdir

✉

Haftalık Bülten

Azure, DevOps ve Yapay Zeka dünyasındaki en güncel içerikleri her hafta doğrudan e-postanıza alın.

Spam yok. İstediğiniz zaman iptal edebilirsiniz.
📱
Uygulamayı Yükle Ana ekrana ekle, çevrimdışı oku
Kategoriler
Ara
Paylaş
WhatsApp
İçindekiler
← Azure Virtual Desktop’ta...
GitHub Secret Scanning’e... →
📩

Gitmeden önce!

Her pazar özenle seçilmiş teknoloji yazıları ve AI haberleri doğrudan e-postanıza gelsin. Ücretsiz, spam yok.

🔒 Bilgileriniz güvende. İstediğiniz zaman ayrılabilirsiniz.

📬 Haftalık bülten: Teknoloji + AI haberleri
Beni Takip Et Yeni Azure / AI / DevOps yazılarını GitHub ve RSS üzerinden takip edin.