SOAP servisleriDokümantasyon menüsü

Entegrasyonlar

SOAP servisleri

ERP veya SAP servisi gibi bir SOAP web servisini bağlayın; asistanlar operasyonlarını zarf şablonları üzerinden çağırsın.

SOAP Service entegrasyonu, HTTP üzerinden XML konuşan bir web servisini bağlar. Birçok ERP ve arka ofis sistemi bu şekilde çalışır. Her operasyonu bir zarf şablonuyla bir kez tanımlarsınız, asistanlar da onu doğru değerlerle çağırır.

Entegrasyonu oluşturun

  1. 1Stüdyo → Entegrasyonlar sayfasına gidin, Entegrasyon Ekle düğmesine tıklayın ve SOAP Service seçeneğini seçin.
  2. 2Bir Entegrasyon Adı (örneğin "Sipariş Servisi") ve bir Açıklama girin.
  3. 3İsteklerin gönderildiği Endpoint URL değerini girin. İsterseniz WSDL URL de ekleyin; referans olarak ve bağlantı testi için kullanılır.
  4. 4SOAP Sürümü olarak 1.1 veya 1.2'yi seçin.
  5. 5Kimlik Doğrulama Türü seçin ve alanlarını doldurun.
  6. 6İsterseniz Varsayılan Header'lar, Gövde İçi Kimlik Bilgileri ve Servis Dokümantasyonu ekleyin.
  7. 7Entegrasyon Oluştur düğmesine tıklayın.
Kimlik Doğrulama TürüNasıl gönderilir
Temel Kimlik DoğrulamaHTTP Basic header'ı
WS-Security UsernameTokenSOAP zarfında bir güvenlik header'ı. Parola Türü seçin: düz metin veya digest
Bearer TokenHTTP Authorization header'ı
API Anahtarı Header'ıÖzel bir HTTP header'ı
Kimlik Doğrulama YokHiçbir şey eklenmez

Bazı eski servisler kullanıcı adı ve parolayı SOAP gövdesinin içinde bekler. Bunları Gövde İçi Kimlik Bilgileri alanına girin. Harmona bunları sunucuda her çağrıya ekler. Asistanlar bunları hiç görmez ve değiştiremez.

İpucu

Markdown ile Servis Dokümantasyonu ekleyin: her operasyonun ne yaptığı, ne zaman kullanılacağı ve beklediği ID biçimleri. Asistanlar servisi çağırmadan önce bunu okur ve doğru operasyonu seçer.
Endpoint'e genel internet üzerinden http veya https ile erişilebilmelidir. localhost veya özel ağlardaki adresler engellenir.

Operasyon ekleyin

  1. 1Entegrasyonu açın ve Operasyon Ekle düğmesine tıklayın.
  2. 2Bir Ad (örneğin `get_order_status`) ve ne yaptığını anlatan bir Açıklama girin.
  3. 3Servis gerektiriyorsa SOAPAction değerini girin.
  4. 4Eksiksiz bir örnek isteği Zarf Şablonu olarak yapıştırın ve her somut değeri `{{order_id}}` gibi bir yer tutucuyla değiştirin.
  5. 5Şablon Parametreleri altında her yer tutucuyu açıklayın ve Zorunlu olup olmadığını işaretleyin.
  6. 6Operasyon Ekle düğmesine tıklayın.
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ord="http://example.com/orders">
  <soapenv:Body>
    <ord:GetOrderStatus>
      <ord:OrderId>{{order_id}}</ord:OrderId>
    </ord:GetOrderStatus>
  </soapenv:Body>
</soapenv:Envelope>

Yer tutucular harf, rakam ve alt çizgi içerir. Değerler çağrı yapılırken otomatik olarak escape edilir. SoapUI'dan ya da servis dokümantasyonundan alınan bir örnek istek iyi bir başlangıç noktasıdır.

Bir operasyonu denemek için yanındaki Operasyonu test et düğmesine tıklayın, değerleri doldurun ve Testi Çalıştır düğmesine tıklayın. Bu, canlı servisi çağırır. Sonuç, yanıtı Ayrıştırılmış veya Ham XML olarak ve varsa SOAP Fault'u gösterir. Servisin kendisini denemek için SOAP'u Düzenle ve ardından Bağlantıyı Test Et düğmesine tıklayın.

SAP ve diğer ERP sistemleri

SAP sisteminiz bir SOAP web servisi sunuyorsa onu diğer SOAP servisleri gibi bağlayın: endpoint'i, WSDL'i ve asistanların yapmasını istediğiniz her çağrı için bir operasyon. SAP HANA verisinden doğrudan yanıt almak için bunun yerine bir veritabanı bağlantısı kullanın.

Güncellendi 2026-09-24

ÖncekiÖzel REST APISonraki Harmona Data