Dictionaries (Multilingual)

Dictionaries (Multilingual) Nedir?

Dictionaries (Multilingual), AGS etkin bir vService'in erişim sayfalarında kullanılacak dilleri ve bu dillerdeki çeviri metinlerini tutan profillerdir. Sözlükte önce desteklenen diller seçilir (ilk dil varsayılan dildir), ardından her Translation Key için desteklenen dillerin her birinde bir değer girilir.

Sözlük tek başına bir metni sayfaya getirmez; metnin nerede gösterileceği Page Templates ve Login Forms ekranlarında belirlenir. Bu ekranlardaki metin alanlarında tür olarak Dictionary seçilip sözlükteki Translation Key ile birebir aynı anahtar yazıldığında, metin vService'e seçilmiş sözlükten kullanıcının diline göre gelir.

Sözlük, vService'in AGS ayarlarındaki Dictionary alanından seçilir; her vService tek bir sözlük kullanır. TR7 ile birlikte iki hazır sözlük gelir (Default Dictionary: kataloğun tüm dilleri, English Only: yalnızca İngilizce); ikisi de çeviri satırı içermez, erişim sayfalarının standart metinleri (giriş, parola, gönder, iptal…) TR7'nin on dillik yerleşik kataloğundan gelir. Hazır sözlükler bu ekranın listesinde görünmez, vService ayarlarındaki seçicide doğrudan seçilir.

10

Dil Kataloğu

English, Türkçe, Español, Deutsch, Русский, Français, Português, 中文, 日本語, العربية

Anahtar × Dil

Çeviri Tablosu

Her anahtar için desteklenen dillerin her birinde smart değişken destekli değer

Dictionary

Metin Türü

Page Templates ve Login Forms metinleri anahtarla sözlüğe bağlanır

2

Hazır Sözlük

Default Dictionary · English Only (listede görünmez, vService ayarında seçilir)

Nasıl çalışır?

1. Sözlük bu ekranda tanımlanır: Supported Languages listesine diller eklenir (ilk dil varsayılan dildir), Translations bölümüne Translation Key eklenip her dil için değer girilir.
2. Page Templates ya da Login Forms ekranında ilgili metin alanının türü Dictionary seçilir ve aynı anahtar yazılır.
3. vService'in AGS ayarlarında Dictionary alanından sözlük, Page Template alanından şablon seçilir.
4. Erişim sayfası açıldığında anahtar vService'in sözlüğünde aranır ve kullanıcının diline ait değer gösterilir.

Hazır Sözlükler

Sözlük	Supported Languages	Translations
Default Dictionary (vService varsayılanı)	Kataloğun on dili	Yok (yerleşik metinler kullanılır)
English Only	English	Yok

Hazır sözlükler listede yer almadığından bu ekrandan düzenlenmez ve silinmez.

Operasyonel En İyi Uygulamalar

• Anahtar birebir aynı. Page Templates ve Login Forms'ta yazılan anahtar, sözlükteki Translation Key ile harfi harfine aynı olmalıdır; farklı yazılan anahtar sözlükte bulunmaz.
• Şablon ve sözlük aynı vService'te. Anahtar, vService'e seçilmiş sözlükte aranır; şablonun kullandığı anahtarlar o vService'in Dictionary alanındaki sözlükte tanımlı olmalıdır.
• Katalog dışı dil yok. Desteklenen diller on dillik katalogla sınırlıdır; katalog dışı bir dil kodu içeren kayıt bu ekranda açıldığında o dil ve çevirileri formdan düşer, kaydedildiğinde kaybolur.
• İlk dil varsayılan. Dil kartları sürüklenerek sıralanır; ilk sıradaki dil (Default) olarak işaretlenir ve kullanıcının dili eşleşmediğinde bu dilin kullanılması beklenir.
• Anahtar adlandırma. Anahtarlar harfle başlamalı, harf, rakam ve alt çizgi içermelidir (ör. footerCopyright).
• Her dil için değer. Bir anahtar eklendiğinde desteklenen her dil için boş satır açılır; boş bırakılan değerler o dilde boş metin olarak gider.
• Dil çıkarmadan önce yedek. Bir dil listeden çıkarıldığında o dile ait tüm çeviri satırları formdan silinir.
• Silmeden önce vService'ler. Silme onayı kullanım yerlerini göstermez; sözlüğü kullanan vService'ler önizlemedeki Used in sekmesinden kontrol edilmelidir.

