Akış Başlangıcı

Her akışın giriş noktasıdır. Bir süreç tetiklendiğinde ilk olarak bu nesne çalışır ve akış buradan sonraki adımlara ilerler. Akışın nereden başladığını ve başlangıç anında nasıl davranacağını (hemen mi başlasın, onay ekranı otomatik mi açılsın, geçmişte görünsün mü) bu nesne üzerinden ayarlarsınız.

Ne zaman kullanılır?

Akış Başlangıcı her akışta bulunur; ayrıca eklemeniz gereken bir nesne değildir, tasarımcı yeni akışa onunla başlar. Başlangıç davranışını değiştirmek istediğinizde (örneğin sürecin başlatan kişiye anında düşmesi yerine hemen ilerlemesi) bu nesnenin ayarlarına dokunursunuz. Akışı sonlandıran karşı nesne için Akış Bitişi kullanılır.

Ayarlar

Akış Başlangıcı seçildiğinde tasarımcıda şu başlıklar düzenlenir:

Ayar	Açıklama
StartImmediately	Akışın başlangıç adımında beklemeden hemen ilerleyip ilerlemeyeceği.
AutoOpenApprovalOption	Başlangıçta onay/işlem ekranının kullanıcıya otomatik açılıp açılmayacağı (burada true/false değeridir).
ShowInFlowHistory	Başlangıç adımının akış geçmişinde görünüp görünmeyeceği.
HideApporoverInHistory	İlgili kişiyi akış geçmişinde gizler. (Özelliğin dökümandaki yazımı bu şekildedir.)
Documents	Akış başlangıcına bağlı doküman listesi.
GeolocationOptions	Başlangıçta konum (geolocation) seçenekleri.
WebNotificationOptions	Başlangıçta gönderilecek web bildirim seçenekleri.

uyarı

Bu nesnenin ayar ve üyeleri kaynak dökümlerinde doğrulanmış olsa da çalışma zamanı kullanım kalıbı henüz örnekle teyit edilmedi. TODO: doğrulanacak. Özellikle StartImmediately ve AutoOpenApprovalOption davranışları IDE'de gerçek bir akış üzerinde test edilmeli.

Akıştaki yeri

Akış Başlangıcı her zaman akışın en başındadır ve tek bir çıkışı vardır: sürecin ilk gerçek adımı. Bir süreç tetiklendiğinde motor önce bu nesneyi çalıştırır, başlangıç ayarlarını uygular ve ardından bir sonraki adıma yönlendirir. Akış kodu içinde başka nesnelerden bu adıma geri dönülmez; o yalnızca giriş noktasıdır. Akışın karşı ucu, süreci tamamlayan Akış Bitişi nesnesidir.

İpuçları

• Akış Başlangıcı'nı silmeye veya çoğaltmaya çalışmayın; her akışta tek bir giriş noktası bulunur.
• AutoOpenApprovalOption bu nesnede true/false değeridir (Pozisyon Grubu gibi bazı nesnelerde aynı isim bir seçenek koduyken). Karıştırmayın.
• SendStartWebNotification bir motor geri çağrısıdır; akış kodundan siz çağırmazsınız, motor başlangıç bildirimini gönderirken kendisi kullanır.
• HideApporoverInHistory adındaki yazım dökümdeki gerçek özellik adıdır; kodda aynen bu şekilde geçer.

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

Taban: FlowObjectDesigner<FlowStartProperties>

Özellikler: StartImmediately (Boolean), AutoOpenApprovalOption (Boolean), HideApporoverInHistory (Boolean), Documents (List<IDocument>), Events (IReadOnlyList<IEvent>, salt okunur), ShowInFlowHistory (Boolean), GeolocationOptions (IFlowGeolocationOptions), WebNotificationOptions (IFlowWebNotificationOptions)

Metot (motor geri çağrısı, siz çağırmazsınız): SendStartWebNotification(UserInfo userInfo, ProcessRequestItem requestItem)

Not: AutoOpenApprovalOption burada Boolean'dır; HideApporoverInHistory dökümdeki literal yazımdır. Sınıf ve üyeler gerçektir fakat çalışma zamanı kullanım kalıbı doğrulanmamıştır ([dump-only]).

Kaynak: synergy-csp references/flow-objects.md (FlowStart, dump-only) + _harvest/flow-knowledge.md (Akış Başlangıcı satırı).