Extension

Extension bileşeni, instance data zenginleştirme için kullanılır. Data Function ve GetInstanceData endpoint'lerinde extension'lar çağrılır ve sonuçları response'da extensions objesinde yer alır.

Schema: vnext-schema/extension-definition.schema.json

Tanım JSON Örneği

Schema: extension-definition.schema.json

{
  "key": "extension-customer-detail",
  "version": "1.0.0",
  "domain": "core",
  "flow": "sys-extensions",
  "flowVersion": "1.0.0",
  "tags": ["core", "customer", "enrichment"],
  "_comment": "Müşteri detay bilgisini instance verisine ekleyen extension",
  "attributes": {
    "type": 3,
    "scope": 1,
    "task": {
      "order": 1,
      "task": {
        "key": "get-customer-detail",
        "domain": "core",
        "flow": "sys-tasks",
        "version": "1.0.0"
      },
      "mapping": {
        "type": "L",
        "location": "./src/CustomerDetailMapping.csx",
        "code": "<BASE64_ENCODED_CODE>",
        "encoding": "B64"
      }
    },
    "labels": [
      { "label": "Customer Detail", "language": "en-US" },
      { "label": "Müşteri Detay", "language": "tr-TR" }
    ]
  }
}

---

Kullanım Modeli

Bir instance veri sorgulandığında veya bir Data Function çağrıldığında, workflow tanımındaki extensions listesi çalıştırılır ve sonuçlar response'a eklenir:

{
  "id": "...",
  "key": "...",
  "metadata": { },
  "attributes": { },
  "extensions": {
    "customerDetail": { },
    "creditHistory": { }
  }
}

Her extension key'i, extensions objesinde camelCase property olarak yer alır (örn. customer-detail → customerDetail) ve içeriği extension'ın döndürdüğü veridir.

---

Properties

Top-Level Alanlar

Alan	Tip	Zorunlu	Pattern / Kısıt	Açıklama
$schema	string	Hayır	URI formatı	JSON Schema referansı
key	string	Evet	^[a-z0-9-]+$	Extension'ın benzersiz tanımlayıcısı (response'da camelCase property adı olur)
version	string	Evet	^\d+\.\d+\.\d+(-[a-zA-Z]+\.\d+)?$	Semantic versioning (Major.Minor.Patch)
domain	string	Evet	^[a-z0-9-]+$	Extension'ın ait olduğu domain
flow	string	Evet	Sabit: sys-extensions	Flow tanımlayıcısı
flowVersion	string	Evet	^\d+\.\d+\.\d+(-[a-zA-Z]+\.\d+)?$	Flow versiyonu
tags	string[]	Evet	minItems: 1	Kategorilendirme ve arama etiketleri
_comment	string	Hayır	—	Açıklama / yorum
attributes	object	Evet	—	Extension davranış tanımı (aşağıda)

attributes Alanları

Alan	Tip	Zorunlu	Açıklama
type	integer	Evet	Extension tipi — aşağıdaki enum tablosuna bakın
scope	integer	Evet	Extension kapsamı — aşağıdaki enum tablosuna bakın
task	object	Evet	Extension'ın çalıştıracağı task tanımı (aşağıda)
labels	array	Hayır	Çoklu dil etiketleri. Her öğe: label (string) + language (pattern: ^[a-z]{2}-[A-Z]{2}$)

attributes.type Enum Değerleri

Değer	Ad	Açıklama
1	Global	Tüm akışlarda kayıt örnekleri dönerken çalışır
2	GlobalAndRequested	Tüm akışlarda ve kayıt örnekleri talep edildiğinde çalışır
3	DefinedFlows	Yalnızca tanımlandığı akışlarda çalışır
4	DefinedFlowAndRequested	Tanımlandığı akışlarda ve talep edildiğinde çalışır

attributes.scope Enum Değerleri

Değer	Ad	Açıklama
1	GetInstance	{domain}/workflows/{workflow}/instances/{instance} endpoint'inde çalışır
2	GetAllInstances	{domain}/workflows/{workflow}/instances endpoint'inde çalışır
3	Everywhere	Tüm get endpoint'lerinde çalışır

task Yapısı

Alan	Tip	Zorunlu	Açıklama
order	integer	Evet	Task çalışma sırası (minimum: 1)
task	object	Evet	Task referansı — explicit (key, domain, flow, version) veya ref (ref)
mapping	object	Evet	Mapping kodu tanımı (aşağıda)

Mapping

Alan	Tip	Zorunlu	Varsayılan	Açıklama
type	string	Hayır	L	G = Global, L = Local. Global ise code gerekmez
location	string	Hayır	—	Kod dosyası yolu (pattern: ^\.\/.*\.csx$)
code	string	Koşullu	—	Mapping kodu. type = L ise zorunlu
encoding	string	Hayır	B64	Kodlama formatı: B64 (Base64) veya NAT (Native)

---

Tipik Kullanım Senaryoları

• Customer enrichment: müşteri ID'sinden tam müşteri bilgisi
• Credit history: instance ile ilişkili kredi geçmişi
• External system data: dış sistemlerden veri çekme
• Computed fields: instance verisi üzerinden hesaplanan alanlar

İlgili

• Functions — function bileşenleri
• Built-in Functions — Data Function entegrasyonu
• Schema kaynağı: vnext-schema (GitHub)