SAP PO/CPI ile Microsoft Graph API Entegrasyonu: Kapsamlı Rehber

SAP PO/CPI ile Microsoft Graph API entegrasyonu, kurumsal SAP sistemlerini Microsoft 365 ekosistemiyle — Azure AD, SharePoint, OneDrive, Teams ve Outlook — birleştirmenin en güvenilir yöntemlerinden biridir. OAuth 2.0 protokolü üzerinden kurulan bu bağlantı, hem SAP PI/PO hem de SAP Integration Suite (CPI) platformlarında standart HTTP Adapter kanalları aracılığıyla yapılandırılır. Bu sayede manuel veri aktarımı ortadan kalkar, insan kaynaklı hatalar azalır ve kurumsal süreçler iki ekosistem arasında kesintisiz akar.

Microsoft Graph API Nedir?

Microsoft Graph API, Microsoft’un tüm bulut hizmetlerine tek bir uç nokta (https://graph.microsoft.com) üzerinden programatik erişim sağlayan birleşik bir REST API’dir. Tek bir API anahtarıyla Azure AD, Exchange Online, SharePoint, OneDrive, Microsoft Teams, OneNote, Planner ve Excel verilerine ulaşılabilir. Microsoft’un resmi belgelerine göre Graph API, Microsoft 365’teki 300 milyondan fazla kurumsal kullanıcının verilerine erişim kapısıdır.

Graph API ile yönetilebilen başlıca işlem kategorileri şunlardır:

• Kullanıcı İşlemleri: Azure AD üzerindeki kullanıcılara erişme, oluşturma, güncelleme ve silme
• Dosya İşlemleri: SharePoint veya OneDrive üzerindeki dosyalara erişme, yükleme ve silme
• Microsoft Teams İşlemleri: Kullanıcıları takımlara ekleme, kanal oluşturma, mesaj gönderme
• Takvim ve Posta: Outlook takvim girişleri, e-posta gönderme ve okuma (Exchange Online)
• Diğer Uygulamalar: OneNote, Planner ve Excel üzerinde veri okuma/yazma işlemleri

SAP PO/CPI ile Microsoft Graph API Entegrasyonu Nasıl Çalışır?

SAP sistemleri ile Microsoft Graph API arasındaki veri alışverişi SAP PI/PO veya SAP Integration Suite (CPI) üzerinden kurulur. Her iki platform da OAuth 2.0 Client Credentials akışını standart kanallar (HTTP Adapter) aracılığıyla destekler; entegrasyon için özel bir kod geliştirilmesine gerek kalmaz.

Entegrasyonun teknik akışı şu adımlardan oluşur:

1. Azure AD’de Uygulama Kaydı: SAP sisteminin Graph API’ye erişebilmesi için Azure Active Directory’de bir uygulama (App Registration) oluşturulur; gerekli izinler (scope) tanımlanır.
2. OAuth 2.0 Token Alımı: SAP PO/CPI, Client ID ve Client Secret bilgilerini kullanarak Azure AD’den bir erişim tokeni (Bearer Token) talep eder. Bu token, genellikle 3.600 saniye geçerlidir.
3. Graph API Çağrısı: Alınan token, HTTP isteğinin Authorization başlığına eklenerek https://graph.microsoft.com/v1.0/ uç noktasına istek gönderilir.
4. SAP Sürecine Entegrasyon: Graph API’den dönen yanıt SAP mesaj formatına dönüştürülerek ilgili SAP modülüne (HR, ERP, SD vb.) iletilir.

Öne Çıkan Entegrasyon Senaryoları

MDP Group olarak SAP ve Microsoft ekosistemi entegrasyonlarında yüzlerce proje gerçekleştirdik. Aşağıdaki senaryolar, SAP PO/CPI ile Microsoft Graph API entegrasyonunda en sık karşılaştığımız kullanım alanlarını yansıtır:

1. SAP HR → Azure AD Kullanıcı Senkronizasyonu

SAP İnsan Kaynakları modülünde yeni personel oluşturulduğunda, bu bilgiler Graph API üzerinden Azure AD’ye otomatik aktarılır. Böylece IT ekibi manuel olarak kullanıcı açmak zorunda kalmaz; işe alım sürecinde kullanıcı hesabı hazır gelir. İşten ayrılma durumunda da hesap otomatik devre dışı bırakılır. Bu senaryo, özellikle büyük ölçekli işe alımların yaşandığı dönemlerde IT süreçlerini önemli ölçüde hızlandırır.

2. SAP ERP Mesajlarının OneDrive’a Kaydedilmesi

SAP ERP sisteminden üretilen raporlar, faturalar veya bildirimler; Graph API aracılığıyla belirlenen bir SharePoint klasörüne veya OneDrive’a otomatik yüklenir. Bu yapı, özellikle dış iş ortaklarıyla belge paylaşımında merkezi bir arşiv oluşturur. Kullanıcılar belgelerine SAP’e girmeden, dolaylı olarak erişebilir.

3. SAP Süreç Bildirimleri → Microsoft Teams Kanalı

Kritik SAP olayları (stok eşiğine ulaşma, fatura onay bekliyor, iş emri oluşturuldu vb.) gerçek zamanlı olarak belirli bir Teams kanalına veya kullanıcıya mesaj olarak iletilir. API entegrasyonu sayesinde bu bildirimler ek bir ara katman gerektirmeden SAP iş akışıyla tetiklenir. Ekipler, SAP ekranına bakmadan Teams üzerinden kritik uyarıları anında görür.

4. Outlook Takvim ile SAP Görev Senkronizasyonu

SAP’teki iş emirleri, görev atamaları veya proje milestonları Graph API üzerinden kullanıcıların Outlook takvimine otomatik aktarılır. Kullanıcılar SAP’e girmeden Outlook’tan görevlerini takip edebilir. Bu entegrasyon, özellikle saha ekipleri ve sık seyahat eden yöneticiler için büyük kolaylık sağlar.

5. SharePoint Form Verilerinin SAP’e Aktarılması

Satın alma talepleri, izin formları veya müşteri kayıtları gibi veriler SharePoint Power Apps üzerinden toplanıp Graph API aracılığıyla SAP’e iletilir. Bu senaryo, son kullanıcıların SAP arayüzüne ihtiyaç duymadan veri girebilmesini sağlar. Kullanıcı deneyimi iyileşir, veri giriş hataları azalır.

Entegrasyon Yapılandırmasında Dikkat Edilmesi Gerekenler

SAP PO/CPI ile Microsoft Graph API entegrasyonu kurgularken göz ardı edilmemesi gereken bazı teknik sınırlamalar ve en iyi uygulamalar vardır:

• Token Yenileme: Graph API tokenleri varsayılan olarak 1 saat geçerlidir. Uzun süren SAP toplu işlemlerinde (batch job) token sona ermesi hataya yol açar; otomatik token yenileme mekanizması kurulmalıdır.
• API Throttling: Microsoft Graph API, yüksek hacimli isteklerde hız sınırlaması (throttling) uygular. Toplu işlemlerde istek sayısı ve zaman aralığı dikkatli planlanmalıdır.
• İzin Yönetimi (Scopes): Azure AD’de tanımlanan uygulama izinleri minimum gereksinim prensibine göre verilmelidir; aşırı izin güvenlik açığına yol açar.
• SAP PO vs. CPI Farkı: SAP PO’da HTTP Channel üzerinden yapılan entegrasyon, CPI’da önceden yapılandırılmış OAuth2 güvenlik materyalleri ile daha kolay yönetilir. SAP PO’nun 2027’de bakım sonu desteğine girmesiyle birlikte CPI’ya geçiş planlanması önerilir.
• Hata Yönetimi: Graph API’den dönen 4xx ve 5xx hataları için SAP entegrasyon akışlarında uygun exception handling ve retry mekanizmaları tanımlanmalıdır.

SAP PI/PO ile SAP CPI Karşılaştırması: Microsoft Graph API Entegrasyonu Açısından

Her iki platform da Graph API entegrasyonunu destekler; ancak yapılandırma kolaylığı ve bakım açısından aralarında önemli farklar bulunur. Azure Adapter’ın SAP Integration Suite’deki rolü ve modern entegrasyon mimarileri açısından CPI, bulut tabanlı konnektörler ve merkezi güvenlik yönetimi ile daha güncel bir seçenektir.

• SAP PI/PO: Şirket içi (on-premise) kurulum, geniş özelleştirme imkânı, ancak yüksek bakım maliyeti ve 2027 bakım sonu tarihi
• SAP CPI (Integration Suite): Bulut tabanlı, otomatik güncelleme, OAuth2 yapılandırması daha az adım gerektirir, SAP BTP üzerinde çalışır

SAP PO’dan CPI’ya geçiş planlıyorsanız, SAP Integration Suite danışmanlık hizmetlerimizi inceleyebilir; ayrıca BTP Integration Suite API yönetimi yeteneklerini anlatan blog yazımıza göz atabilirsiniz.

MDP Group ile Microsoft Graph API Entegrasyonu

MDP Group olarak SAP PI/PO ve SAP Integration Suite üzerinde Microsoft Graph API entegrasyonlarını hem standart hem de özelleştirilmiş senaryolara göre tasarlıyor ve devreye alıyoruz. Çözümlerimiz; token yönetimi, hata işleme, yeniden deneme mekanizmaları ve izleme altyapısını kapsıyor. Deneyimlerimize göre projelerin büyük çoğunluğunda önceden yapılandırılmış SAP CPI iFlow şablonları kullanmak hem süreyi kısaltıyor hem de işletme riskini düşürüyor. Kurumunuzun Microsoft 365 ekosistemine SAP üzerinden sorunsuz bağlanması için bizimle iletişime geçebilirsiniz.

Sıkça Sorulan Sorular

SAP PO/CPI ile Microsoft Graph API entegrasyonunda hangi kimlik doğrulama yöntemi kullanılır?

SAP PO ve CPI, Microsoft Graph API’ye bağlanırken OAuth 2.0 Client Credentials akışını kullanır. Azure AD’de bir uygulama kaydı oluşturulur; SAP tarafında ise Client ID, Client Secret ve Tenant ID bilgileri yapılandırılır. Token alımı ve yenileme SAP platformu tarafından otomatik yönetilir, kullanıcı müdahalesine gerek kalmaz.

SAP HR ile Azure AD kullanıcı senkronizasyonu gerçek zamanlı mı çalışır?

Senkronizasyon hem gerçek zamanlı (olay tabanlı) hem de toplu (batch) modda çalışabilir. SAP HR’da personel oluşturulması veya güncellenmesi gibi bir olay tetiklendiğinde, SAP entegrasyon platformu anında Graph API’yi çağırarak Azure AD’yi günceller. Toplu modda ise SAP işleri belirli aralıklarla çalışarak kitlesel değişiklikleri senkronize eder.

SAP CPI ile SAP PO arasında Microsoft Graph API entegrasyonu açısından hangi platform tercih edilmelidir?

Yeni projeler için SAP Integration Suite (CPI) tercih edilmelidir. CPI, bulut tabanlı OAuth2 güvenlik materyalleri, otomatik platform güncellemeleri ve daha az bakım maliyeti sunar. SAP PO’nun 2027’de bakım sonu desteğine girmesi nedeniyle mevcut PO entegrasyonlarının da CPI’ya taşınması planlanmalıdır.

Microsoft Graph API rate limiting (hız sınırlaması) SAP entegrasyonunu nasıl etkiler?

Microsoft Graph API, servis başına belirli istek kotaları uygular. SAP toplu işlemleri çok sayıda API çağrısı yaparsa 429 (Too Many Requests) hatası alınabilir. Bunu önlemek için SAP entegrasyon akışlarında üstel geri çekilme (exponential backoff) mantığı ve istek gruplama (batching) mekanizması uygulanmalıdır.

SAP Integration Suite ile Microsoft Graph API entegrasyonunda hangi adaptör kullanılır?

SAP Integration Suite’de Microsoft Graph API bağlantısı için HTTP Receiver Adapter kullanılır. OAuth2 kimlik bilgileri SAP BTP Security Material olarak tanımlanır ve iFlow içinde referans alınır. Bu sayede Client Secret bilgileri şifreli saklanır ve merkezi olarak yönetilebilir.

Referanslar

• Microsoft Graph API Resmi Dokümantasyonu
• Azure AD OAuth 2.0 Client Credentials Akışı
• SAP PI/PO Danışmanlığı — MDP Group
• SAP Integration Suite Danışmanlığı — MDP Group
• API Entegrasyonu Nedir? — MDP Group
• Azure Adapter’ın SAP Integration Suite’deki Rolü — MDP Group
• BTP Integration Suite API Yönetimi — MDP Group

Alper Özkonuş

SAP PI/PO Danışmanı