# Declare

Declare deyimi, alanlar veya fonksiyonlar arasındaki ilişkileri tanımlayabileceğiniz alan tanımları oluşturmak için kullanılır. Boyut olarak kullanılabilecek türetilmiş alanları otomatik olarak oluşturmak için bir alan tanımları kümesi kullanabilir. Örneğin, bir takvim tanımı oluşturabilir ve bunu kullanarak bir tarih alanından yıl, ay, hafta ve gün gibi ilgili boyutları oluşturabilirsiniz.

Yeni bir alan tanımı ayarlamak veya mevcut bir tanıma göre alan tanımı oluşturmak için Declare seçeneğini kullanabilirsiniz.

## Yeni bir alan tanımı ayarlama

Söz Dizimi:

definition\_name:

Declare [Field[s]] Definition [Tagged tag\_list ]

[Parameters parameter\_list ]

Fields field\_list

Bağımsız Değişkenler:

| Bağımsız Değişken | Açıklama |
| --- | --- |
| definition\_name | İki nokta üst üste ile biten alan tanımının adı.<br><br>Uyarı notuAlan tanımlarının adı olarak autoCalendar'ı kullanmayın; çünkü bu ad, otomatik olarak oluşturulan takvim şablonları için ayrılmıştır.<br><br>Örnek:<br><br>`Calendar:` |
| tag\_list | Alan tanımından türetilen alanlara uygulanacak etiketlerin virgülle ayrılmış listesi. Etiketlerin uygulanması isteğe bağlıdır ancak $date, $numeric veya $text gibi sıralama düzenini belirtmek için kullanılan etiketleri uygulamazsanız, türetilen alan varsayılan olarak yükleme düzenine göre sıralanacaktır.<br><br>Örnek:<br><br>`'$date'Thank you for bringing this to our attention, and apologies for the inconvenience.`<br><br>[Alan etiketleri](https://help.qlik.com/tr-TR/sense/May2026/Subsystems/Hub/Content/Sense_Hub/Scripting/field-tags.htm) |
| parameter\_list | Parametrelerin virgülle ayrılmış listesi. `name=value` biçiminde bir parametre tanımlanır ve alan tanımı yeniden kullanıldığında geçersiz kılınabilecek bir başlangıç değeri atanır. İsteğe bağlı.<br><br>Örnek:<br><br>`first_month_of_year = 1` |
| field\_list | Alanlar için alan tanımı kullanıldığında oluşturulacak virgülle ayrılmış bir liste. `<expression> As field_name tagged tag` biçiminde bir alan tanımlanır. Türetilen alanların oluşturulması gereken veri alanına referansta bulunmak için `$1` öğesini kullanın.<br><br>Örnek:<br><br>`Year($1) As Year tagged ('$numeric')` |

Örnek:

```
Calendar:
DECLARE FIELD DEFINITION TAGGED '$date'
   Parameters
      first_month_of_year = 1
   Fields      
```

```
      Year($1) As Year Tagged ('$numeric'),
      Month($1) as Month Tagged ('$numeric'),
      Date($1) as Date Tagged ('$date'),
      Week($1) as Week Tagged ('$numeric'),
      Weekday($1) as Weekday Tagged ('$numeric'),
      DayNumberOfYear($1, first_month_of_year) as DayNumberOfYear Tagged ('$numeric')
;
```

```
 
```

Takvim artık tanımlanmıştır ve bunu yüklenen tarih alanlarına uygulayabilirsiniz (bu durumda Derive cümlesini kullanan OrderDate ve ShippingDate).

[Türetilmiş alanlar](https://help.qlik.com/tr-TR/sense/May2026/Subsystems/Hub/Content/Sense_Hub/Scripting/derived-fields.htm) (tam örnek)

## Mevcut alan tanımını yeniden kullanma

Söz Dizimi:

&lt;definition name&gt;:

Declare [Field][s] Definition

Using &lt;existing\_definition&gt;

[With &lt;parameter\_assignment&gt; ]

Bağımsız Değişkenler:

| Bağımsız Değişken | Açıklama |
| --- | --- |
| definition\_name | İki nokta üst üste ile biten alan tanımının adı.<br><br>Örnek:<br><br>MyCalendar: |
| existing\_definition | Yeni alan tanımı oluşturulurken yeniden kullanılacak alan tanımı. Alan ifadelerinde kullanılan değeri değiştirmek için parameter\_assignment kullanmanız hariç olmak üzere, yeni alan tanımı temel aldığı tanımla aynı işlevi görecektir.<br><br>Örnek:<br><br>Using Calendar |
| parameter\_assignment | Parametre atamalarının virgülle ayrılmış listesi. name=value biçiminde bir parametre ataması tanımlanır ve temel alan tanımında ayarlanan parametre değerini geçersiz kılar. İsteğe bağlı.<br><br>Örnek:<br><br>first\_month\_of\_year = 4 |

Örnek:

Bu örnekte, önceki örnekte oluşturulan takvim tanımını yeniden kullanıyoruz. Bu durumda, Nisan ayında başlayan bir mali yıl kullanmak istiyoruz. Bu, 4 değeri first\_month\_of\_year parametresine atanarak elde edilir; bu durumda tanımlanan DayNumberOfYear alanı etkilenir.

Örnek, önceki örnekte bulunan örnek veri ve alan tanımını kullandığınızı varsayar.

MyCalendar: DECLARE FIELD DEFINITION USING Calendar WITH first\_month\_of\_year=4;

DERIVE FIELDS FROM FIELDS OrderDate,ShippingDate USING MyCalendar;

Veri kodunu yeniden yüklediğinizde, oluşturulan alanlar OrderDate.MyCalendar.\* ve ShippingDate.MyCalendar.\* adlarıyla sayfa düzenleyicisinde kullanılabilir.

## Daha fazla bilgi

* [Derive](https://help.qlik.com/tr-TR/sense/May2026/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/Derive.htm)