Tüm Quire Formül Operatörleri ve Fonksiyonları Permalink

Q: Quire formüllerinde hangi aritmetik operatörleri kullanabilirim?

Quire; toplama (+), çıkarma (-), çarpma (*), bölme (/), kalan (%) ve üs (^) işlemlerini destekler. Örneğin, `Cost * 100` ifadesi Cost alanını 100 ile çarpar. Bir formülde referans vermeden önce sayısal bir özel alan oluşturmanız gerekir.

Q: Quire'da IF/koşullu bir formülü nasıl yazarım?

`?:` operatörünü kullanın — `(Cost > 10) ? 'Too expensive' : 'Reconsider'` ifadesi Cost değeri 10'dan büyükse "Too expensive", aksi takdirde "Reconsider" döndürür. Yalnızca alan boş olduğunda bir yedek değer gerekiyorsa `??` kullanın — `(Cost > 10) ?? 'Reconsider'` yalnızca Cost'un değeri yoksa "Reconsider" gösterir.

Q: Quire formülünde alt görevleri bir alan değerine göre nasıl filtrelerim?

`where` operatörünü kullanın — `subtasks where any.Cost > 10` ifadesi yalnızca Cost alanı 10'u aşan alt görevleri döndürür. Sonuçları sınırlamak için `limit` ile birleştirin; örneğin `subtasks order by desc any.timeSpent - any.estimated limit 3` ifadesi bütçeyi en çok aşan ilk 3 alt görevi döndürür.

Q: Quire formülünde bir listeyi nasıl sıralarım veya yeniden düzenlerim?

Sıralamak için `order by` kullanın — `subtasks order by any.Cost` alt görevleri Cost alanına göre sıralar. Yönü kontrol etmek için `asc` veya `desc` ekleyin. Düz değerlerin daha basit bir sıralaması için `SORT()` kullanın; örneğin `SORT(subtasks.estimated)`.

Q: Quire'da bir listedeki her öğeye nasıl hesaplama uygularım?

`map` operatörünü kullanın — `subtasks map any.Cost * 2` her alt görevin Cost değerinin 2 ile çarpılmış halinden oluşan bir liste döndürür. `any` tanımlayıcısı hangi alanın hedefleneceğini belirtir.

Q: Quire formüllerinde operatör önceliği nasıl çalışır?

Quire formülleri belirli bir sırayla değerlendirir — önce parantezler ve nokta operatörleri, ardından üs alma, çarpma/bölme, toplama/çıkarma, karşılaştırma operatörleri, mantıksal operatörler ve son olarak koşullu operatörler. Varsayılan sırayı geçersiz kılmak gerektiğinde parantez kullanın.

Bu rehber, güçlü hesaplamalar, koşullar ve görev mantığı oluşturmanıza yardımcı olmak için açık açıklamalar ve pratik örneklerle birlikte Quire formüllerinde desteklenen tüm operatör ve fonksiyonlara yönelik eksiksiz bir başvuru kaynağı sunar.

Sayısal Operatörler

Sayısal operatörler, sayı tabanlı alanlarda saklanan değerleri hesaplamanıza olanak tanır.

Operatörler	Ne işe yarar	Örnek
+	Değerleri toplar	`timeSpent + 100`
-	Değerleri çıkarır	`Cost - 100`
*	Değerleri çarpar	`Cost * 100`
/	Değerleri böler	`Cost / 100`
%	Kalanı hesaplar	`Cost % 3`
^	Üs alır	`Cost ^ 3`

Not: Formüllerde kullanmadan önce sayısal bir özel alan (örneğin Cost) oluşturmanız gerekir.

Metin Operatörleri

Metin operatörleri, metin dizelerini tek bir çıktıda birleştirmenize veya art arda eklemenize olanak tanır.

Operatörler	Ne işe yarar	Örnek
+	Metinleri birleştirir	`‘This is’ + ‘a task’`

Karşılaştırma Operatörleri

Karşılaştırma operatörleri, iki değerin birbiriyle nasıl ilişkili olduğuna göre true veya false döndürür.

Operatörler	Anlamı	Örnek
<	Küçüktür	`3 < 1` -> False
>	Büyüktür	`4 > 3` -> True
<=	Küçük veya eşittir	`4 <= 2` -> False
>=	Büyük veya eşittir	`5 >= 1` -> True
=	Eşittir	`2 = 2` -> True
!=	Eşit değildir	`3 != 2` -> True

Mantıksal Operatörler

`not`

Bir doğru/yanlış sonucunu tersine çevirir.

Örnek:

Not (Cost > 50)

Cost 50’den büyükse sonuç false olur. Aksi takdirde true döner.

Not: Formüllerde kullanmadan önce sayısal bir özel alan (örneğin Cost) oluşturmanız gerekir.

`in`

Birinci listedeki değerlerin tamamen ikinci listede yer alıp almadığını kontrol etmek için in kullanın.

Örnek:

assignees in subtasks.assignees

Görevin tüm sorumluları aynı zamanda alt görevlerine de atanmışsa true döner.

