UISAP Docs
Akışlar (Flows)

SAP Entegrasyonu

Akış içinden SAP verisiyle yanıt verin — senkron katalogdan stok bilgisi veya canlı OData sorgusu.

İki düğüm, akışlarınızı doğrudan SAP verisine bağlar. Her ikisi de AI Agent → Ürünler ekranında tanımladığınız SAP kaynaklarını kullanır ve sunucuda çalışır — SAP kimlik bilgileri asla ziyaretçinin tarayıcısına inmez. Bağ iki yönlüdür: Ürünler ekranındaki entegrasyon kartı, o kaynağı kullanan akışları rozet olarak listeler ve tek tıkla akışa götürür.

SAP ürün/stok

Ziyaretçinin son mesajını senkronlanmış ürün kataloğunda arar:

  1. Önce ürün koduna tam eşleşme denenir (büyük/küçük harf duyarsız),
  2. bulunamazsa ürün adı veya kodu içeren kayıtlar aranır.

Bulunan ürün, yanıt şablonunuzdaki yer tutucularla sunulur:

Yanıt şablonu örneği
«{name}» ({code}) — güncel stok: {stock} {unit}
Yer tutucuDeğer
{name}Ürün adı
{code}Ürün kodu (MATNR)
{stock}Stok miktarı
{unit}Birim
{input}Ziyaretçinin aranan metni

Çıkışlar: Bulundu / Diğer. Katalog senkron olduğu için yanıt anlıktır — SAP'ye canlı istek atılmaz; VPN arkasındaki kaynaklarda bile beklemesizdir.

Önerilen desen

Önüne bir Soru sor düğümü koyun: "Hangi ürünün stok bilgisini istersiniz?" — ziyaretçinin yanıtı otomatik olarak arama girdisi olur.

SAP canlı sorgu

Sipariş durumu, teslimat tarihi gibi anlık veriler için SAP'ye gerçek zamanlı OData/REST isteği atar:

Kaynak seçin — Ürünler ekranındaki SAP bağlantılarından biri. Kimlik bilgileri, dil başlıkları ve (varsa) VPN köprüsü o kaynaktan aynen kullanılır.
Servis yolu yazın — {input}, ziyaretçinin son mesajıyla (URL kodlanarak) değiştirilir.
Yanıt şablonu kurun — dönen ilk kaydın alanlarını {AlanAdi} biçiminde kullanın.
Servis yolu örneği
ZSD_ORDER_SRV/OrderSet('{input}')?$format=json
Yanıt şablonu örneği
{OrderId} numaralı siparişiniz {Status} durumunda.
Tahmini teslim: {DeliveryDate}

Şablonu boş bırakırsanız dönen kaydın alanları otomatik olarak ad-değer listesi hâlinde sunulur. İstek 45 saniyede yanıt vermezse Diğer dalı çalışır. Çıkışlar: Başarılı / Diğer.

Tarayıcı akışlarında nasıl çalışır?

SAP düğümleri sunucu gerektirir; ancak tarayıcıda başlayan bir akışta (örn. Ziyaretçi şunu derse) gönül rahatlığıyla kullanabilirsiniz. Akış SAP düğümüne ulaştığında konuşma sunucuya devredilir, sorgu orada koşar ve yanıt sohbete normal bir mesaj olarak düşer. Sandbox testinde SAP düğümleri atlanır ve "yalnızca canlıda çalışır" notu gösterilir.

Tipik zincir

Soru sor ("Sipariş numaranız?") → SAP canlı sorgu (OrderSet('{input}')) → Başarılı dalında sonuç mesajı, Diğer dalında insana devir. Bu üçlü, sipariş takibi senaryosunun tamamıdır.