Nasıl Eklenir?

Yeni bir Dictionaries (Multilingual) profili, TR7 web yönetim arayüzü üzerinden aşağıdaki adımlarla eklenir:

1. Sol altta bulunan TR7 logosuna tıklanarak Configuration Menu açılır.
2. AGS → Pages & Language → Dictionaries (Multilingual) → Add adımları takip edilir.
3. Profil için benzersiz ve açıklayıcı bir isim girilir.
4. Supported Languages listesine diller eklenir; Translations bölümünde anahtarlar ve her dil için değerler girilir.
5. Add butonuna tıklanarak profil eklenir.

TIP

Hızlı arama ile sayfaya ulaşma

Menüde adım adım gezmek yerine, ekranın sol alt köşesindeki arama çubuğu kullanılarak ilgili sayfaya doğrudan ulaşılır. Arama çubuğu Windows'ta Alt + T, macOS'ta Opt + T kısayolu ile açılır; ardından aranan özelliğin adının yazılması yeterlidir.

Oluşturulan profil, bir veya birden fazla AGS etkin vService'in Dictionary alanında kullanılır. Profil, bu alanın yanındaki ekleme simgesiyle vService ayarlarından ayrılmadan da tanımlanır; oluşturulan profil alanda seçili gelir.

Dictionaries (Multilingual) Listeleme Ekranı

AGS → Pages & Language → Dictionaries (Multilingual) yolu izlenerek TR7 cihazı üzerinde ekli olan tüm Dictionaries (Multilingual) profillerinin listesine ulaşılır. Bu ekran üzerinden profil ekleme, düzenleme ve silme işlemleri yapılır. Hazır sözlükler listelenmez.

Dictionaries (Multilingual) Profillerini Listeleme Formu

Tablo varsayılan olarak şu kolonlarla açılır:

Kolon	Açıklama
Dictionary Name	Profilin adı.
Supported Languages	Desteklenen dillerin kodları, büyük harfle ve sırasıyla (ör. EN, TR); ilk kod varsayılan dildir. Kolon başlığına tıklandığında sıralama dil sayısına göre yapılır.

Varsayılan olarak gizlenen kolon bulunmaz. Tablo açılışta sıralanmamıştır; kolon başlığına tıklandığında önce azalan, sonra artan sıralama uygulanır, üçüncü tıklamada sıralama kalkar.

Araç çubuğundaki öğeler soldan sağa aşağıdaki sırayla yer alır; son iki öğe (Page Information ve Page Size) tablonun altındaki bilgi şeridinde bulunur.

Columns

Tabloda hangi kolonların gösterileceği seçilir; iki kolonun ikisi de açık gelir. Aynı panelde kolonlar sürüklenerek yeniden sıralanır ve kolon başına hizalama seçilir; Fit rows to the page butonuyla satır yüksekliği sayfaya sığdırılır, Reset butonuyla kolon düzeni varsayılana alınır. Elle genişletilmiş bir kolonun yanındaki genişlik rozetine tıklandığında kolon otomatik genişliğe döner.

Filter

Filter butonu, listede gösterilen profilleri belirli kriterlere göre süzmek için kullanılır. Filtre şeridinde tek kart bulunur; kart adının yanındaki sayı, listedeki profillerde o kart için bulunan farklı değer sayısını gösterir:

Kart	Süzdüğü
Used in	Profilleri kullanan vService'ler ve hiçbir yerde kullanılmayan profilleri listeleyen Unused Entries değeri.

Export

Export butonuna tıklanarak tablo Excel, CSV veya PDF olarak dışa aktarılır. Açılan pencerede Filename, Format ve Data Source ile dışa aktarılacak Columns belirlenir; kalan alanlar biçime göre görüntülenir: CSV'de CSV Separator, Excel'de Excel Sheet Name, PDF'te Page Orientation ve Page Size.

