FopProcess

 Top  Previous  Next

Apache Formatting Objects işlemcisini kullanan FopProcess elemanı fo dokümanlarından PDF dokümanları elde etmek için kullanılır.

FopProcess elemanı İşlem Yönetim Çatısı altında kullanılmak için tasarlanmıştır. Bu elemanı bir işlem bloğu veya işlem formu içinde yerleştirin ve özelliklerini belirleyin.

FopProcess

FopProcess_pe

Parametreler

Şablon Tipi (MScript kabul eder)

Bu özellik ile çıktı dokümanını üretme sırasında kullanılacak olan şablon dosyanın tipi belirlenir. Şablon tipleri şunlardır:

1.XSL-Fo. Bir XSL-Fo editörü tarafından hazırlanmış olan bir XSL-Formatting Objects dokümanı. Şablon tipi XSL-Fo olduğunda, FopProcess işlemi Fo türünde bir şablon elde etmek için bir XSLT işlemini devreye sokar. Bu XSLT işleminin girdileri "Şablon Dosyası" özelliğinde belirtilmiş olan XSL-Fo dokümanı ve "XML İçeriği" özelliğinde belirlenmiş olan sembollerin içeriklerinden hazırlanmış olan XML verisidir.
 
Bu seçeneği kullanarak Fo dokümanlarını XML verisine göre dinamik olarak üretmek mümkündür.
 
2.Fo. Eğer üretilecek olan çıktı dokümanının içeriği dinamik değilse Şablon olarak bir Fo dokümanı da verilebilir. Bu durumda XSLT işlemi yapılmaksızın sadece Apache FO işlemcisi çalıştırılacak ve doğrudan çıktı dokümanının üretimine geçilecektir.

 

Şablon Dosyası (MScript kabul eder)

"Şablon Tipi" özelliğinin değerine bağlı olarak bu özelliğe ya bir XSL-Fo dokümanının adı veya bir Fo dokümanının adı verilmelidir. Gerek XSL-Fo, gerekse Fo türündeki şablonlar üçüncü parti Fo editörleri kullanarak geliştirilebilir ve projeye eklenebilirler.

Çıktı Türü

"Çıktı Türü" özelliğinin değeri sadece "1. PDF" olabilir; Bu özellik, başka seçim imkanı olmadığı halde, elde edilecek çıktı türünün bilinebilmesi amacıyla sağlanmıştır.

 

Çıktı Dosya Adı (MScript kabul eder)

Oluşturulan rapor dokümanının kaydedileceği dosyayı belirler. Değer kalıcı bir dosya adı olabileceği gibi geçici bir dosya da olabilir. Geçici dosyalar, süresi dolmuş dosyaların otomatik olarak silindiği özel MoreMotion dizininde ("WEB-INF/MM-INF/~tempfiles/") oluşturulur ve adları havuz değişkenlerine veya işlem kaydı alanlarına atanır.
 

Örnekler:

Tanımlama

Açıklaması

WEB-INF/raporlar/urun.pdf

Uygulama kök dizinine göreceli tanımlanmış olan dosya

c:\raporlar\urun.pdf

Adı mutlak olarak tanımlanmış olan dosya

v:urunler

Adı "urunler" adlı havuz değişkeninde saklı olan geçici dosya

f:siparis

Adı "siparis" adlı işlem kaydı alanında saklı olan geçici dosya

 

XML İçerik (Virgülle ayrılmış semboller) (MScript kabul eder)

Eğer "Şablon Tipi" XSL-Fo ise, XML verisini sağlayacak olan kaynakları belirten MScript sembolleri bu özellik ile belirtilir. Kullanılabilecek olan MScript Sembolleri :

1.İşlem Kayıt Alanları: Örnek: f:Name
2.Normal Girdi Alanları: Örnek: i:Quantity
3.Havuz Değişkenleri: Örnek: v:Status

 

Birden fazla alan belirleyebilmek için aralarında virgül kullanın.

Örnek:

f:Name, i:Stock, v:Status, LastWeekOrders

 

XML Alanları:

İşlem Kayıt Alanları veya Havuz Değişkenleri içinde XML verisi de saklanabilir.  "mor.ADOM" bileşeni tarafından sağlanan AML dilinin ToXml() fonksiyonu ile bellekteki ADOM nesneleri XML verisine dönüştürülebilir ve  İşlem Kayıt Alanlarına veya Havuz Değişkenlerine atanabilir. AML dili, "mor > ADOM > AMLProcess" elemanı
aracılığı ile çalıştırılabilir.

Belirlenen alanlardan oluşturulan XML verisinin yapısı:

"Dahil Edilecek Alanlar" özelliğinde belirlenmiş olan alanlardan oluşturulan XML verisinin yapısını bilmek, XSL-Fo dokümanları geliştirirken, bu dokümanlar içinde kullanılan elemanların özelliklerini, bu XML verisinin düğümlerine doğru şekilde bağlayabilmek için önemlidir.

"f:Name, i:Stock, v:Status, LastWeekOrders" örneğinde belirtilen alanların, FopProcess tarafından işleneceğini ve bu alanların o anki değerlerinin aşağıdaki gibi olduğunu var sayalım.

 

f:Name       i:Stock     v:Status    LastWeekOrders

-----------  ---------   ----------  ---------------------------------------

Printer      12          Discounted  <item>

                                       <custid>5</custid>

                                       <qty>5</qty>

                                     </item>

                                     <item>

                                       <custid>33</custid>

                                       <qty>20</qty>

                                     </item>

 

FopProcess işlemi, bu alanlardan aşağıdaki XML verisini oluşturacak ve bu veriyi Fo doküman çıktısını üretecek olan XSLT işleminde girdi olarak kullanılmasını sağlayacaktır.

 <root>

    <Name>Printer</Name>

    <Stock>12</Stock>

    <Status>Discounted<Status>

    <LastWeekOrders>

      <item>

        <custid>5</custid>

        <qty>5</qty>

      </item>

      <item>

        <custid>33</custid>

        <qty>20</qty>

      </item>

    </LastWeekOrders>

  </root>