> 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/kumanda-tablosu/plugin-listesi/filtreler/filter-filtre.md).

# Filter: Filtre

Filtre bileşeni, kumanda tablosunda görüntülenen verilerin belirli kriterlere göre sınırlandırılmasını sağlayan temel filtreleme bileşenidir. Kullanıcılar filtre üzerinde seçim yaparak dashboard üzerinde bulunan görselleri ve diğer bileşenleri dinamik olarak filtreleyebilir.

Filtre bileşeni; metin, sayı, tarih ve kategorik alanlar üzerinde filtreleme yapılmasına olanak sağlar. Filtre üzerinde yapılan seçimler, filtre ile ilişkilendirilen görsellere anlık olarak uygulanır.

### Filtre Bileşeninin Eklenmesi

Filtre bileşeni eklemek için Plugin Listesi içerisinden **Filtre** bileşeni seçilir ve kumanda tablosuna eklenir.

<figure><img src="https://3143653407-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0vZHisAf5833eglFw2GE%2Fuploads%2Fs8LCrnk4VxAqrrtP3Vf3%2FScreenshot%202026-06-23%20143100.png?alt=media&amp;token=86c1d590-6e87-4633-99ec-2a7ad9910d81" alt=""><figcaption></figcaption></figure>

Filtre bileşeni eklendikten sonra filtreleme yapılacak alanın belirlenmesi ve gerekli yapılandırmaların tamamlanması gerekmektedir.

### Filtre Araçları

Filtre bileşeni seçildiğinde üst menüde aşağıdaki araçlar görüntülenir:

<figure><img src="https://3143653407-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0vZHisAf5833eglFw2GE%2Fuploads%2FR1mRzCnDG7bYkhUJtvvE%2FVispeahen%20User%20Manual%20(24).png?alt=media&amp;token=2fe5b91f-1393-481d-b9ed-e3c761f2a71c" alt="" width="353"><figcaption></figcaption></figure>

1. Araçları Aç/Kapat: Görsel ile ilgili düzenleme yapılan ikonların açıp kapatıldığı ikondur.
2. Veri: Kullanıcının kendi verileriyle görseli şekillendireceği alandır.
3. Ayarlar: Görselin renk/başlık gibi biçimsel özelliklerinin değiştirildiği alandır.
4. Etkileşim: Görselden diğer görsellere filtre verilen alandır.
5. Yenile: Veri alanı ile grafiğin çalışması ve grafiğin yenilenmesini sağlar.
6. Kaldır: Görseli silmek için kullanılan alandır. “Kaldır” ikonuna tıklandığında “Bu görseli silmek istiyor
   \
   musunuz?” şeklinde uyarı çıkmaktadır.

> **Not:** Etkileşim ayarları tüm görsel bileşenlerde ortak olarak kullanıldığından, ilgili bölüm ayrı başlık altında detaylı olarak açıklanmaktadır.

### Veri Yapılandırması

Filtre bileşeninin çalışabilmesi için filtreleme yapılacak alanın tanımlanması gerekmektedir. Bu işlem bileşenin **Veri** ekranı üzerinden gerçekleştirilir.

<figure><img src="https://3143653407-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0vZHisAf5833eglFw2GE%2Fuploads%2FkrvcIRcRWg3g6mpuvAn9%2FScreenshot%202026-06-23%20143307.png?alt=media&amp;token=69f15aaa-6068-4495-b37e-b11871056c8a" alt=""><figcaption></figcaption></figure>

<mark style="color:green;">**Tablolar & Kolonlar**</mark>
: Seçili modelde var olan tablo ve kolonların bulunduğu alandır.
&#x20;Tablolar & Kolonlar bölümünde yer alan kolonlar, sağ tarafta bulunan bölümlere sürükle-bırak ile eklenir.
\\

<mark style="color:green;">**Kolon Eşleştirmeleri**</mark>

* **Sıralama:** Kolon verisinin artan/azalan şekilde sıralamasının yapıldığı alandır.
* **Filtre:** Grafikte yer alacak verinin ekleneceği alandır.
* **Saklı Alan:** Eklenen kolonların sıralamaya dahil edilebilmesi veya grafikte görüntülenmek istenmeyen kolonların sorguya dahil edilmesi için kullanılan alandır.

### Yapılandırma Ayarları

Filtre bileşenine ait görünüm ve davranış ayarları **Ayarlar** ekranı üzerinden yönetilir. Filtre ayarları kullanılan veri tipine göre farklılık gösterebilir.

<figure><img src="https://3143653407-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0vZHisAf5833eglFw2GE%2Fuploads%2FvnPi5qeVPgaN1UfYmv8c%2FScreenshot%202026-06-23%20143624.png?alt=media&amp;token=02c920bc-43bb-4408-95c7-575276c68e43" alt=""><figcaption></figcaption></figure>

<mark style="color:blue;">**Metin ve Sayı Veri Tipi Ayarları**</mark>

<mark style="color:green;">**Genel Görünüm**</mark>

