Yeni bir rapor oluşturmak için:

1. Kuika platformuna giriş yapın ve Apps ekranından çalışacağınız projeyi açın.

2. Report Designer modülünü seçin.
3. Açılan ekranda raporunuza bir isim verin.
4. CREATE butonuna tıklayarak yeni raporunuzu oluşturun.

Canvas, rapor tasarımının yapıldığı ana alandır. Free position özelliği sayesinde öğeleri sayfa üzerinde dilediğiniz yere sürükleyip konumlandırabilirsiniz.

Canvas üzerinde:

• Raporu oluşturan tüm elementler (Label, Box, Table, Image, Divider vb.) yer alır.
• Elementler sürükle-bırak yöntemi ile sayfa üzerinde konumlandırılabilir.
• Tasarlanan raporun sayfa düzeni ve yerleşimi görsel olarak yönetilebilir.

Canvas Alan Yapısı (Band Yapısı)

Canvas üzerinde rapor alanları bant (band) yapısı ile organize edilir. Bu bantlar Canvas’ın sol tarafında görüntülenir ve tıklanarak seçilebilir.

Kullanılabilen bantlar:

• Header
• Footer
• Page Header
• Page Footer
• Static Table
• Report Table

Bu yapı sayesinde:

• Rapor alanları görsel olarak ayrıştırılır.
• Kullanıcı hangi alan üzerinde çalıştığını kolayca anlayabilir.
• İlgili alan hızlı şekilde seçilerek düzenleme yapılabilir.

Izometrik (Noktalı Kağıt) Tasarım Modu

Canvas varsayılan olarak izometrik (noktalı kağıt) görünümde gelir. Bu mod sayesinde:

• Öğeler noktalara hizalanarak sürüklenebilir.
• Serbest mod ile noktalı görünüm arasında geçiş yapılabilir.
• Nokta aralıkları ayarlanabilir.
• Kullanıcının tercih ettiği görünüm tarayıcıda saklanır.

Cetvel ve Ölçülendirme

Canvas üzerinde yer alan mavi cetveller, hizalama ve ölçülendirme işlemlerini kolaylaştırır.

• Cetvel birimleri point (pt), milimetre (mm) ve inch olarak görüntülenebilir.
• Mevcut sayfa türlerinde ölçü birimi point–mm–inch şeklindedir.
• Custom sayfa seçildiğinde ölçü birimi pt / mm / inch olarak ayrı ayrı seçilebilir.
• Ölçü birimi değiştirildiğinde:
  
  • Cetvel değerleri
  • Styling panelindeki width, height, x, y alanları
    seçilen birime göre güncellenir.

Ayrıca cetvel üzerinden kılavuz çizgileri (guide) eklenerek hizalama daha da kolaylaştırılabilir.

Sayfa Kenar Boşlukları (Padding)

Sayfa kenar boşlukları özelleştirilebilir. Noktalı tasarım modunda padding alanları noktasız gösterilerek içerik alanı görsel olarak ayrıştırılır.

Paper Size (Kağıt Boyutu)

Header bölümünde bulunan Paper Size alanı aşağıdaki seçenekleri içerir:

• Custom: 200 px ve üzeri (örn. 850×1300 px) tamamen özelleştirilmiş sayfa boyutu tanımlanabilir.
• Letter: 8.5×11 inches (850×1100 px)
• A3: 297×420 mm (1168×1654 px)
• A4: 210×297 mm (826×1168 px)
• A5: 148×210 mm (584×826 px)

Boyutlandırma ikonuyla genişlik ve yükseklik manuel olarak düzenlenebilir. Bu ayarlar, raporun hem dijital hem de basılı çıktılarda doğru görünmesini sağlar.

Canvas’ın sol tarafında yer alan Elements Paneli, rapor içeriğini oluşturmak için kullanılan tüm elementleri içerir.

Header & Footer

• Sayfa başı ve alt bilgileri otomatik ekler.
• İçerisine element sürüklendiğinde alan yetersizse otomatik olarak büyür.
• QR Renderer ve Barcode Renderer bu alanların içine sürüklenemez.
• Height ve border ayarları yapılabilir.
• Dinamik raporlarda:
  
  • Rapor birden fazla sayfaya bölünürse
    
    • Header yalnızca ilk sayfada
    • Footer yalnızca son sayfada görüntülenir.
• Sistem içinde Report Header olarak değerlendirilir.

Page Header & Page Footer

Sayfa bazlı tekrar eden başlık ve alt bilgi alanları oluşturmak için kullanılır.

• Rapor birden fazla sayfaya bölündüğünde her sayfada tekrar eden içerikler eklemek için kullanılır.
• İçerisine Label, Image, Icon ve diğer desteklenen elementler sürüklenebilir.
• Alan yetersiz olduğunda yükseklik otomatik olarak genişleyebilir.
• Height ve border ayarları yapılabilir.

Box

• Width, height, x ve y değerleri düzenlenebilir.
• Fill color ve border ayarları yapılabilir.
• İçerisine istenilen element sürüklenebilir.
• İçine eklenen içerik sığmazsa Box alanı otomatik genişler.

Label

• Metin eklemek için kullanılır.
• Yazı yönü ayarlanabilir.
• Sağdan sola ve soldan sağa Vertical WritingMode desteği vardır.
• Symbol Picker üzerinden Current Page seçilerek dinamik sayfa numarası eklenebilir.
• Symbol Picker üzerinden Total Pages seçilerek rapordaki toplam sayfa sayısı dinamik olarak gösterilebilir.
• Label elementi için Border desteği bulunur. Border özelliği ile kenarlık rengi, kalınlığı ve görünümü düzenlenebilir.

Icon & Image

• Görseller ve simgeler eklenebilir.
• Boyut, renk ve konum ayarları yapılabilir.

Vertical Panel

• Dikey sabit panel oluşturmak için kullanılır.
• Sürükleyerek konumlandırılabilir.
• Arka plan rengi ve border ayarlanabilir.
• Birden fazla Vertical Panel eklenebilir.

QR Renderer & Barcode Renderer

• Değer (Value) girildikten sonra width ve height ayarlanabilir.
• Veri temelli görselleştirme için kullanılır.

Divider

• Ayraç ekler.
• Y pozisyonu, renk ve border ayarları yapılabilir.
• Düz veya dashed (kesikli) stil uygulanabilir.

Page Break

• Sayfa sonu eklemek için kullanılır.
• Örneğin A4 (297 mm) boyutlu iki sayfa oluşturmak için:
  
  • Cetvelde Y = 297 olacak şekilde Page Break eklenebilir.
  • Layout tarafında Y değeri manuel olarak da 297 girilebilir.

Report Table

Report Table, dinamik veri gösterimi için kullanılır.

Report Table kullanabilmek için:

• Önce Get Report Base64 aksiyonu eklenmelidir.
• Ardından Print PDF veya Download PDF aksiyonu eklenmelidir.

Özellikler:

• Dinamiktir.
• Bir kolon içerisine birden fazla Label eklenebilir.
• Element Direction özelliği ile yatay (horizontal) veya dikey (vertical) yön seçilebilir.
• Element gap ayarlanabilir.
• Fill color ve border özellikleri desteklenir.

Static Table

Static Table, Excel benzeri sabit tablo yapısı sunar.

• İçerisine Label sürüklenerek x–y bazlı konumlandırma yapılabilir.
• Border ayarlanabilir.
• Kolon bazında:
  
  • Colspan
  • Rowspan özellikleri desteklenir.

Table Operations

Alt kısımdaki Table Operations alanından:

• Üste/alta satır eklenebilir.
• Sağa/sola kolon eklenebilir.
• Kolon içeriği temizlenebilir.
• Hücreler birleştirilebilir (Merge).

Merge işlemi sırasında:

• Colspan ve Rowspan otomatik olarak devreye girer.

Birden fazla hücre seçildiğinde, seçilen kolon sayısı Colspan alanına otomatik yansır.

Reports Paneli, uygulamadaki tüm raporların listelendiği ve yönetildiği ana ekrandır.

• Yeni bir rapor eklemek için + butonuna tıklayın.
• Rapor ismi belirleyerek CREATE butonuna tıklayın.
• Mevcut raporları düzenleyebilir, kopyalayabilir veya silebilirsiniz.

Properties Paneli, seçilen elemente göre farklı ayarlar sunar:

• Actions:
  
  • Rapor içinde aksiyonlar tanımlanabilir (örn: Share butonu ekleyerek rapor paylaşımı yapabilirsiniz).
• Report Inputs:
  
  • Başka ekranlardan veri alarak rapora dinamik bilgiler ekleyebilirsiniz.
  • Tarih aralıkları gibi filtreler tanımlayabilirsiniz.

Element bazında farklı ayarlar sunulur:

• Icon: Renk ve boyut ayarları yapabilirsiniz.
• Label: Metin hizalama ve yazı tipi ayarları mevcuttur.

Watermark

Watermark alanı, rapor üzerine filigran (watermark) eklemek için kullanılır. Filigranlar genellikle:

• taslak (Draft) ibaresi göstermek
• şirket adı eklemek
• belge güvenliği sağlamak
• raporun kopya olduğunu belirtmek gibi amaçlarla kullanılır.

Watermark ayarları Screen seçiliyken Properties paneli üzerinden yapılır.

• Enable
  
  • Watermark özelliğini aktif veya pasif hale getirir.
  • Açık olduğunda filigran rapor üzerinde görüntülenir.