Add

Add butonuna tıklanarak yeni bir profil oluşturma formu Add sekmesinde açılır.

Edit

Edit butonuna tıklanarak seçili profilin düzenleme formu Edit sekmesinde açılır. Buton yalnızca tek bir profil seçildiğinde etkinleşir.

Düzenleme formu ekleme formuyla aynıdır; ad dâhil bütün alanlar değiştirilir ve formun altındaki buton Edit adını taşır. Değişiklik onay istemeden kaydedilir ve profili kullanan vService'lerin yapılandırması yeniden uygulanır.

Delete

Bir veya birden fazla profil seçilip Delete butonuna tıklandığında ilgili profiller silinir. Silmeden önce "Are you sure?" onayı istenir.

WARNING

Kullanımda olan bir profil de silinebilir ve onay penceresi kullanım yerlerini göstermez.

Profili kullanan vService'lerde Dictionary atfı kendiliğinden temizlenmez; sözlük bulunamadığından bu vService'lerin sayfalarına çeviri işlenmez. vService'in AGS ayarları yeniden açıldığında geçersiz seçim Default Dictionary'ye döner ve kaydedildiğinde bu değer yazılır. Silme işlemi kullanıcı işlem kaydına yazılır.

Search

Tablodaki tüm bilgilerde arama yapmak için kullanılır.

RegExp Search

Tabloda bulunan tüm bilgilerde düzenli ifade (RegExp) ile arama yapmak için kullanılır. Kolon bazlı arama ya da kullanım filtresi etkinken bu buton gizlenir.

Column Based Search

Tabloda bulunan bilgilerde kolon bazlı arama yapmak için kullanılır.

Usage Filter

Profillerin hangi vService'lere bağlı olduğunu filtrelemek için kullanılır. Filtre etkinken arama kutusunun yerini seçici alır; simgeye yeniden tıklandığında arama kutusu geri döner.

Page Information

Tanımlı toplam profil sayısı ile listede görüntülenen profil sayısına ait bilgiler yer alır: Showing N-M of T records ve seçili profil sayısı (N selected, seçim yokken Nothing selected).

Page Size

Sayfada görüntülenecek maksimum profil sayısı seçilir. Bu ekranda varsayılan 100; seçenekler 5, 10, 20, 50, 100, 200, 500 ve All.

Sağ Tık Menüsü

Bir satıra sağ tıklandığında, başlığında profilin adı bulunan bir menü açılır. Menüdeki iki işlem de yalnızca sağ tıklanan profile uygulanır; listede yapılmış seçim menüyü etkilemez.

İşlem	Ne yapar
Edit	Profilin düzenleme formunu Edit sekmesinde açar; araç çubuğundaki Edit butonunun açtığı formun aynısıdır.
Delete	Sağ tıklanan profili siler; araç çubuğundaki silme ile aynı onay sorusu görüntülenir.

Seçilen Profilin Önizlemesi

Listede bir satıra tıklandığında ekranın sağında profilin önizlemesi açılır; seçili satıra yeniden tıklandığında panel kapanır. Başlıkta dil simgesi, profilin adı ve Dictionary alt başlığı, sağ üstte ise tek işlem bulunur.

Seçilen Profilin Önizlemesi

İşlem	Ne yapar
Edit	Profilin düzenleme formunu Edit sekmesinde açar.

Panelde üç sekme bulunur; Used in yalnızca profil en az bir vService'te kullanılıyorsa görüntülenir:

Details

Profilin ayarlarını satır satır listeler (aşağıdaki tablo).

Log

Profil üzerindeki kullanıcı işlemlerini (ekleme, düzenleme, silme) zaman çizelgesi olarak listeler.

Used in

Profili kullanan vService'leri listeler. Sekme adının yanındaki rozet kullanım sayısını gösterir.

Details sekmesindeki satırlar sırasıyla aşağıdaki gibidir:

Satır	Açıklama	Görünme koşulu
Dictionary Name	Profilin adı.	Her zaman
Supported Languages	Dil kodları büyük harfle, virgülle (ör. EN, TR).	Her zaman
Translations	Çeviri satırı sayısı (anahtar × dil).	En az bir satır varsa

