Kurumsal Sistem Düğümleri
6. Kurumsal Sistem Düğümleri
Kurumsal sistem düğümleri, SkyStudio iş akışlarını şirketinizin ERP ve CRM sistemlerine bağlar. Salesforce, SAP ve CANIAS ERP için özel düğümler sunulur. Bu düğümler genellikle IT departmanınızla birlikte yapılandırılır.
Düğüm kataloğunun Düğümler sekmesinin alt kısmında, sistem adına göre gruplanmış olarak yer alırlar.
Salesforce Düğümü
Salesforce düğümü, Salesforce CRM'inizdeki kayıtları sorgulamanızı ve yönetmenizi sağlar. Bağlantı için kullanıcı adı, şifre ve güvenlik token'ı kullanılır.
Bağlantı Kurulumu ve Yönetimi
Security Token Alma
Salesforce, API erişimi için şifrenizin yanında bir Security Token ister.
-
Salesforce'a giriş yapın.
-
Sağ üstteki profil resminize tıklayın ve Settings seçeneğini seçin.
-
Sol menüden My Personal Information → Reset My Security Token bölümüne gidin.
-
Reset Security Token butonuna tıklayın.
-
Token, hesabınıza kayıtlı e-posta adresine gönderilir.
-
Gelen e-postadaki token değerini kopyalayın.
Not: Security Token yalnızca e-posta ile gönderilir, ekranda gösterilmez. Şifrenizi her değiştirdiğinizde token da sıfırlanır ve SkyStudio bağlantısını güncellemeniz gerekir.
API Erişimini Doğrulama
Kullanıcınızın API erişim yetkisi olmalıdır.
-
Setup → Users → ilgili kullanıcıyı açın.
-
Profile bölümündeki profile tıklayın.
-
Administrative Permissions altında API Enabled seçeneğinin işaretli olduğunu doğrulayın.
Not: API erişimi Salesforce'un bazı sürümlerinde (örn. Essentials) sunulmaz. Yetkiyi göremiyorsanız Salesforce yöneticinizle görüşün.
Login URL Seçimi
| Ortam | Login URL |
|---|---|
| Üretim (Production) | https://login.salesforce.com |
| Test (Sandbox) | https://test.salesforce.com |
SkyStudio'ya Bağlantı Ekleme
-
İş akışı canvas'ının alt araç çubuğundaki zincir ikonuna (Uygulama Bağlantıları) tıklayın.
-
+ Yeni bağlantı butonuna tıklayın.
-
Sağlayıcı listesinden Salesforce seçin (CRM & Destek kategorisi altındadır).
-
Aşağıdaki alanları doldurun:
| Alan | Zorunlu | Açıklama |
|---|---|---|
| Bağlantı adı | Evet | Tanımlayıcı bir isim (örn. Prod Salesforce) |
| Kimler kullanabilir | Evet | Sadece ben / Çalışma alanı / Seçili kullanıcılar / Entegrasyonlar |
| Ad | Hayır | Kimlik bilgisi etiketi |
| Username | Evet | Salesforce kullanıcı adı (e-posta formatında) |
| Password | Evet | Salesforce şifreniz |
| Security Token | Evet | E-posta ile gelen token değeri |
| Login URL | Evet | https://login.salesforce.com veya sandbox adresi |
| API Version | Evet | Kullanılacak API sürümü (örn. 59.0) |
- Bağlantı ekleyin butonuna tıklayın.
Not: Şifre ve Security Token ayrı alanlara girilir; bazı entegrasyonlarda olduğu gibi birleştirilmez.
Operasyonlar
Salesforce düğümü tek bir operasyon sunar:
| Operasyon | Açıklama |
|---|---|
| Salesforce | SOQL sorgusu çalıştırır ve kayıt işlemleri yapar |
Parametreler
| Parametre | Zorunlu | Açıklama |
|---|---|---|
| Connection | Evet | Kullanılacak Salesforce bağlantısı |
| İşlem Tipi | Evet | Sorgula / Oluştur / Güncelle / Sil |
| Object | Evet | Salesforce nesnesi (örn. Account, Contact, Opportunity) |
| SOQL Sorgusu | Duruma göre | Sorgulama için SOQL ifadesi |
| Record ID | Duruma göre | Güncelleme ve silme için kayıt kimliği |
| Data (JSON) | Duruma göre | Oluşturma ve güncelleme için alan değerleri |
Sık Kullanılan Nesneler
| Nesne | Açıklama |
|---|---|
| Account | Şirketler |
| Contact | Kişiler |
| Lead | Potansiyel müşteriler |
| Opportunity | Satış fırsatları |
| Case | Destek talepleri |
| Task | Görevler |
SAP Düğümü
SAP düğümleri, SAP sisteminizdeki verilere üç farklı yöntemle erişmenizi sağlar: SAP HANA Query (doğrudan veritabanı sorgusu), SAP SOAP (klasik SAP servisleri) ve SAP REST (OData servisleri).
Bağlantı Kurulumu ve Yönetimi
Başlamadan Önce
SAP bağlantıları kurumsal güvenlik politikalarına tabidir. Aşağıdaki bilgileri IT / SAP Basis ekibinizden talep edin:
| Bilgi | Açıklama |
|---|---|
| Sunucu adresi | SAP sisteminin erişim adresi |
| Servis kullanıcısı | Entegrasyon için açılmış kullanıcı adı ve şifre |
| Yetkiler | Erişilecek tablolar veya servisler için okuma/yazma yetkisi |
| Ağ erişimi | SkyStudio'nun SAP sunucusuna erişebilmesi için gerekli güvenlik duvarı izinleri |
Not: Kişisel SAP hesabınızı entegrasyonda kullanmayın. IT ekibinden yalnızca gerekli yetkilere sahip ayrı bir servis kullanıcısı talep edin.
SkyStudio'ya Bağlantı Ekleme
-
İş akışı canvas'ının alt araç çubuğundaki zincir ikonuna tıklayın.
-
+ Yeni bağlantı butonuna tıklayın.
-
Sağlayıcı listesinden SAP HANA, SAP SOAP veya SAP REST seçin (Veritabanı & ERP kategorisi altındadır).
-
Aşağıdaki alanları doldurun:
| Alan | Zorunlu | Açıklama |
|---|---|---|
| Bağlantı adı | Evet | Tanımlayıcı bir isim (örn. SAP Üretim) |
| Kimler kullanabilir | Evet | Erişim seviyesi |
| Ad | Hayır | Kimlik bilgisi etiketi |
| URL | Evet | SAP sunucu adresi |
| Username | Evet | SAP servis kullanıcı adı |
| Password | Evet | SAP servis kullanıcı şifresi |
- Bağlantı ekleyin butonuna tıklayın.
Not: Üretim ve test ortamları için ayrı bağlantılar tanımlayın. Bağlantı adında ortamı belirtmek ("SAP Test", "SAP Üretim") yanlış ortamda işlem yapmayı önler.
SAP HANA Query
SAP HANA veritabanına doğrudan SQL sorgusu gönderir. Raporlama ve veri çekme işlemleri için kullanılır.
Parametreler
| Parametre | Zorunlu | Açıklama |
|---|---|---|
| Connection | Evet | Kullanılacak SAP HANA bağlantısı |
| SQL Sorgusu | Evet | Çalıştırılacak SQL ifadesi |
| Limit | Hayır | Döndürülecek maksimum satır sayısı |
Kullanım Örneği
SELECT MATNR, MAKTX, MEINS
FROM MARA
WHERE MTART = 'FERT'
LIMIT 100
Not: Üretim veritabanında yalnızca SELECT sorguları çalıştırın. Yazma işlemleri için SAP SOAP veya SAP REST üzerinden resmi servisleri kullanın; doğrudan tablo yazımı veri bütünlüğünü bozabilir.
SAP SOAP
SAP web servislerine SOAP protokolüyle çağrı yapar. BAPI ve RFC fonksiyonlarını çağırmak için kullanılır.
Parametreler
| Parametre | Zorunlu | Açıklama |
|---|---|---|
| Connection | Evet | Kullanılacak SAP SOAP bağlantısı |
| Servis / Fonksiyon | Evet | Çağrılacak servis veya BAPI adı |
| SOAP Envelope | Evet | İstek gövdesi (XML) |
| SOAP Action | Hayır | SOAPAction başlığı |
Not: SOAP zarfının yapısını SAP tarafındaki WSDL dosyasından öğrenebilirsiniz. IT ekibinizden ilgili servisin WSDL adresini isteyin.
SAP REST
SAP'nin OData veya REST servislerine istek gönderir. Modern SAP kurulumlarında (S/4HANA) tercih edilen yöntemdir.
Parametreler
| Parametre | Zorunlu | Açıklama |
|---|---|---|
| Connection | Evet | Kullanılacak SAP REST bağlantısı |
| Endpoint | Evet | Servis yolu (örn. /sap/opu/odata/sap/API_BUSINESS_PARTNER) |
| HTTP Metodu | Evet | GET, POST, PUT, DELETE |
| Query Parametreleri | Hayır | OData filtre ve seçim parametreleri |
| Body | Duruma göre | POST/PUT istekleri için gövde |
OData Parametre Örnekleri
| Parametre | Açıklama |
|---|---|
| $filter=Country eq 'TR' | Ülkeye göre filtreleme |
| $select=BusinessPartner,BusinessPartnerName | Yalnızca belirli alanları getirme |
| $top=50 | İlk 50 kayıt |
| $orderby=CreationDate desc | Tarihe göre sıralama |
CANIAS ERP Düğümü
CANIAS ERP düğümü, CANIAS sisteminize WSDL üzerinden bağlanmanızı sağlar.
Bağlantı Kurulumu ve Yönetimi
Başlamadan Önce
CANIAS bağlantısı için IT ekibinizden şu bilgileri talep edin:
| Bilgi | Açıklama |
|---|---|
| WSDL adresi | CANIAS web servis tanım dosyasının adresi |
| Servis kullanıcısı | Entegrasyon için açılmış kullanıcı bilgileri |
| Şirket / Dönem kodu | İşlem yapılacak şirket ve mali dönem |
| Yetkiler | Kullanılacak modüller için erişim yetkisi |
SkyStudio'ya Bağlantı Ekleme
-
Alt araç çubuğundaki zincir ikonuna tıklayın.
-
+ Yeni bağlantı butonuna tıklayın.
-
Sağlayıcı listesinden CANIAS (WSDL) seçin (Veritabanı & ERP kategorisi altındadır).
-
Aşağıdaki alanları doldurun:
| Alan | Zorunlu | Açıklama |
|---|---|---|
| Bağlantı adı | Evet | Tanımlayıcı bir isim |
| Kimler kullanabilir | Evet | Erişim seviyesi |
| URL | Evet | CANIAS WSDL servis adresi |
| Username | Evet | CANIAS servis kullanıcı adı |
| Password | Evet | CANIAS servis kullanıcı şifresi |
- Bağlantı ekleyin butonuna tıklayın.
Canias Request
CANIAS ERP servisine istek gönderir.
Parametreler
| Parametre | Zorunlu | Açıklama |
|---|---|---|
| Connection | Evet | Kullanılacak CANIAS bağlantısı |
| Servis / Metot | Evet | Çağrılacak CANIAS servis metodu |
| Parametreler | Duruma göre | Metoda gönderilecek parametreler |
| Şirket Kodu | Hayır | İşlem yapılacak şirket |
| Dönem | Hayır | Mali dönem kodu |
Hızlı Başlangıç Örnekleri
Örnek 1: Salesforce Fırsat Raporu
Açık satış fırsatlarını haftalık raporlayan akış:
Webhook (Her Pazartesi) → Salesforce → Anthropic API Çağrısı → Mail Gönder (Outlook)
Salesforce ayarları:
- İşlem Tipi: Sorgula
- SOQL:
SELECT Name, Amount, CloseDate FROM Opportunity WHERE IsClosed = false ORDER BY Amount DESC LIMIT 20
Örnek 2: SAP Stok Uyarısı
Kritik stok seviyesine düşen ürünleri bildiren akış:
Webhook (Her sabah) → SAP HANA Query → If-Else Koşulu → Mesaj Gönder (Slack)
Örnek 3: ERP Verisinden Dashboard
ERP verisini analiz edip görsel rapor üreten akış:
Webhook (Ayın 1'i) → SAP REST → JSON'dan Tabloya → Veri Analizi (Python) → Artifact → Mail Gönder
Örnek 4: Formdan Salesforce Kaydı
Web formundan gelen talebi CRM'e kaydeden akış:
Webhook → Text2data → Transform → Salesforce (Oluştur) → Mesaj Gönder (Slack)
Örnek 5: ERP Sorgu Chatbot'u
Ekibin ERP verisini doğal dille sorgulamasını sağlayan chatbot:
Metin Girişi → LLM (SQL üret) → SAP HANA Query → LLM (yanıtla) → Metin Çıktısı
Sık Karşılaşılan Hatalar
| Hata | Olası Neden | Çözüm |
|---|---|---|
| INVALID_LOGIN (Salesforce) | Şifre veya Security Token hatalı | Token'ı sıfırlayıp e-postadan gelen yeni değeri girin |
| API_DISABLED_FOR_ORG | Kullanıcıda API yetkisi yok | Profilde "API Enabled" yetkisini açtırın |
| MALFORMED_QUERY | SOQL söz dizimi hatalı | Sorguyu Salesforce Developer Console'da test edin |
| Invalid session ID | Oturum süresi dolmuş | Bağlantıyı yeniden kaydedin |
| SAP Connection refused | Ağ erişimi kapalı | IT ekibinden güvenlik duvarı izni talep edin |
| SAP Authorization failed | Servis kullanıcısının yetkisi yetersiz | SAP Basis ekibinden ilgili tablo/servis yetkisi isteyin |
| SAP HANA Table not found | Şema adı belirtilmemiş | Sorguda tam şema adını kullanın (SCHEMA.TABLO) |
| CANIAS WSDL parse error | WSDL adresi hatalı veya erişilemiyor | Adresi tarayıcıda açıp erişilebilir olduğunu doğrulayın |
| Sorgu zaman aşımına uğruyor | Çok fazla kayıt çekiliyor | LIMIT / $top parametreleriyle sonuç sayısını sınırlayın |
Notlar
- Kurumsal sistem bağlantıları genellikle IT departmanınızla birlikte kurulur; gerekli bilgileri ve ağ izinlerini onlardan talep edin.
- Entegrasyonlarda kişisel hesap yerine servis kullanıcısı kullanın; kişisel şifre değişiklikleri entegrasyonu bozar.
- Salesforce Security Token, şifreniz her değiştiğinde sıfırlanır; bağlantıyı güncellemeyi unutmayın.
- Salesforce'ta üretim ve sandbox ortamları farklı Login URL kullanır — yanlış ortama bağlanmamaya dikkat edin.
- SAP HANA'da üretim veritabanına yalnızca SELECT sorguları gönderin; yazma işlemleri için resmi SAP servislerini (SOAP / REST) kullanın.
- Modern SAP kurulumlarında (S/4HANA) SAP REST, eski kurulumlarda SAP SOAP tercih edilir.
- Test ve üretim ortamları için ayrı bağlantılar tanımlayın ve bağlantı adında ortamı belirtin.
- Büyük veri setlerinde mutlaka
LIMIT,$topgibi sınırlama parametrelerini kullanın; ERP sorguları sistem kaynaklarını yoğun kullanır. - Kurumsal sistemlerde yazma işlemi yapan akışları önce test ortamında deneyin.