Unvan

Akışta bir unvanı (mesleği) tutan ve çözümleyen değer nesnesidir. İçinde sabit bir unvan, akışı başlatan kişinin unvanı ya da bir pozisyondan gelen unvan barındırabilir. Çözümlenen unvan akış boyunca taşınır ve başka nesnelere (ör. Değişken) kaynak olarak verilebilir.

Ne zaman kullanılır?

Akışta bir kişiyi unvanına göre belirlemeniz ya da bir adımı bir unvana göre yönlendirmeniz gerektiğinde kullanın. Örneğin akışı başlatanın unvanını okuyup sonraki adımları buna göre kurgulamak istediğinizde bu nesne devreye girer. Departman bilgisi için Departman, kişi/pozisyon için ise Pozisyon nesnesini tercih edin.

Ayarlar

Unvan nesnesi seçildiğinde tasarımcıda şu alanlar düzenlenir:

Ayar	Açıklama
Id	Unvanın kimliği.
Code	Unvan kodu.
Description	Unvanın açıklaması / görünen adı.
ValueType	Unvan değerinin tipi (FlowProfessionValueType); değerin nereden çözümleneceğini belirler.

Akıştaki yeri

Unvan, akışta bir değer çözümleyici nesnedir: bir onay/bekleme noktası değildir, akışı durdurmaz. İçindeki unvan, atadığınız kaynağa göre (sabit / başlatan / pozisyon / değişken) çözümlenir ve sonraki adımlarda kullanılmak üzere hazır tutulur. Çözümlenen unvan, bir Değişken nesnesine SetFromProfession ile aktarılarak akışta taşınabilir.

Kod örnekleri

Unvan kaynağı akış kodunda nesnenin adıyla atanır. Sunucu (akış) kodu turuncu çerçevelidir.

Unvan kaynağını atama

// Sabit bir unvanı ata (CSP unvan kimliğiyle)
p_Unvan.SetConstantProfession(1024);

// Kod ve açıklamayla birlikte sabit unvan
p_Unvan.SetConstantProfession(1024, "MUH", "Mühendis");

// Akışı başlatan kişinin unvanı
p_Unvan.SetFromFlowInitiator();

// Bir pozisyondan gelen unvan
p_Unvan.SetFromPosition(p_Mudur);

TODO: doğrulanacak

Bu nesnenin sınıf ve üyeleri reflection dökümünden doğrulanmıştır, ancak çalışma anındaki kullanım kalıbı henüz örnekle teyit edilmemiştir. Yukarıdaki çağrı biçimlerini IDE'de doğrulayın.

İpuçları

• SetConstantProfession bir CSP unvan kimliği bekler; datasource'tan gelen değeri uygun tipe (Convert.ToInt64(...)) çevirin.
• Çözümlenen unvanı akışta taşımak için bir Değişken nesnesinde SetFromProfession(p_Unvan) kullanın.
• Başka bir Unvan nesnesinin değerini bu nesneye kopyalamak için SetFromOther metodunu kullanın.
• Unvan bir bekleme noktası değildir; akışı burada durdurmaz.

Doğrulanmış kod arayüzü (FlowProfession)

Özellikler: Id (Int64), Code (string), Description (string), ValueType (FlowProfessionValueType)

Atama metotları: SetConstantProfession(Int64), SetConstantProfession(Profession), SetConstantProfession(Int64, string, string), SetFromFlowInitiator(), SetFromOther(FlowProfession), SetFromPosition(FlowPosition), SetFromVariable(Variable)

Diğer: ToLiquid()

Temel sınıf: FlowObjectDesigner<FlowProfessionProperties>. Ayrıca Variable.SetFromProfession(FlowProfession) ve FlowAssign.Set*Profession* metotlarına kaynak olarak verilir.

Kaynak: synergy-csp references/flow-objects.md (FlowProfession, dump-only: çalışma anı kullanım kalıbı teyit edilmedi).