Ana içeriğe geç
Doğrulama: API doğrulandı — kullanım kalıbı örnekle teyit edilmedi

Doküman Silme

Akış çalışırken bir veya daha çok dokümanı silen nesnedir. Bu adıma gelindiğinde, nesneye bağladığınız dokümanlar süreçten kaldırılır. Genellikle akış sırasında geçici olarak oluşturulan ya da artık gereksiz hale gelen kayıtların temizlenmesi için kullanılır.

Ne zaman kullanılır?

Akışın bir noktasında bir dokümanın kalıcı olarak kaldırılması gerektiğinde kullanın: örneğin akış içinde Doküman Oluştur ile üretilen bir ara kaydın iş bittikten sonra temizlenmesi ya da iptal edilen bir talebe ait dokümanın silinmesi gibi. Dokümanı silmek yerine yalnızca durumunu değiştirecekseniz silme yerine durum güncelleyen bir adımı tercih edin.

Ayarlar

Doküman Silme nesnesi seçildiğinde tasarımcıda şu başlık düzenlenir:

AyarAçıklama
DocumentsSilinecek dokümanların listesi (FlowDeleteDocumentItem öğelerinden oluşur). Hangi doküman nesnelerinin kaldırılacağı bu liste üzerinden belirlenir.

Akıştaki yeri

Doküman Silme, akışın gövdesinde yer alan bir işlem adımıdır: önceki adım tamamlanınca nesneye bağlı dokümanlar silinir ve akış kesintisiz olarak bir sonraki adıma devam eder. Bir bekleme ya da onay noktası değildir; üzerinde durulmaz. Silinecek dokümanları nesnenin Documents listesinde tanımlar, ya da kendi kod bloğunda DeleteDocument / DeleteDocuments çağrılarıyla yönetirsiniz.

Kod örnekleri

Silme işlemi nesnenin adıyla, sunucu (akış) kodunda yürütülür. Sunucu kodu turuncu çerçevelidir.

// Nesnenin Documents listesinde tanımlı tüm dokümanları sil
await p_DokumanSil.DeleteDocuments();

// Tek bir FlowDocument nesnesini hedefleyerek sil
await p_DokumanSil.DeleteDocument(p_Dokuman);
TODO: doğrulanacak

DeleteDocument / DeleteDocuments metotlarının ve Documents listesinin tip imzaları doğrulanmıştır; yukarıdaki kullanım kalıbı (örn. nesne adının p_ ön ekiyle çağrılması, await ile bekletilmesi) henüz örnekle teyit edilmemiştir. Akışı yayınlamadan önce IDE'de doğrulayın.

İpuçları

  • DeleteDocument bir FlowDocument nesnesi bekler; silinecek dokümanı bir Doküman nesnesi üzerinden geçirin.
  • DeleteDocuments(), ayarlardaki Documents listesinde tanımlı dokümanların tamamını topluca siler; tek tek silmek için DeleteDocument(...) kullanın.
  • Silme işlemi geri alınamaz; akışta yanlışlıkla çalışmaması için adımı bir koşula bağlamayı değerlendirin.
Doğrulanmış kod arayüzü (FlowDeleteDocument)

Tasarımcı tipi: FlowObjectDesigner<FlowDeleteDocumentProperties>

Özellikler: Documents (List<FlowDeleteDocumentItem>)

Metotlar: DeleteDocument(FlowDocument) → Task<Boolean>, DeleteDocuments() → Task

Kaynak: synergy-csp references/flow-objects.md (FlowDeleteDocument, dump-only: doğrulanmış kullanım kalıbı yok).