Veri Şablonları¶

Emakin'deki veri şablonları, veri modellerini metin veya HTML gibi çeşitli çıktı biçimlerine dönüştürür. Bu şablonlar, form denetimleri ve e-posta şablonları dâhil olmak üzere farklı Emakin bileşenlerinde kullanılır. Şablonlar, çift küme parantezi içine yerleştirilmiş XPath sorgularını kullanır {{ ve }}.

Örneğin, veri modelinde "username" adlı bir alan bulunduğunu varsayalım. Basit bir şablon şöyle olur:

1

Hello {{ username }}!

"username" alanı "Madonna" içeriyorsa oluşturulan çıktı şöyle olur:

1

Hello Madonna!

Tüm XML değerleri doğası gereği dizeler olarak ele alınır; bu nedenle otomatik veri türü biçimlendirmesi yapılmaz. Sayıları veya tarihleri biçimlendirmek için açık tür dönüştürme ya da biçimlendirme işlevleri gerekir.

Kültür Desteği¶

Veri şablonları kültüre duyarlıdır ve biçimlendirmeyi belirtilen kültüre göre uyarlar. Kültür genellikle kullanıcı tercihlerinden alınır ancak açıkça da ayarlanabilir. Kültür belirtilmezse değişmez kültür kullanılır.

Komut Dizisinde Kültür Belirtme¶

Aşağıdaki JavaScript örneği, belirli bir kültür ('tr-TR' - Türkçe) kullanılarak biçimlendirme yapılmasını gösterir:

1
2
3
4
5

var myNode = $Xml.Parse("<Customer><Name>John</Name><BirthDate>2014-01-31T09:00:00+02:00</BirthDate></Customer");
var result = myNode.Format('<p>{{Customer/BirthDate}}</p>', {
    Culture: 'tr-TR'
});
// result : <p>31.1.2014 09:00:00 +02:00</p>

Veri Türü Biçimlendirmesi¶

Metin Biçimlendirme¶

Metin veya dize değerleri, örtük bir biçimlendirme olmadan oluşturulur.

Sayı Biçimlendirme¶

"Sum" ve "Count" gibi işlevler sayıları doğrudan döndürürken, number() gerekirse açık tür dönüştürmesi için işlevi kullanılabilir. Sayı değerleri varsayılan olarak ondalık kurallara göre biçimlendirilir.

Örnekler:

Tarih Biçimlendirme¶

Şablon sistemi, "YYYY-MM-DDTHH:MM:SSTZ" biçiminde biçimlendirilmiş XML tarih türlerini otomatik olarak tanır. Emakin, veri modelindeki tarih değerleri için bu biçimi tutarlı şekilde kullanır. Diğer biçimlerdeki tarihler dizge olarak değerlendirilir.

Örnekler ( MyDate içerdiği varsayılarak: 2014-01-31T09:00:00+02:00):

Komut dizisi örneği¶

1
2
3
4

var myNode = $Xml.Parse("<Customer><Name>John</Name><BirthDate>2014-01-31T09:00:00+02:00</BirthDate></Customer");
var result = myNode.Format('<p>Birth date : {{Customer/BirthDate}}</p>');

// result : <p>Birth date : 01/31/2014 09:00:00 +02:00</p>

Komut dizisi örneği¶

Tarih düğümünden saati kaldırmanın bir yolu:

1
2
3
4

$Xml.SetValue('Test/testdate', new DateTimeOffset());  // testdate will be saved to an XML as "2015-11-12T15:27:16.2568549+02:00"
$Xml.SetValue('Test/testdate2', $Xml.Format("{{ format(Test/testdate,'yyyy-MM-dd') }}"));  // testdate2 will be saved to an XML as "2015-12-11"

// result : 2015-12-11

format() İşlev Seçenekleri¶

format() İşlev, çıktıyı özelleştirmek için çeşitli seçenekler sunar. Ayrıntılar için aşağıdaki tabloya bakın. Kullanılabilir seçeneklerin ve davranışlarının veri türüne bağlı olarak değişebileceğini unutmayın.

