> 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/faydali-ipuclari.md).

# Faydalı İpuçları

{% hint style="warning" %} <mark style="color:$warning;">**Sekme adı = Şablon değişkeni:**</mark> SQL editördeki sekme adı ile şablondaki değişken adı birebir eşleşmelidir. "sale" adında bir sekme varsa şablonda `{{ sale|sum(...) }}` ve `sale|groupby(...)` gibi ifadeler kullanılır. Adlar uyuşmazsa şablon boş çıktı üretir veya hata verir.
{% endhint %}

{% hint style="warning" %} <mark style="color:$warning;">**month kolonu zorunluluğu (v1 ve v2):**</mark> v1 ve v2 şablonları satırları aya göre grupladığından `SQL` sorgusunda month kolonunun hem `SELECT` hem `GROUP BY` ifadelerinde bulunması gerekir. Bu kolon `WHERE` koşulunda zaten varsa `GROUP BY`'a eklenmesi mevcut sonuçları bozmaz.
{% endhint %}

{% hint style="warning" %} <mark style="color:$warning;">**Tekli/Çoklu seçim ve SQL operatörü:**</mark> Tekli seçimli parametreler `SQL`'de `=` operatörüyle, çoklu seçimli parametreler `IN` operatörüyle kullanılır. Parametre tipini `SQL`'deki kullanımla eşleştirmek zorunludur; aksi hâlde sorgu hata verir.
{% endhint %}

{% hint style="success" %} <mark style="color:$success;">**Birden fazla sorgu sekmesi:**</mark> Artı (+) butonu ile aynı rapor tanımına birden fazla sorgu sekmesi eklenebilir. Her sekme farklı bir veri kümesine karşılık gelir ve şablonda ayrı değişken adıyla erişilir. Bu özellik karmaşık raporlarda farklı tabloları tek çıktıda birleştirmeye olanak tanır.
{% endhint %}

{% hint style="success" %} <mark style="color:$success;">**Şablon sürüm yönetimi:**</mark> "Şablonu İndir" ile mevcut şablonun yerel kopyası alınabilir. Yeni versiyonu yüklemeden önce bu adım yapılması, eski şablonun kaybolmamasını sağlar. Sürümler "sablon\_v0.xlsx", "sablon\_v1.xlsx" gibi isimlerle saklanabilir.
{% endhint %}

{% hint style="info" %} <mark style="color:$primary;">**Varsayılan format ayarları:**</mark> "Gelişmiş Format Ayarları"nda "Varsayılan olarak uygula" seçildiğinde, yapılan ayarlar sonraki tüm indirmelerde otomatik uygulanır. Kağıt boyutu, dil veya kenar boşluğu gibi değişmeyen ayarlar bu şekilde kaydedilmelidir.
{% endhint %}

{% hint style="warning" %}
Parametre dropdown boşsa: Dinamik liste `SQL` sorgusuyla doldurulur. Dropdown boş geliyorsa hücre yanındaki yenile butonu tıklanmalıdır. Sorun devam ediyorsa parametre tanımındaki `SQL` sorgusu ve bağlantı seçimi kontrol edilmelidir.
{% endhint %}


---

# 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/faydali-ipuclari.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.