Declare

Declare deyimi, alanlar veya fonksiyonlar arasındaki ilişkileri tanımlayabileceğiniz alan ve grup 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

Syntax:

definition_name:

Declare [Field[s]] Definition [Tagged tag_list ]

[Parameters parameter_list ]

Fields field_list 

Arguments:

Bağımsız Değişken Açıklama
definition_name

İki nokta üst üste ile biten alan tanımının adı.

Warning: Alan tanımlarının adı olarak autoCalendar'ı kullanmayın; çünkü bu ad, otomatik olarak oluşturulan takvim şablonları için ayrılmıştır.

Example:  

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.

Example:  

'$date'

Alan etiketleri

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ı.

Example:  

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.

Example:  

Year($1) As Year tagged '$year'

Example:

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 (tam örnek)

Mevcut alan tanımını yeniden kullanma

Syntax:

<definition name>:

Declare [Field][s] Definition

Using <existing_definition> 

[With <parameter_assignment> ]

Arguments:

Bağımsız Değişken Açıklama
definition_name

İki nokta üst üste ile biten alan tanımının adı.

Example:  

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.

Example:  

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ı.

Example:  

first_month_of_year = 4

Example:

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.

See also: