> For the complete documentation index, see [llms.txt](https://learn.vispeahen.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://learn.vispeahen.com/raporlama/adim-adim-rapor-olusturma.md).

# Adım Adım Rapor Oluşturma

Aşağıdaki adımlar, Vispeahen ana sayfasından "Yeni Rapor" butonuna tıklanmasından raporun ilk kez indirilmesine kadar tüm süreci kapsar.

{% stepper %}
{% step %}

### <mark style="color:$primary;">Yeni Rapor Açma ve İsimlendirme</mark>

Vispeahen ana sayfasında sol üst köşedeki "Yeni Rapor" butonuna tıklanır.&#x20;

<figure><img src="/files/VjXtGAObbfBg2B4rpeBw" alt=""><figcaption></figcaption></figure>

Report Designer ekranı açılır.

<figure><img src="/files/4hZDTeL2w8qTBqjxDdww" alt=""><figcaption></figcaption></figure>

Ekranın üst kısmında rapora başlık verilir. Başlık alanına tıklanarak anlamlı bir isim yazılır (örneğin "Satış Performans Custom Report"). Başlık kalem ikonu (ikon 1) ile sonradan da değiştirilebilir. Kaydet butonuna (ikon 2) tıklandığında rapora özgün bir kimlik atanır ve tarayıcı URL'si güncellenir.
{% endstep %}

{% step %}

### <mark style="color:$primary;">Veri Kaynağı Seçimi</mark>

Sol panelde mevcut bağlantılardan ilgili veri kaynağı seçilir. Seçili bağlantı yeşil renkle vurgulanır.

<figure><img src="/files/tVrkxmxue3hMlnsDI9Fc" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/yjptE48ey60lsWfymOB1" alt=""><figcaption></figcaption></figure>

Yeni bağlantı eklemek için: "Yeni Bağlantı" butonuna tıklanır. Bağlantı türü seçilir (PostgreSQL, Oracle, SQL Server, MySQL ve platforma entegre diğer veritabanı motorları desteklenmektedir). Bağlantıya bir isim verilir; sunucu adresi, port, veritabanı adı, kullanıcı adı ve şifre girilir. "Test Bağlantısı" ile doğrulandıktan sonra kaydedilir.

<figure><img src="/files/AzLlJAJhBRR28k3B3xaP" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### <mark style="color:$primary;">Sorgu Adı ve SQL Yazma</mark>

<mark style="color:$warning;">Sekme adı şablonla eşleşmelidir:</mark> Orta paneldeki sekme adı (varsayılan "ornek\_sorgu"), şablonda kullanılacak ana değişken adıyla birebir aynı olmalıdır. Satış örneğinde sekme adı "sale" olarak ayarlanmıştır; şablonda {{ sale|groupby(...) }}, {{ sale|sum(...) }} gibi ifadeler bu ismi kullanır. Sekme adı kalem ikonu ile değiştirilir.

<figure><img src="/files/iTjGIOetg0zr6BHtOhVE" alt=""><figcaption></figcaption></figure>

Artı (+) butonu ile aynı rapora birden fazla sorgu sekmesi eklenebilir. Her sekme bağımsız bir değişken adı taşır ve şablonda ayrı ayrı erişilebilir. Bu, tek çıktıda farklı veri kümelerini birleştirmeye olanak tanır.

**Parametre referansı:** Sorguda parametreler `:parametre_adi` biçiminde yazılır. Tekli parametreler WHERE koşulunda `=` ile, çoklu parametreler `IN` ile kullanılır. Örneğin,

`WHERE year = :yil   AND month IN :ay   AND product_category IN :urun_kategorisi`

SQL tamamlandıktan sonra sağ üstteki kaydet ikonuna tıklanır.
{% endstep %}

{% step %}

### <mark style="color:$primary;">Parametre Tanımlama</mark>

Sağ panelde "Yeni Parametre" butonuna tıklanarak yeni parametre formu açılır.

<figure><img src="/files/pKfE3h53kH0Wn7oNtDJn" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/BuiHeTaSfphGtlWtO83n" alt=""><figcaption><p align="center"><em>Yeni Parametre formu: Parametre İsmi, Veri Tipi ve Giriş Tipi alanları. Giriş Tipi için Liste + Dinamik + Tekli/Çoklu kombinasyonu seçilebilir.</em></p></figcaption></figure>

* **Parametre İsmi:** Küçük harfle başlamalı, yalnızca harf, rakam ve alt çizgi içerebilir (A-Z, 0-9, \_). Türkçe karakter kullanılamaz. İsim, sorgudaki `:parametre_adi` ile birebir eşleşmelidir.
* **Veri Tipi:** Sayı (sayısal kolonlar) veya Metin (metin kolonlar). Yanlış veri tipi seçilirse dropdown listesi boş gelir.
* <mark style="background-color:$warning;">**Giriş Tipi — Tekli seçim:**</mark> Yalnızca bir değer seçilebilir. SQL sorgusunda `=` operatörü ile kullanılır. Örnek: `WHERE year = :yil` — yıl parametresi tekli seçim olduğundan = uygundur.
* <mark style="background-color:$warning;">**Giriş Tipi — Çoklu seçim:**</mark> Birden fazla değer seçilebilir. SQL sorgusunda `IN` operatörü ile kullanılır. Örnek: `AND month IN :ay` — ay parametresi çoklu seçim olduğundan IN uygundur. Çoklu parametreler Liste + Dinamik kombinasyonuyla tanımlanır.
* **Parametre Değerleri:** Dinamik modda, dropdown listesini doldurmak için bir SQL sorgusu yazılır. Örnek: `select year from perakende_eticaret_data ORDER BY year desc`

Kaydet tıklandıktan sonra parametre sağ panelde listelenir. Kalem ikonu ile düzenlenir, kırmızı çöp kutusu ikonu ile silinir. Çok sayıda parametre olduğunda "Ara" alanı hızlı filtreleme sağlar.

<figure><img src="/files/0Ykmirz0tXGrEMv7m5Ah" alt=""><figcaption><p align="center"><em>yil parametresi — Tekli seçim: Sayı veri tipi, Liste + Dinamik + Tekli. SQL WHERE koşulunda = operatörü ile kullanılır.</em></p></figcaption></figure>

<figure><img src="/files/bRPNlymkbLrTG5b4K9cA" alt=""><figcaption><p align="center"><em>ay parametresi — Çoklu seçim: Sayı veri tipi, Liste + Dinamik + Çoklu. SQL'de IN operatörüyle kullanılır; birden fazla ay seçimine izin verir.</em></p></figcaption></figure>

<figure><img src="/files/afWeu7d96PvLyfnvGMn4" alt=""><figcaption><p align="center"><em>urun_kategorisi parametresi — Çoklu seçim: Metin veri tipi, Liste + Dinamik + Çoklu. SQL'de AND product_category IN :urun_kategorisi olarak kullanılır.</em></p></figcaption></figure>
{% endstep %}

{% step %}

### <mark style="color:$primary;">Şablon Yükleme</mark>

Üst araç çubuğunda dosya ikonuna tıklanır; "Rapor Şablonu" paneli açılır.

<figure><img src="/files/B5E7M2GxVx6hVekkWDvR" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/QAzIGRpfg11l3be4q91s" alt=""><figcaption><p align="center"><em>Rapor Şablonu paneli: Şablon ismi ve yüklü dosya bilgisi (dosya adı, boyut). "Dosyayı Değiştir" ile güncelleme yapılabilir.</em></p></figcaption></figure>

Şablon için bir isim girilir (örn. "Satış Performans Şablon").

**Şablon formatı:** Hazırlanan şablon `Jinja (.xlsx)` ya da `JXLS (.xlsx)` formatında olabilir. Her iki format da sisteme aynı yolla yüklenir.

"Dosya Seç" ile şablon dosyası seçilip yüklenir. Mevcut şablon varsa "Dosyayı Değiştir" ile güncellenir, "Şablonu İndir" ile yerel kopya alınır.

"Şablonu Kaydet" ile değişiklikler kaydedilir.,
{% endstep %}

{% step %}

### <mark style="color:$primary;">Etiket Atama</mark>

Üst araç çubuğunda etiketler ikonuna tıklanır; Etiketler paneli açılır.

<figure><img src="/files/BVpbliS9RNrwhdcOCJxi" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/fVCY22URWdML5CamV5Kr" alt=""><figcaption><p align="center"><em>Etiketler paneli: Mevcut etiket listesi (Alacak ve Tahsilat, Belediye, Enerji, Eğitim, Finans). Seçili etiket mavi kapsül olarak üstte görünür.</em></p></figcaption></figure>

Mevcut etiketlerden biri seçilir (örn. "Perakende E-Ticaret", "Finans", "Eğitim"). Seçili etiket mavi etiket olarak görünür.

"Etiket Oluştur" bağlantısı ile yeni bir kategori tanımlanabilir.

Etiket, raporun ana sayfada hangi bölümde listeleneceğini belirler. Bu adım zorunlu değildir; ancak raporun kolay bulunabilmesi için önerilir.
{% endstep %}

{% step %}

### <mark style="color:$primary;">Raporu Oluşturma ve İndirme</mark>

Üst araç çubuğunda indirme ikonuna tıklanır; "Raporu Oluştur" popup'u açılır.

<figure><img src="/files/Nwad2toNC42rR9OoYlxD" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/q9zA1NLnAollKRJtQDsP" alt=""><figcaption><p>Raporu Oluşrur popup'u</p></figcaption></figure>

Her parametre için değer seçilir. Dropdown listesi dolmuyorsa yanındaki yenile (↺) butonuna tıklanır.

Format Ayarları: Dosya tipi (`Excel / PDF`), dil (`Türkçe / İngilizce`) ve oryantasyon (`Dikey / Yatay`) seçilir. *"Gelişmiş Format Ayarları"* butonu ek seçenekler sunar.

*"Raporu Oluştur"* butonuna tıklandığında render başlar. Sağ taraftaki *"İşlem Geçmişi"* panelinde ilerleme takip edilebilir. Tamamlandığında *"Bitti"* ibaresi görünür ve dosya tarayıcıya otomatik indirilir.

*"Yinele"* ile aynı parametre seçimleri kullanılarak rapor tekrar indirilebilir. *"Geçmişi Temizle"* ile geçmiş liste boşaltılır.

<figure><img src="/files/gLwpiA2p5LxgedPTBpn2" alt=""><figcaption><p><em>Raporu Oluştur popup'u — Viewer/indirme ekranı: Parametreler seçilmiş (yil=2024, ay=12×11×, urun_kategorisi=Mobilya×Hobi ve Oyuncak×)</em></p></figcaption></figure>

<figure><img src="/files/eYojwnqLSzi28TY4RktV" alt=""><figcaption><p align="center"><em>Raporu Oluştur popup'u — Editor/Admin görünümü: Sağ tarafta "İşlem Geçmişi" paneli açık; bir tamamlanmış bir de  devam etmekte indirme girişi "Bitti" ve "Yinele" seçenekleriyle listelenmektedir.</em></p></figcaption></figure>
{% endstep %}
{% endstepper %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://learn.vispeahen.com/raporlama/adim-adim-rapor-olusturma.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.