Profil Ekleme Formu

AGS → Pages & Language → Dictionaries (Multilingual) → Add adımları takip edilerek TR7 cihazı üzerine yeni bir Dictionaries (Multilingual) profili eklenir.

Dictionaries (Multilingual) Profili Ekleme Formu

INFO

Dictionary Name Zorunlu

Profilin adı; vService ayarlarındaki seçimde ve loglarda profili tanımlar. Ad cihazda benzersiz olmalıdır; aynı adla ikinci bir profil kaydedilmez ve Name is used uyarısı görüntülenir. Boş bırakıldığında Required field uyarısı görüntülenir.

INFO

Supported Languages Varsayılan: English

Desteklenen dillerin kart listesi; kartlar üç kolonlu bir ızgarada görüntülenir ve sürüklenerek sıralanır. Her kart dil adını ve bayrağını gösterir; ilk kart (Default) ekiyle varsayılan dildir. Liste boş bırakılamaz.

Kartın sağındaki menüde üç işlem bulunur:

İşlem	Anlamı
Change Language	Açılan dil seçici penceresiyle kartın dili değiştirilir; o dile ait çeviri satırları yeni dile taşınır.
Delete Language	Onay alınarak dil listeden kaldırılır; o dile ait çeviri satırları da silinir. Tek dil kaldığında pasiftir.
Add Language	Change Language başlıklı pencerede dil seçilir ve kart listenin sonuna eklenir; kullanılmayan ilk dil ön seçili gelir. On dilin tamamı kullanıldığında pasiftir.

Seçilebilen diller: English, Türkçe, Español, Deutsch, Русский, Français, Português, 中文, 日本語 ve العربية.

INFO

Translations

Çeviri anahtarlarının listesi. Yeni anahtar, Translations etiketinin yanındaki + simgesiyle (Add translation key) eklenir; açılan pencerede anahtar adı girilir ve desteklenen her dil için boş bir değer satırı oluşturulur.

Translation Key

Anahtarın adı; harfle başlar, harf, rakam ve alt çizgi içerir. Bu kurala uymayan ya da sözlükte zaten bulunan bir ad girildiğinde uyarı görüntülenir ve işlem geri alınır. Page Templates ve Login Forms'ta Dictionary türüyle yazılan anahtar bu adla eşleşir. Blok başlığında Translation key: anahtar biçiminde görüntülenir; menüdeki Edit ya da başlığa çift tıklama ile yerinde yeniden adlandırılır (Enter ya da alandan çıkış onaylar, Esc vazgeçer). Menüdeki Delete anahtarı tüm dilleriyle birlikte, onay alınarak siler.

Değer Satırları

Her desteklenen dil için bayraklı bir satır bulunur. Değer, smart değişken destekli metin kutusuna girilir; ƒx simgesiyle smart değişken eklenir ve değişken istek anında çözülür. Aynı anahtar-dil çifti formda iki kez kaydedilmez.

INFO

Add

Add butonuna tıklanarak profil eklenir; sekme kapanır ve profil listede görüntülenir.

Örnek Kullanım

Aşağıdaki örnekte erişim sayfalarının alt bilgisindeki telif metni on dilde gösterilir. Sözlükte footerCopyright anahtarı tanımlanmış, her dil için değer girilmiştir; değerlerdeki Year smart değişkeni sayfa açıldığında içinde bulunulan yıla dönüşür.

Örnek Kullanım: footerCopyright Anahtarı

Anahtarın sayfada görüntülenmesi için aşağıdaki adımlar izlenir:

1. Bu ekranda sözlük oluşturulur; Supported Languages listesine diller eklenir ve Translations bölümüne footerCopyright anahtarı ile her dilin değeri girilir.
2. Page Templates ekranında şablonun Footer Enabled anahtarı açılır (Footer Content alanı yalnızca bu anahtar açıkken görüntülenir), Footer Content alanında tür olarak Dictionary seçilir ve anahtar kutusuna footerCopyright yazılır. Anahtar, sözlükteki Translation Key ile birebir aynı olmalıdır.
3. vService'in AGS ayarlarında Dictionary alanından bu sözlük, Page Template alanından bu şablon seçilir.
4. Erişim sayfası açıldığında alt bilgide kullanıcının diline ait değer görüntülenir: Türkçe kullanan bir kullanıcı "© 2026 Ltd. Tüm hakları saklıdır." metnini, Almanca kullanan bir kullanıcı "© 2026 Ltd. Alle Rechte vorbehalten." metnini görür.