<figure><img src="https://3143653407-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0vZHisAf5833eglFw2GE%2Fuploads%2Fw7wuO6cfyIoUCGZ1IsCH%2Ffiltre%20genel%20g%C3%B6r%C3%BCn%C3%BCm.png?alt=media&amp;token=c0e2e83b-e478-4d92-9bd1-c55f616a309a" alt=""><figcaption></figcaption></figure>

**Arkaplan Rengi:** Grafiğin arka plan rengini belirlemenizi sağlar. Renk seçimi, mevcut palet üzerinden yapılabilir.

**Ok Rengi:** Filtre alanındaki seçim okunun rengini belirler.

**Metin Arka Plan Rengi:** Filtre ve operatör alanlarının arka plan rengini belirler.

**Filtre Seçilmeden Önce Görünecek Değer:** Kullanıcı seçim yapmadan önce filtre alanında gösterilecek açıklayıcı metnin belirlenmesini sağlar.

**Yer Tutucu Rengi:** Filtre seçilmeden önce gösterilen metnin (placeholder) rengini belirler.

<mark style="color:green;">**Başlık Ayarları**</mark>

<figure><img src="https://3143653407-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0vZHisAf5833eglFw2GE%2Fuploads%2FY60PjsMRhPFlcDAYnpSe%2Fba%C5%9Fl%C4%B1k%20ayarlar%C4%B1%20veri%20yok%20olmadan.png?alt=media&amp;token=7f64d662-be20-4b71-9097-a2ea46f40b69" alt=""><figcaption></figcaption></figure>

**Başlık:** Grafiğe verilecek başlığın tanımlandığı alandır.

**Başlık Hizası:** Grafik başlığının sola, ortaya veya sağa hizalanmasını sağlar.

**Başlık Yazı Stilleri:** Grafik başlığının kalın, italik veya altı çizili gibi yazı stilleriyle biçimlendirilmesini sağlar.

**Başlık Yazı Stili:** Grafik başlığında kullanılacak yazı tipini (font) belirlemenizi sağlar.

**Başlık Yazı Rengi:** Grafik başlığının metin renginin değiştirilmesini sağlar.

**Başlık özelliklerini rapordaki diğer pluginlere uygula:** Tanımlanan başlık ayarlarının (stil, renk, hizalama vb.) aynı dashboard içindeki diğer grafik bileşenlerinin başlıklarına da otomatik olarak uygulanmasını sağlar.

<mark style="color:green;">**Diğer**</mark>

<figure><img src="https://3143653407-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0vZHisAf5833eglFw2GE%2Fuploads%2FBWZ7OuWARHOEH4Hi8hk8%2Ffiltre%20di%C4%9Fer.png?alt=media&amp;token=fd586d6c-7993-49e2-9159-3d5cfd2520f6" alt=""><figcaption></figcaption></figure>

**Filtre Operatörü:** Filtrelemede kullanılacak operatörün (örneğin eşittir, büyüktür gibi) ne olacağının belirlenmesini sağlar.

**Operatör Opsiyonlarını Göster:** Bu seçenek işaretlendiğinde, filtreyle birlikte operatör alanı da görüntülenir.

**Varsayılan Filtre İkonunu Göster:** Varsayılan (default) olarak tanımlanmış bir filtre varsa, bu seçenek işaretlendiğinde filtre ikonu görüntülenir.

**El ile Giriş:** Bu seçenek işaretlendiğinde, filtre değeri kullanıcı tarafından manuel olarak girilebilir. Giriş işlemi sonrasında kullanılmak üzere bir "Uygula" butonu görüntülenir ve bu butonla ilgili ayar alanları aktif hale gelir.

<figure><img src="https://3143653407-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0vZHisAf5833eglFw2GE%2Fuploads%2F2evqGdl46VpFi2CAparQ%2Ffiltre%20el%20ile%20giri%C5%9F.png?alt=media&amp;token=0b721739-5c20-422d-8f79-c64d70748674" alt=""><figcaption></figcaption></figure>

* **Uygula Buton Yazısı:** Uygula butonu üzerinde görüntülenecek metnin belirlenmesini sağlar.
* **Uygula Butonu Arkaplan Rengi:** Uygula butonunun arka plan renginin belirlenmesini sağlar.
* **Uygula Butonu Yazı Rengi:** Uygula butonundaki yazının renginin belirlenmesini sağlar.

**Çoklu Seçim:** Kullanıcının filtre alanında birden fazla değer seçip seçemeyeceğini belirler.

**Veri Yok Açıklaması:** Grafikte görüntülenecek veri bulunmadığında, kullanıcıya gösterilecek bilgilendirici metnin tanımlandığı alandır.

* <mark style="color:blue;">**Tarih Veri Tipi Ayarları**</mark>

<mark style="color:green;">**Genel Görünüm**</mark>

