Numaratör
Bir şablona göre benzersiz bir numara üretip sonucu bir akış değişkenine yazan adımdır. Genellikle talep, belge ya da kayıt için sıralı/biçimli bir numara (ör. TLP-2026-000123) oluşturmak ve bu numarayı sonraki adımlarda ya da formda kullanmak için tercih edilir.
Numaratör adımı, IDE araç kutusunda FlowUniqueIdCreator nesnesine karşılık gelir (araç kutusu ikonu doğrulandı). Aşağıdaki ayarlar ve API bu sınıftan alınmıştır; yalnızca çalışma zamanı kullanım kalıbı örnek akışla teyit edilmemiştir.
Ne zaman kullanılır?
Akış sırasında bir kayda benzersiz ve biçimli bir numara atamanız gerektiğinde kullanın: talep numarası, evrak numarası, dosya numarası gibi. Numara biçimi (yıl, sıra, ön ek vb.) önceden tanımlı bir şablondan gelir; bu adım o şablonu çalıştırır ve üretilen değeri belirttiğiniz değişkene aktarır.
Ayarlar
Numaratör adımının dayandığı FlowUniqueIdCreator nesnesinde şu özellikler bulunur:
| Ayar | Açıklama |
|---|---|
TemplateId | Kullanılacak numara şablonunun kimliği. |
TemplateName | Numara şablonunun adı. |
TemplateValue | Şablonun ürettiği/üreteceği değer. |
VariableName | Üretilen numaranın yazılacağı akış değişkeninin adı. |
VariableKey | Hedef değişkenin anahtarı. |
Akıştaki yeri
Numaratör, akışın ortasında çalışan bir işlem adımıdır: önceki adım tamamlandığında şablona göre numarayı üretir, sonucu hedef değişkene yazar ve akış bir sonraki adıma devam eder. Üretilen numarayı formda göstermek ya da sonraki Fonksiyon adımlarında kullanmak için, bu adımdan sonra ilgili değişkeni/alanı okuyacak şekilde kurgulayın.
İpuçları
- Numara biçimini (ön ek, yıl, sıra uzunluğu vb.) bu adımda değil, ona bağladığınız şablonda tanımlarsınız; burada yalnızca hangi şablonun çalışacağını ve sonucun nereye yazılacağını belirtirsiniz.
- Üretilen numarayı
VariableNameile belirttiğiniz değişkenden okuyun; numarayı kullanan adımları bu adımdan sonra konumlandırın. - Bu nesne,
FlowDocument.SetUniqueIddavranışını besler; belge kimliği atama senaryolarında bu adımla aynı şablon mantığı kullanılır.
Doğrulanmış kod arayüzü (FlowUniqueIdCreator)
Sınıf: FlowUniqueIdCreator (FlowObjectDesigner<FlowUniqueIdCreatorProperties>). Bir şablondan benzersiz numara üretip değişkene yazar; FlowDocument.SetUniqueId davranışını besler.
Özellikler: TemplateId (Int64), TemplateName (string), TemplateValue (string), VariableKey (string), VariableName (string)
Metotlar: CreateUniqueId() → Task
Kaynak: Bimser.CSP.Workflow.Api.api.txt (FlowUniqueIdCreator) + IDE araç kutusu ikonu (unique-id-creator, eşleşme doğrulandı). Çalışma zamanı kullanım kalıbı örnekle teyit edilmedi.