• Type: Watermark türünü belirler.
  
  • Seçenekler:
    
    • Text: Filigran metin olarak gösterilir.
    • Image: Filigran görsel olarak eklenir.
• Text: Filigran olarak gösterilecek metni belirler.
• Font Size: Filigran metninin yazı boyutunu belirler. Büyük font değerleri, filigranın sayfa üzerinde daha belirgin görünmesini sağlar.
• Font: Filigran metni için kullanılacak yazı tipini belirler.
• Color: Filigran metninin rengini belirler. Genellikle açık gri tonları kullanılarak rapor içeriğinin okunabilirliği korunur.
• Bold: Metnin kalın (bold) olarak gösterilmesini sağlar. 
• Italic: Metnin italik olarak gösterilmesini sağlar.
• Opacity (%): Filigranın saydamlık seviyesini belirler.
  
  • Düşük değerler filigranın daha silik görünmesini sağlar.
  • Yüksek değerler filigranın daha belirgin görünmesine neden olur.
• Rotation: Filigranın sayfa üzerindeki dönüş açısını belirler.
  
  • Örneğin: -45° değeri filigranın sayfa üzerinde çapraz görünmesini sağlar.
• Position: Filigranın sayfa üzerindeki konumunu belirler.
  
  • Seçenekler:
  • Center: Filigran sayfanın ortasında gösterilir.
  • Custom: Filigran konumu manuel olarak belirlenir.
• Custom X / Custom Y: Position değeri Custom seçildiğinde aktif olur. Bu alanlar filigranın sayfa üzerindeki konumunu belirler.
  
  • Custom X: Yatay konum
  • Custom Y: Dikey konum
• Tile Repeat: Filigranın sayfa üzerinde tekrar edip etmeyeceğini belirler.
  
  • Aktif olduğunda filigran sayfa boyunca tekrar eder.
  • Pasif olduğunda filigran yalnızca tek bir konumda gösterilir.

Report Parameters

Report Parameters alanı, rapor içerisinde kullanılan parametrik değerlerin yönetilmesini sağlar. Label gibi elementlerde metin içerisine @parametre formatında değerler yazıldığında, bu parametreler otomatik olarak algılanır ve Screen seçiliyken Properties panelinde Report Parameters bölümünde görüntülenir.

Örneğin:

• My name is @name @surname

Bu kullanımda:

• name
• Surname parametreleri otomatik olarak Report Parameters listesine eklenir.

Parametre Oluşturma

Parametrik değer oluşturmak için:

• Canvas üzerinde bir Label elementi ekleyin.
• Label metni içine @parametreAdı formatında bir değer yazın.
• Screen seçildiğinde Report Parameters panelinde bu parametre otomatik olarak görünür.
• Birden fazla parametre aynı metin içerisinde kullanılabilir.
  
  • Örnek: My name is @name @surname. Bu durumda iki parametre oluşturulur.

Parametre Değer Kaynakları

Her parametre farklı kaynaklardan değer alabilir.

Desteklenen değer türleri:

• Default Value: Parametre için varsayılan bir değer tanımlanabilir.
• Fixed Value: Parametreye sabit bir değer atanabilir.
• Report Inputs: Parametre değeri başka bir ekran veya kullanıcı girdisinden alınabilir.
• Action Result: Parametre değeri bir aksiyon sonucundan alınabilir.
  
  

Bu yapı sayesinde rapor içerisinde dinamik veri gösterimi sağlanabilir.

Parametrelerin Raporda Kullanılması

Parametrelere verilen değerler, rapor oluşturulduğunda ilgili Label veya element içerisinde otomatik olarak görüntülenir.

Örneğin: Label değeri: My name is @name @surname

Parametre değerleri:

• name = John
• surname = Doe

Rapor çıktısı: My name is John Doe

Parametre Görünürlüğü

Report Parameters paneli yalnızca raporda parametrik değer kullanıldığında görüntülenir.

Rapor içerisinde herhangi bir @parametre kullanılmadığında bu bölüm görünmez.

Styling Paneli, görsel ayarlamalar yapmanıza olanak tanır.

• Fill Paneli: Canvas arka plan rengini belirleyebilirsiniz.
• Background Image:
  
  • Add Image: Cihazınızdan görsel ekleyebilirsiniz.
  • Generate With AI: Yapay zeka ile arka plan görseli oluşturabilirsiniz.

Styling Paneli, raporlarınıza profesyonel bir görünüm kazandırmanıza yardımcı olur.

Report Designer; serbest konumlandırma, gelişmiş ölçülendirme, dinamik tablo yapıları ve görsel özelleştirme seçenekleri ile raporlarınızı hem veri odaklı hem de profesyonel görünümlü hale getirmenizi sağlar. Bu modül sayesinde uygulamalarınız için etkili, esnek ve baskı uyumlu raporlar tasarlayabilirsiniz.