Anahtar eşleşmezse

Page Templates'te yazılan anahtar, vService'e seçilmiş sözlükte bulunmazsa metin sözlükten gelmez. Anahtarın yazımı ve vService'in Dictionary alanında doğru sözlüğün seçili olduğu kontrol edilmelidir.

Aynı yöntem Page Templates'teki Page Title ve Header Content alanlarında, Login Forms ekranındaki başlık, açıklama, etiket, yer tutucu, yardım, buton, bilgi metni ve ayırıcı metni ile seçenek metinlerinde de kullanılır.

Çalışma Mekanizması

INFO

• Metin türleri. Page Templates ve Login Forms'taki metin alanlarında dört tür bulunur: Static (sabit metin, smart değişken destekli), Dictionary (sözlük anahtarı), Default (TR7'nin yerleşik metni) ve No Text (metin gösterilmez). Dictionary seçildiğinde metin kutusunun yerini anahtar kutusu alır.
• Dağıtım. Sözlükler AGS etkin vService'lerin erişim motorlarına aktarılır; TR7'nin on dillik yerleşik kataloğu da ayrıca motora verilir. Değişiklik sonrasında yapılandırma yeniden uygulanır.
• Çeviri değerleri. Sözlük, vService'in erişim motoruna verilir. Smart değişken içeren çeviri değerleri ayrıca vService'in ortak kullanıcı sözlüğüne şablon olarak işlenir ve <AGS kök yolu>/gw-files/user_dictionary.js (varsayılan kök yol /ags-portal) üzerinden sunulur; değişkenler istek anında çözülür. Düz metin değerler şablona girmez, sözlüğün kendisiyle iletilir.
• Dil seçimi. Dil eşleme erişim motorunda yapılır; ilk sıradaki dil (Default) olarak işaretlenir ve kullanıcının diline uyan çeviri yoksa bu dilin, standart metinler için kataloğun ilgili dilinin kullanılması beklenir.
• Cluster. Profiller LB yapılandırmasıyla cihazlar arasında eşitlenir.
• Loglar. Ekleme, düzenleme ve silme User Logs ekranında dictionary nesnesi olarak izlenir.

Kapsam ve Sınırlar

INFO

• Yetki. AGS ekranları Load Balancer yetki alanına bağlıdır; yetkisi olmayan kullanıcıda sayfa yerine You don't have access to this page kartı görüntülenir.
• Ad benzersizdir. Aynı adı taşıyan ikinci bir profil kaydedilmez.
• Hazır sözlükler listelenmez, bu ekrandan düzenlenmez ve silinmez.
• On dil kataloğu. Katalog dışı dil kodları arayüzde desteklenmez.
• vService başına tek sözlük; anahtarlar yalnızca vService'e seçilmiş sözlükte aranır. vService ayarlarındaki Dictionary alanı boş bırakılamaz; yeni vService Default Dictionary ile gelir.
• Lisans. Ekran AGS lisansı gerektirir.
• İçe/dışa aktarma yoktur; çeviriler formda satır satır girilir.
• Silme referans denetimi yapmaz; kullanımdaki profil de silinir.

Kullanım Yerleri

Kullanım Yeri	Alan	Amaç
AGS etkin vService → AGS Management	Dictionary	vService erişim sayfalarının dilleri ve çevirileri; yeni vService'te Default Dictionary
Page Templates	Dictionary türü metinler (Page Title, Header Content, Footer Content)	Şablon metinlerinin anahtarla sözlükten gelmesi
Login Forms	Dictionary türü metinler (başlık, etiket, yer tutucu, yardım, buton)	Form metinlerinin anahtarla sözlükten gelmesi