ihub SOAP Nodes Package

Bu paket, ihub workflow automation platformu için özel olarak geliştirilmiş SOAP web servisleri ile etkileşim kurmanızı sağlayan node'ları içerir. DSmart Online Payment System ve diğer SOAP servisleri için optimize edilmiştir.

🚀 Özellikler

DSmart SOAP Node

• 17 Farklı Operation Desteği: DSmart Online Payment System'in tüm operation'ları
• Otomatik Envelope Oluşturma: Seçilen operation'a göre otomatik SOAP envelope
• Template Değişken Desteği: {{variableName}} syntax ile dinamik değer atama
• Credential Yönetimi: Güvenli kimlik doğrulama
• XML Response Parsing: Otomatik XML yanıt ayrıştırma

Universal SOAP Node

• Evrensel SOAP Desteği: Herhangi bir SOAP servisi için
• Manuel Envelope Tanımlama: Tam kontrol ile SOAP envelope oluşturma
• WSDL URL Desteği: WSDL dosyalarından otomatik servis URL çıkarma
• HTTP Header Özelleştirme: Özel header'lar ekleme

SOAP Response Parser

• XML Ayrıştırma: SOAP yanıtlarını JSON formatına dönüştürme
• XPath Desteği: Gelişmiş XML sorgulama
• Hata Yönetimi: Detaylı hata raporlama

📦 Kurulum

npm install ihub-nodes-custom-soap

🔧 Kullanım

DSmart SOAP Node

DSmart Online Payment System ile etkileşim kurmak için:

1. Operation Seçimi: 17 farklı operation'dan birini seçin
2. Credential Ayarları: SOAP API credentials'ınızı ekleyin
3. Template Değişkenler: Gerekli değişkenleri tanımlayın
4. Envelope Düzenleme: Otomatik oluşturulan envelope'u özelleştirin

Desteklenen Operation'lar:

• Bank Agreement İşlemleri: BankAgreementList, GetBankAgreement, ConfirmGetBankAgreementDate
• Direct Debit İşlemleri: GetDirectDebitList, SetDirectDebit, SetDirectDebitCancel
• Payment İşlemleri: SetPayment, SetPaymentCancel, GetPaymentCancel
• List İşlemleri: PaymentAllListDetail, CancelAllListDetail
• Info İşlemleri: GetInvoice, GetDirectDebitInfo
• Utility İşlemleri: ReturnLink

Template Değişkenleri:

<tem:GetInvoice>
   <tem:bankCode>{{bankCode}}</tem:bankCode>
   <tem:subscriberNo>{{subscriberNo}}</tem:subscriberNo>
   <tem:userName>{{username}}</tem:userName>
   <tem:password>{{password}}</tem:password>
</tem:GetInvoice>

Universal SOAP Node

Herhangi bir SOAP servisi için:

1. WSDL URL: Servisinizin WSDL URL'sini girin
2. Operation Adı: Çağırmak istediğiniz operation'ı belirtin
3. SOAP Envelope: Manuel olarak envelope'u tanımlayın
4. Template Variables: Gerekli değişkenleri ekleyin

SOAP Response Parser

XML yanıtlarını ayrıştırmak için:

1. XML Input: SOAP yanıtını girin
2. Parsing Options: Ayrıştırma seçeneklerini belirleyin
3. Output Format: JSON formatında sonuç alın

🔐 Credential Yönetimi

SOAP API Credentials

{
  "username": "your_username",
  "password": "your_password"
}

📝 Örnekler

GetInvoice Operation Örneği

// DSmart SOAP Node Configuration
{
  "operation": "GetInvoice",
  "serviceUrl": "http://dstahsilat.dsmart.com.tr/DsmartOnlinePaymentSystem.asmx",
  "authSource": "credentials",
  "soapEnvelope": "<?xml version=\"1.0\" encoding=\"utf-8\"?><soap:Envelope...>"
}

Universal SOAP Node Örneği

// Universal SOAP Node Configuration
{
  "wsdlUrl": "http://example.com/service.asmx?WSDL",
  "soapType": "GetData",
  "soapEnvelope": "<soap:Envelope...>",
  "authSource": "credentials"
}

🛠️ Geliştirme

Gereksinimler

• Node.js >= 20.15
• TypeScript
• ihub-workflow

Build İşlemi

npm run build

Development

npm run dev

📄 Lisans

Bu proje MIT lisansı altında lisanslanmıştır. Detaylar için LICENSE dosyasına bakın.

👨‍💻 Geliştirici

Uğur Yıldız

• Email: ugur@example.com
• GitHub: @uguryildiz
• Homepage: https://github.com/uguryildiz/ihub-nodes-custom-soap

🤝 Katkıda Bulunma

1. Bu repository'yi fork edin
2. Feature branch oluşturun (git checkout -b feature/amazing-feature)
3. Değişikliklerinizi commit edin (git commit -m 'Add some amazing feature')
4. Branch'inizi push edin (git push origin feature/amazing-feature)
5. Pull Request oluşturun

📞 Destek

Herhangi bir sorun yaşarsanız:

• GitHub Issues sayfasını ziyaret edin
• Email ile iletişime geçin: ugur@example.com

🔄 Changelog

v0.1.66

• 17 yeni DSmart operation eklendi
• Otomatik envelope oluşturma geliştirildi
• Template değişken sistemi iyileştirildi
• Universal SOAP Node output formatı güncellendi

v0.1.1

• İlk sürüm
• Temel SOAP node'ları eklendi
• Credential sistemi kuruldu

⭐ Bu projeyi beğendiyseniz yıldız vermeyi unutmayın!