URN Kataloğu ve Binding

URN (Uniform Resource Name), vNext platformunda bir kaynağı — flow başlatma, transition tetikleme, function çağırma — taşınabilir ve okunabilir tek bir string ile adreslemenin standart yoludur. View'lar, pseudo-ui aksiyonları (command), schema veri kaynakları (x-lov, x-lookup) ve client deeplink'leri bu kataloğu ortak bir sözleşme olarak kullanır.

Bu sayfa URN'lerin tek doğruluk kaynağıdır. Diğer dökümanlar (View, Pseudo UI, Functions) bir URN formatına ihtiyaç duyduğunda buraya referans verir.

---

Prefiks (Namespace)

URN'in ikinci segmenti namespace'tir ve adresin hangi otorite tarafından çözüleceğini belirler.

Prefix	Otorite	Kullanım
urn:vnext	vNext runtime	Sunucu tarafında çözülen tüm kaynaklar — flow, transition, function
urn:client	Client uygulaması	Client'ın local davranışları (ör. yerel navigasyon, cihaz aksiyonu). Runtime bu adresleri çözmez; client kendi yorumlar

---

URN Formatları

Genel iskelet:

urn:<namespace>:<type>:<command>:<domain>:<flow>[:<instanceId>[:<key>]]

• type — kaynak ailesi: flow (akış işlemleri), fn (function) veya res (sistem bileşeni kaynağı — kendine özgü formatı vardır, aşağıda).
• command — yapılacak işlem. flow için start / transition; fn için get / post / patch / delete.
• Sondaki segmentlerin varlığı (instance, transition/function key) işleme göre değişir; aşağıdaki tablolara bakın.

Flow Başlatma

Format	urn:<namespace>:flow:start:<domain>:<flowName>
Örnek	urn:vnext:flow:start:demo:sample-flow
HTTP karşılığı	POST /api/v1/{domain}/workflows/{flow}/instances/start

Belirli bir flow'un yeni bir instance'ını başlatır. Instance henüz oluşmadığı için instanceId taşımaz.

Transition İsteği (instance'a özel)

Format	urn:<namespace>:flow:transition:<domain>:<flowName>:<instanceId>:<transitionName>
Örnek	urn:vnext:flow:transition:demo:sample-flow:${param}:approved
HTTP karşılığı	PATCH /api/v1/{domain}/workflows/{flow}/instances/{instance}/transitions/{transitionKey}

Belirli bir instance üzerinde adı verilen transition'ı tetikler. instanceId genellikle binding ile (${param}) doldurulur.

Current Transition İsteği (instance'sız)

Format	urn:<namespace>:flow:transition:<domain>:<flowName>:<transitionName>
Örnek	urn:vnext:flow:transition:demo:sample-flow:approved

Aktif (current) instance bağlamında transition'ı tetikler; instanceId taşımaz. Client, üzerinde çalıştığı instance'ı bağlamdan bildiğinde kullanılır.

Function İsteği

Function URN'leri iki eksende değişir:

1. Command — açıkça yazılır (get / post / patch / delete) veya hiç yazılmaz. Varsayılan get olduğu için command'sız form geçerlidir.
2. Kapsam — function bir instance bağlamında mı (flow + instanceId), yoksa domain seviyesinde mi (yalnız domain) çağrılıyor.

Kapsam	Command	Format	Örnek
Instance	Var	urn:<ns>:fn:<command>:<domain>:<flow>:<instanceId>:<functionKey>	urn:vnext:fn:get:demo:sample-flow:${param}:custom-function
Instance	Yok (get)	urn:<ns>:fn:<domain>:<flow>:<instanceId>:<functionKey>	urn:vnext:fn:demo:sample-flow:${param}:custom-function
Domain	Var	urn:<ns>:fn:<command>:<domain>:<functionKey>	urn:vnext:fn:get:demo:custom-function
Domain	Yok (get)	urn:<ns>:fn:<domain>:<functionKey>	urn:vnext:fn:demo:custom-function

HTTP karşılıkları:

# Instance-scoped function
urn:vnext:fn:get:demo:sample-flow:${param}:custom-function
  → GET /api/v1/demo/workflows/sample-flow/instances/{instance}/functions/custom-function

# Domain-scoped function
urn:vnext:fn:demo:custom-function
  → GET /api/v1/demo/functions/custom-function

Function Command Değerleri

Command	HTTP metodu	Açıklama
get	GET	Veri okuma (varsayılan — yazılmazsa bu kabul edilir)
post	POST	Yeni kaynak oluşturma
patch	PATCH	Kısmi güncelleme
delete	DELETE	Silme

Kaynak (Resource) İsteği

Sistem bileşenlerinin (schema, flow, view, task vb.) tanım datasını döndürmek için kullanılır. res, Resource (kaynak) anlamına gelir; res-key ise hangi sistem bileşeni olduğunu belirtir. Bu URN arka planda aslında bir data function çağırır ve ilgili tanımın verisini döner.

Format	urn:<namespace>:res:<res-key>:<domain>:<key>
Örnek	urn:vnext:res:schema:core:input-schema

Diğer formatlardan farklı olarak command, flow ve instanceId segmentleri taşımaz; doğrudan <res-key>:<domain>:<key> ile sistem bileşenini adresler.

res-key Değerleri

Her res-key, ilgili sistem bileşeninin saklandığı sistem flow'una karşılık gelir:

res-key	Sistem flow'u	Bileşen
schema	sys-schemas	Schema
flow	sys-flows	Workflow
extension	sys-extensions	Extension
function	sys-functions	Function
view	sys-views	View
task	sys-tasks	Task

View dataSchema kullanımı

Bu yapı, view'ların dataSchema alanında bağlı oldukları şemayı adreslemek için de kullanılır — ör. urn:vnext:res:schema:customer:registration-form. Pseudo UI bağlamında ayrıntı için bkz. Schema Tanımı.

---

Binding Formatlama

URN, HTTP ve Deeplink yapılarında çalışma zamanında değer enjekte etmek için binding kullanılır. Kabul edilen tek format:

${param}

Renderer / client, ${param} ifadelerini bağlamdaki ilgili değerle (ör. aktif instanceId, seçili kayıt) değiştirir.

Yapı	Binding desteği	Not
URN	✅ ${param}	Genellikle instanceId segmentinde
Http	✅ ${param}	Query veya path içinde
Deeplink	✅ ${param}	Şu an yalnızca full path desteklenir

Örnekler:

// URN — instanceId binding
"urn:vnext:flow:transition:demo:sample-flow:${param}:approved"

// Http — query parametresi binding
{ "href": "https://example.com/detail?id=${param}" }

// Deeplink — full path binding
{ "href": "mock-app//sample-page/${param}" }

Raw JSON + alan girişi

View tiplerinin content alanlarında (Http / Urn / Deeplink) hem yapılandırılmış bir input alanı hem de ham JSON girişi desteklenir. Her iki yolda da ${param} binding'i geçerlidir. Content shape'leri için bkz. View → İçerik Tipleri.

---

İlgili

• View component — Http / Deeplink / URN view içerik shape'leri
• Pseudo UI → Aksiyonlar ve Hook'lar — Button command içinde URN kullanımı
• Functions — function bileşenleri ve çağrı endpoint'leri
• Authorization — transition/function yetkilendirmesi
• REST API — URN'lerin çözüldüğü HTTP endpoint'leri