<figure><img src="https://3143653407-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0vZHisAf5833eglFw2GE%2Fuploads%2FjasJgNVcflN5ri3u427x%2Ffiltre%20tarih%20genel%20g%C3%B6r%C3%BCn%C3%BCm.png?alt=media&amp;token=adb9e4f3-5182-4792-8bec-cc2aa01d933d" alt=""><figcaption></figcaption></figure>

**Arkaplan Rengi:** Grafiğin arka plan rengini belirlemenizi sağlar. Renk seçimi, mevcut palet üzerinden yapılabilir.

<mark style="color:green;">**Başlık Ayarları**</mark>

<figure><img src="https://3143653407-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0vZHisAf5833eglFw2GE%2Fuploads%2FY60PjsMRhPFlcDAYnpSe%2Fba%C5%9Fl%C4%B1k%20ayarlar%C4%B1%20veri%20yok%20olmadan.png?alt=media&amp;token=7f64d662-be20-4b71-9097-a2ea46f40b69" alt=""><figcaption></figcaption></figure>

**Başlık:** Grafiğe verilecek başlığın tanımlandığı alandır.

**Başlık Hizası:** Grafik başlığının sola, ortaya veya sağa hizalanmasını sağlar.

**Başlık Yazı Stilleri:** Grafik başlığının kalın, italik veya altı çizili gibi yazı stilleriyle biçimlendirilmesini sağlar.

**Başlık Yazı Stili:** Grafik başlığında kullanılacak yazı tipini (font) belirlemenizi sağlar.

**Başlık Yazı Rengi:** Grafik başlığının metin renginin değiştirilmesini sağlar.

**Başlık özelliklerini rapordaki diğer pluginlere uygula:** Tanımlanan başlık ayarlarının (stil, renk, hizalama vb.) aynı dashboard içindeki diğer grafik bileşenlerinin başlıklarına da otomatik olarak uygulanmasını sağlar.

<mark style="color:green;">**Diğer**</mark>

<figure><img src="https://3143653407-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0vZHisAf5833eglFw2GE%2Fuploads%2FSTegxnUIeH00Dy0wt70A%2Ffiltre%20tarih%20di%C4%9Fer.png?alt=media&amp;token=36c807f1-5083-4210-8d50-d1e78e8fae5a" alt=""><figcaption></figcaption></figure>

**Filtre Operatörü:** Filtrelemede kullanılacak operatörün (örneğin eşittir, büyüktür gibi) ne olacağının belirlenmesini sağlar.

**Operatör Opsiyonlarını Göster:** Bu seçenek işaretlendiğinde, filtreyle birlikte operatör alanı da görüntülenir.

**Liste Gösterimi:** Bu seçenek işaretlendiğinde, tarih veri tipi için varsayılan olarak sunulan takvim görünümü yerine, açılır liste (dropdown) görünümü kullanılır.

### Etkileşim Ayarları

Filtre bileşeni, kumanda tablosunda bulunan diğer görseller ile ilişkilendirilebilir. Bu sayede filtre üzerinde yapılan seçimler belirlenen görselleri otomatik olarak etkiler.

<figure><img src="https://3143653407-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0vZHisAf5833eglFw2GE%2Fuploads%2FJu2Jz7iJj5i3OiYawtEq%2FScreenshot%202026-06-23%20142421.png?alt=media&amp;token=806d3212-9525-49f1-bf5f-725005eb034c" alt=""><figcaption></figcaption></figure>

Etkileşim yapılandırmaları kullanılarak filtre seçimlerinin hangi görseller üzerinde etkili olacağı belirlenebilir.

{% hint style="info" %}
Etkileşim ayarları hakkında detaylı bilgi için [**Etkileşim Yönetimi**](/kumanda-tablosu/filtreleme-ve-etkilesim/interaction.md) bölümüne bakabilirsiniz.
{% endhint %}

### Kullanım Örneği

<figure><img src="https://3143653407-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0vZHisAf5833eglFw2GE%2Fuploads%2F8cmIhJVDUrG6iaqGqn3d%2FScreenshot%202026-06-24%20142356.png?alt=media&amp;token=bfe3d44f-c669-4653-bd8c-3aeba1cc452d" alt=""><figcaption></figcaption></figure>

Yukarıdaki örnekte, kumanda tablosunun sol üst kısmında bulunan **Yıl** filtresi kullanılarak veriler belirli bir yıla göre filtrelenmektedir.

Kullanıcı filtre üzerinden **2024** yılını seçtiğinde;

* KPI kartları yalnızca 2024 yılına ait değerleri gösterir.
* Harita üzerinde 2024 yılına ait satış ve kâr verileri görüntülenir.
* Satış dağılımı grafikleri seçilen yıl verilerine göre güncellenir.
* Filtre ile ilişkilendirilmiş tüm görseller eş zamanlı olarak yenilenir.

Bu sayede kullanıcı, tek bir filtre kullanarak dashboard üzerindeki tüm analizleri seçilen yıl bazında inceleyebilir.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://learn.vispeahen.com/kumanda-tablosu/plugin-listesi/filtreler/filter-filtre.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.