`&`

İki liste arasındaki ortak değerleri bulup döndürür.

Örnek:

assignees & subtasks.assignees

Hem görev hem de alt görevleri tarafından paylaşılan sorumluları döndürür.

`and`

Tüm koşulları değerlendirir ve yalnızca her koşul karşılanırsa true döndürür.

Örnek:

(Cost > 50) and (due > <today>)

Not: Formüllerde kullanmadan önce sayısal bir özel alan (örneğin Cost) oluşturmanız gerekir.

`or`

Her koşulu kontrol eder ve herhangi bir koşulun değeri varsa true döndürür.

Örnek:

Cost or Budget

Not: Formüllerde kullanmadan önce sayısal bir özel alan (örneğin Cost) oluşturmanız gerekir.

Liste Operatörleri

`[field, field]`

Birden fazla değeri tek bir listede birleştirmek için köşeli parantez kullanın.

Örnek:

[me, #23.assignees, subtasks.assignees]

Beni, ID#23 numaralı göreve atanmış sorumluları ve alt görevlerin tüm sorumlularını içeren bir liste döndürür.

Bir veri kümesini listelemenize veya üzerinde hesaplama yapmanıza olanak tanıyan Quire’ın dizi formülleri hakkında daha fazla bilgi edinin.

`field[index]`

Liste öğelerine indekse göre (0’dan başlayarak) erişin.

Örnek:

subtasks[3]

4. alt görevi döndürür.

`order by`

Görevleri belirtilen bir alana göre sıralar.

Örnek:

subtasks order by any.Cost

Alt görevlerin bir listesini döndürür ve onları Cost alanlarının değerlerine göre sıralar.

Not: Formüllerde kullanmadan önce sayısal bir özel alan (örneğin Cost) oluşturmanız gerekir.

İpucu: İfadenin sonuna asc veya desc ekleyerek sıralama yönünü de belirtebilirsiniz. Örneğin şöyle bir şey yazabilirsiniz: subtasks order by any.Cost asc.

`map`

Bir listedeki her öğeye bir hesaplama uygular.

Örnek:

subtasks map any.Cost * 2

Alt görevlerin Cost alanındaki değerlerin bir listesini döndürür ve değerleri 2 ile çarpar.

Not: Formüllerde kullanmadan önce sayısal bir özel alan (örneğin Cost) oluşturmanız gerekir.

İpucu: Hesaplamak istediğiniz alanı belirtmek için any tanımlayıcısını map operatörüyle birlikte kullanabilirsiniz.

Koşullu Operatörler

`??`

Görevin ?? işaretinin önündeki ifadeye uyup uymadığını kontrol eder ve bir doğru/yanlış değeri döndürür. Görev ifadeye uymuyorsa ?? işaretinden sonraki ifadenin değerini döndürür.

Örnek:

(Cost > 10) ?? 'Reconsider'

Cost alanındaki değer 10’dan büyükse true olarak döner. 10’dan küçükse false olarak gösterilir. Cost alanına hiç değer girilmemişse “Reconsider” gösterilir.

Not: Formüllerde kullanmadan önce sayısal bir özel alan (örneğin Cost) oluşturmanız gerekir.

`?:`

Görevin ? işaretinin önündeki ifadeye uyup uymadığını kontrol eder ve ? işaretinden sonraki ifadeyi döndürür. Görev ? işaretinin önündeki ifadeye uymuyorsa : işaretinden sonraki ifadeyi döndürür.

Örnek:

(Cost > 10) ? 'Too expensive': 'Reconsider'

Cost alanındaki değer 10’dan büyükse “Too expensive” gösterilir. 10’dan küçükse veya hiç değer girilmemişse “Reconsider” gösterilir.

Not: Formüllerde kullanmadan önce sayısal bir özel alan (örneğin Cost) oluşturmanız gerekir.

Sonuçları Filtreleme ve Sınırlama

`where`

Belirli kriterlere uyan görevleri filtreler.

Örnek:

subtasks where any.Cost > 10

Maliyet değeri 10’dan büyük olan alt görevler listelenir.

Not: Formüllerde kullanmadan önce sayısal bir özel alan (örneğin Cost) oluşturmanız gerekir.

İpucu: Filtrelemek istediğiniz alanı belirtmek için any tanımlayıcısını where operatörüyle birlikte kullanabilirsiniz.

`limit`

Sıralamadan sonra döndürülen görev sayısını sınırlar.

Örnek:

subtasks order by desc any.timeSpent - any.estimated limit 3

Harcanan zaman değeri tahmini süre değerinden daha büyük olan ilk 3 alt görevi listeler.

Operatör Önceliği

Bazı durumlarda hesaplamanın sırası formülün döndürdüğü değeri etkileyebilir; bu nedenle Quire’daki işlemlerin sırasını anlamak önemlidir. Tek bir formülde farklı operatörleri bir araya getirirseniz Quire, işlemi aşağıdaki tabloda gösterilen sırayla gerçekleştirir. Formülde aynı sıraya sahip operatörler varsa Quire soldan sağa doğru hesaplama yapar.

Operatör	Açıklama
`( )` `.` `[ ]` `( )`	Parantezler Nokta operatörü Liste (Dizi) Fonksiyon çağrısı
`+` `-` `not`	Tekli operatörler
`^`	Üs alma
`*` `/` `%`	Çarpma ve bölme
`+` `-`	Toplama ve çıkarma
`<` `>` `<=` `>=` `in` `&`	Karşılaştırma operatörleri
`=` `!=`	Eşitlik operatörleri
`not`	Mantıksal `not` operatörü
`and`	Mantıksal `and` operatörü
`or`	Mantıksal `or` operatörü
`??`	Koşullu operatör
`where`	Filtre operatörü
`?:`	Koşullu operatör

All Built-in Functions

Fonksiyon	Açıklama	Örnek	Beklenen sonuçlar
SUM()	Değerlerin toplamını döndürür.	`SUM(subtasks.estimated)`	Görevin alt görevlerinin Estimate alanlarındaki tüm değerleri toplar.
MAX()	Bir değer kümesindeki en büyük değeri döndürür.	`MAX(subtasks.estimated)`	Görevin alt görevlerinin Estimate alanlarında bulunabilecek en büyük değeri gösterir.
MIN()	Bir değer kümesindeki en küçük değeri döndürür.	`MIN(subtasks.estimated)`	Görevin alt görevlerinin Estimate alanlarında bulunabilecek en küçük değeri gösterir.
AVG()	Sayıların ortalama değerini döndürür.	`AVG(subtasks.estimated)`	Görevin alt görevlerinin Estimate alanlarının ortalamasını hesaplar.
COUNT()	Öğelerin sayısını döndürür.	`COUNT(subtasks)`	Toplam alt görev sayısını gösterir.
SORT()	Argümanların sıralanmış halini döndürür.	`SORT(subtasks.estimated)`	Görevin alt görevlerinin Estimate alanlarındaki tüm değerleri sıralanmış olarak gösterir.
DISTINCT()	Yinelenen değerleri kaldırır ve yalnızca benzersiz değerleri döndürür.	`DISTINCT(subtasks.estimated)`	Görevin alt görevlerinin Estimate alanlarındaki tüm benzersiz değerleri gösterir ve yinelenen değerleri kaldırır.
ISEMPTY()	Girdi argümanlarının boş olup olmadığını kontrol eder ve bir doğru/yanlış değeri döndürür.	`ISEMPTY(estimated)`	Görevin Estimate alanı boşsa işaretli bir onay kutusu gösterir.
ISNOTEMPTY()	Girdi argümanlarının boş olup olmadığını kontrol eder ve bir doğru/yanlış değeri döndürür.	`ISNOTEMPTY(estimated)`	Görevin Estimate alanı boş değilse işaretli bir onay kutusu gösterir.

Sıkça Sorulan Sorular

Quire formüllerinde hangi aritmetik operatörleri kullanabilirim?

Quire; +, -, *, /, % (kalan) ve ^ (üs) işlemlerini destekler. Bir formülde referans vermeden önce sayısal bir özel alan oluşturmanız gerekir.

Quire formüllerinde hangi yerleşik fonksiyonlar mevcuttur?

Quire; SUM(), MAX(), MIN(), AVG(), COUNT(), SORT(), DISTINCT(), ISEMPTY() ve ISNOTEMPTY() fonksiyonlarını içerir. Eksiksiz referansa Tüm Yerleşik Fonksiyonlar bölümünden ulaşabilirsiniz.

Quire formüllerinde operatör önceliği nasıl çalışır?

Quire, operatörleri şu sırayla değerlendirir: önce parantezler ve nokta/liste operatörleri, ardından üs alma, çarpma/bölme, toplama/çıkarma, karşılaştırma, mantıksal ve son olarak koşullu operatörler. Varsayılan sırayı geçersiz kılmak için parantez kullanın.

Quire’da IF/koşullu bir formülü nasıl yazarım?

İki sonuçlu bir koşul için ?: kullanın — (Cost > 10) ? 'Too expensive' : 'Reconsider'. Yalnızca alan boş olduğunda yedek değer olarak ?? kullanın.

Quire formülünde alt görevleri bir alan değerine göre nasıl filtrelerim?

where operatörünü kullanın — subtasks where any.Cost > 10 ifadesi Cost’un 10’u aştığı alt görevleri döndürür. Sonuç sayısını sınırlamak için limit ile birleştirin.

Quire formülünde bir listeyi nasıl sıralarım veya yeniden düzenlerim?

order by kullanın — subtasks order by any.Cost Cost alanına göre sıralar. Yönü kontrol etmek için asc veya desc ekleyin.

Quire’da bir listedeki her öğeye nasıl hesaplama uygularım?

map operatörünü kullanın — subtasks map any.Cost * 2 her alt görevin Cost değerini 2 ile çarpar.

Daha fazla yardıma ihtiyacınız olursa lütfen bizimle iletişime geçin.