PDF'e Aktar

Akıştaki doküman ya da form içeriğini bir PDF dosyasına aktaran nesnedir. Akış bu adıma ulaştığında içeriği PDF olarak üretir; üretilen dosyanın kimliği (FileId) akışın geri kalanında kullanılabilir. Adıma başlık, konu ve yazar gibi PDF üst bilgileri ile aktarım seçenekleri verebilirsiniz.

PDF'e Aktar, hataya dayanıklı (error-managed) bir nesnedir: aktarım sırasında bir hata oluşursa akışın durması yerine devam etmesini ResumeOnError ile ayarlayabilirsiniz.

Ne zaman kullanılır?

Akış ilerlerken belgenin ya da formun o anki halini sabit bir PDF olarak saklamak istediğinizde kullanın. Tipik senaryolar: onaylanmış talebin imzalı bir kopyasını arşivlemek, akış sonunda paydaşlara gönderilecek tek bir PDF üretmek, ya da formun anlık görüntüsünü dosya olarak saklamak.

Ayarlar

PDF'e Aktar nesnesi seçildiğinde tasarımcıda şu başlıklar düzenlenir:

Ayar	Açıklama
Title	Üretilecek PDF'in başlığı (belge üst bilgisi).
Subject	PDF'in konu alanı.
Author	PDF'in yazar alanı.
ExportOptions	Aktarım seçenekleri (IFileExportOptions); dışa aktarımın nasıl yapılacağını belirler.
ExternalParameters	Aktarıma dışarıdan geçirilen ek parametreler (anahtar/değer).
ResumeOnError	Aktarım hata verirse akışın durmak yerine devam edip etmeyeceği.
ErrorOptions	Hata durumunda uygulanacak ayrıntılı hata yönetimi (IFlowErrorOptions).

Akıştaki yeri

PDF'e Aktar, akışın ortasında çalışan bir işlem adımıdır: önceki adım tamamlanınca içerik PDF'e aktarılır ve akış bir sonraki adıma geçer. Bir bekleme/onay noktası değildir. Üretilen dosyanın kimliği FileId özelliğinde tutulur; bunu sonraki bir Fonksiyon adımında okuyup, örneğin bir e-posta ekine ya da kayıt alanına bağlayabilirsiniz.

Kod örnekleri

Aktarım, nesnenin Export() metoduyla tetiklenir. Metot Task<String> döner; bu değer üretilen dosyanın kimliğidir. Sunucu (akış) kodu turuncu çerçevelidir.

Doğrulanacak

Aşağıdaki kullanım, sınıfın dump'tan çıkarılan üyelerine dayanır; çalışma zamanı kalıbı henüz örnekle doğrulanmamıştır. IDE'de teyit edin. TODO: doğrulanacak.

// İçeriği PDF'e aktar; dönen değer üretilen dosyanın kimliğidir
string dosyaId = await pdfeAktar.Export();

// Üretilen dosya kimliğini nesnenin kendi özelliğinden de okuyabilirsiniz
string mevcutDosyaId = pdfeAktar.FileId;

İpuçları

• Export() asenkron bir metottur (Task<String>); await ile çağırın ve dönen dosya kimliğini saklayın.
• Aktarım hata verdiğinde akışın durmasını istemiyorsanız ResumeOnError özelliğini ayarlayın; ayrıntılı davranış için ErrorOptions kullanın.
• Title, Subject ve Author yalnızca üretilen PDF'in üst bilgisidir; akış mantığını etkilemez.
• Üretilen dosyayı sonraki adımlarda kullanacaksanız FileId değerini bir Değişken veya alan üzerinden taşıyın.

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

Temel sınıf: BaseErrorManagedApiStep<FlowPdfExportProperties>

Özellikler: Title (string), Subject (string), Author (string), FileId (string), ExportOptions (IFileExportOptions), ExternalParameters (Dictionary<string, object>), Value (object), ValueType (VariableValueType)

Metotlar: Export() → Task<String> (üretilen dosyanın kimliğini döner), ToLiquid() → object

Miras alınan (BaseErrorManagedApiStep): ResumeOnError (bool), ErrorOptions (IFlowErrorOptions), ErrorDescriptionObjectName

Kaynak: synergy-csp references/flow-objects.md (FlowPDFExport, [dump-only: doğrulanmış kullanım kalıbı yok]) + _harvest/flow-knowledge.md.