Koşullu Biçimlendirme¶

Koşullu görüntüleme aşağıdaki söz dizimi kullanılarak gerçekleştirilir:

1
2

if XPathCondition then Template
if XPathCondition then Template else Template

Örnek:

Temel kullanım

1

{{ if Customer/Type = 'A' then <div>Important !</div> }}>

else yan tümcesiyle temel kullanım

1

{{ if Customer/Type = 'A' then <div>Important !</div> else <div>{{Customer/Name}}</div> }}>

Tekrarlayan Şablonlar¶

Bir şablonu birden fazla düğüme uygulamak için şu söz dizimini kullanın:

1

ItemXPath => Template

Bu, eşleşen her öğe üzerinde yineleme yapar ItemXPath ve şablonu uygular.

Örnek:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

{{ SAMPLE REPORT
<h1>{{Customer/Name}}</h1>
<table>
    {{ Rows/Row =>
    <tr>
        <td>{{Date}}</td>
        <td>{{Description}}</td>
    </tr>
    }}
</table> }}

Aşağıdaki çıktıyı oluşturur:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

SAMPLE REPORT
<h1>John</h1>
<table>
    <tr>
        <td>2010-01-01</td>
        <td>description</td>
    </tr>
    <tr>
        <td>2015-01-01</td>
        <td>other description</td>
    </tr>
</table>

Öznitelikle Yineleme¶

x-repeat özniteliği, şablonları yinelemeye yönelik söz dizimine alternatif sunar; özellikle, söz diziminin etiketleri bozabileceği HTML üretiminde kullanışlıdır. Örneğin: => =>

1
2
3
4
5
6
7

{{ SAMPLE REPORT
<table>
    <tr x-repeat="Rows/Row">
        <td>{{Date}}</td>
        <td>{{Description}}</td>
    </tr>
</table> }}

Bu öznitelik herhangi bir öğeyle kullanılabilir. Örneğin, "li" etiketiyle de kullanılabilir.

1
2
3
4
5
6

{{
<ul>
    <li x-repeat="Rows/Row">
        <span>{{Date}}</span>
    </li>
</ul> }}

Özyinelemeli Tekrarlayan Şablonlar¶

Özyinelemeli yineleme için şu söz dizimini kullanın:

1

ItemXPath =>> Template

Şablon, her yinelemenin sonuçlarına özyinelemeli olarak uygulanır.

Örnek:

1
2
3
4
5

{{ <h1>SAMPLE REPORT</h1>
{{ Sections/Section =>>
<h2>{{Name}}</h2>
<p>{{Body}}</p>  }}
}}

sonuç:

1
2
3
4
5

<h1>SAMPLE REPORT</h1>
<h2>My Section</h2>
<p>Section content</p>
<h2>Sub Section</h2>
<p>Child section content</p>

Şablon Değişkenleri¶

Şablonlarda hem özel süreç değişkenleri hem de sistem özellikleri kullanılabilir. İstemci tarafı ve sunucu tarafı komut dizilerinin değişken bağlamları farklıdır.

İstemci Tarafı Şablon Değişkenleri¶

İstemci tarafı komut dizilerinde (ör. form komut dizilerinde) kullanılabilir:

Sunucu Tarafı Şablon Değişkenleri¶

Sunucu tarafı komut dizilerinde (ör., pre/post-work komut dizilerinde) kullanılabilir:

Belirli Şablon Değişkeni Bağlamları¶

Aktivite Bildirimleri: Sunucu tarafı değişkenlere ek olarak aktivite bildirimlerinde şunlar kullanılır:

Kullanıcı Kaydı: Sunucu tarafı değişkenlere ek olarak kullanıcı kaydı şablonlarında şunlar kullanılır:

İlgili Sayfalar¶

• Formlar
• Havuz Şablonları
• Aksiyonlar
• Görevler