> For the complete documentation index, see [llms.txt](https://docs.geodin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.geodin.com/geodin-desktop/tr/gorsellestirme-yerlesim-planlari-ve-raporlama/report-templates/text-macros-in-reports.md). # Raporlarda Başlık ayarlama Metin makroları, canlı Veritabanı Değerler'ini Raporlar içine aktarmaya yönelik GeoDin mekanizmasıdır. Başlıklar, Altbaşlıklar, Değişken metin öğeleri, rapor Sütun başlıkları ve Sondaj logu öğelerinin içindeki etiketlerde görünürler. Bu Sayfa, Makro söz dizimini ve Rapor et Şablonlar oluştururken ortaya çıkan pratik kalıpları ele alır. Daha geniş Şablon yapısı (Yerleşim planları, parçacıklar, Rapor et öğeleri) için bkz. [Rapor et Şablonlar](/geodin-desktop/tr/gorsellestirme-yerlesim-planlari-ve-raporlama/report-templates.md). Sondaj loguna özgü Yerleşim planları ve Enkesit Yerleşim planları için bkz. [Sondaj logu Raporlar](/geodin-desktop/tr/gorsellestirme-yerlesim-planlari-ve-raporlama/report-templates/borehole-log-reports.md) ve [Enkesit Raporları](/geodin-desktop/tr/gorsellestirme-yerlesim-planlari-ve-raporlama/report-templates/cross-section-reports.md). ## Statik Metin ve dinamik makrolar * **Statik Metin** - bir şablonun herhangi bir yerine yerleştirilir; aynı Metin her çıktıda yazdırılır. * **Dinamik makrolar** - bir Nesne çerçevesi içine yerleştirilir, bir GeoDin Parametre başvurur ve oluşturma sırasında çözümlenir. Örneğin, `Yer_Ad` Makro, Mevcut Sondaj Adı'nı dinamik olarak çeker. ## Makro sözdizimi Makro'lar ile sınırlandırılır `$` İkisi birden üzerinde: * `$LONGNAME$` uzun Yer Ad * `$%PRNPAGE$` - Sayfa yazdırma sayısı * `$ZCOORDE$` - Z koordinatı (yükseklik) Makrolar, herhangi bir Tablo'daki Parametreler'i referans alabilir - Genel veriler, Örnek Tablolar, ölçüm tabloları ve Veri dizileri. ### Birleştirme Birden çok Parametreler tek bir dizeye birleştirilebilir. Örnek: ``` Örnek $sample_reference$ nüfuz etme Şuradan $depth_from$ şuraya $depth_to$ metre ``` ### Koşullu Ayırıcılar Köşeli parantezler `[ ]` bir Makro içinde koşullu Ayırıcılar gibi davranır: köşeli parantez içindeki İçerik, yalnızca içindeki Makro bir Değer’e sahipse oluşturulur. Bu, alanlar Boş olduğunda gereksiz virgülleri ve sahipsiz noktalama işaretlerini önler. ### Hesaplanmış parametreler Derle iletişim kutusu, Hesaplanmış parametreler dahil edebilir - örneğin, üst ve taban derinliklerinden türetilen tabaka Kalınlık değeri - ham Veritabanı alanlarıyla birlikte. ## Görüntüleme seçenekleri Bir Metin-Makro Öğe yapılandırırken şunları seçebilirsiniz: * **Derinlik Göster** - başvurulan Satır ait Derinlik Değerini dahil et. * **Katman verisi Göster** - Makro ile birlikte tabaka Öznitelikler dahil et. * **Yönelim** - Sayfa üzerinde metin yönelimi. Bu **Kodlama / norm / Kullanıcı** Ayar, hangi Açıklayıcı Kaynak'ın Makro'yu beslediğini denetler. G1 için bunlar çoğunlukla eşdeğerdir; söz konusu **Kullanıcı** seçenek, makrolarla karışık keyfi düz metne izin verir. Özellikle G1 Zemin açıklaması için, betimleyici İçeriklerin çoğu tek bir `jeolojik Tasvir` Makro - diğer Nesne tiplerinin aksine, Tasvir'i ayrı petrografi ve renk makrolarına böler. ## Çeviri desteği Tek bir Düzen birden çok tercüme barındırabilir. Dosya Dilini altında `Dosya > Dil` aynı şablonu farklı Diller içinde değişiklik yapmadan yazdırır. ## Makro Veri kaynağı sorgulama Metin makroları, doğrudan tablo alanlarının yanı sıra Sorgu sonuçlarından da çekebilir. Farklı testler arasında Tabloları birleştiren bir SQL sorgusu oluşturun - örneğin, "birim ağırlığı sıfır olmayan yerlerde yalnızca Su içeriğini Göster" - ve Sorgu sonucunu bir şablon Öğe için Veri kaynağı olarak kullanın. *** ## Referans: Biçimlendirme talimatları Alan adının yanında, bir Makro, Veri alan içeriğinin nasıl dönüştürüldüğünü ve görüntülendiğini denetleyen biçimlendirme talimatları taşıyabilir. Bu sayfa, bu referans için kanonik Başlangıç noktasıdır; Makro kullanan Düzen tarafındaki öğeler içinde açıklanmıştır [Metin Makroları ve Değişken metin](/geodin-desktop/tr/gorsellestirme-yerlesim-planlari-ve-raporlama/creating-custom-layouts/text-macros-and-variable-text.md). ### Sözdizimi ``` $[T1]VARNAME@F[T2]$ ``` | Bölüm | Anlam | | --------- | ---------------------------------------------------------------------------------- | | `T1` | Herhangi bir Metin. Yalnızca Veri alan içeriği Boş değil İse çıktı olarak verilir. | | `VARNAME` | Veri alanı Adı. | | `@` | Veri alanı adı ve biçim talimatları arasında ayraç. | | `F` | Biçimlendirme talimatları (aşağıya bakın). | | `T2` | Herhangi bir Metin. Yalnızca Veri alan içeriği Boş değil İse çıktı olarak verilir. | Her şey hariç `VARNAME` isteğe bağlıdır. Bu, altında açıklanan koşullu Ayırıcılar’ın arkasındaki mekanizmadır [Makro sözdizimi](#macro-syntax): köşeli parantezli önek ve sonek, Boş bir alanla birlikte kaybolur. **Örnek:** `Test: $[Derinlik yüzeyin altında ]DEPTH@8.2[m]$` Derinlik, Veri alanı şuradan oku `DERİNLİK` Maksimum 8 basamaklı bir sayı olarak, tam 2 Ondalık noktalar ile ve, İse alan İçerik'i Boş değilse, başına "Yüzey altındaki Derinlik" ve sonuna "m" eklenmiş, içinde sarılmış halde: * İçerikle: `Test: Yüzey altı Derinlik 3,20m` * Boş bir Veri alanı ile: `Test:` Hepsi, Veri kümesine ait Veri alanları tek bir komut içinde başvurulabilir VE aynı alan birden fazla kez başvurulabilir: ``` Derinlik $DEPTH$m ile petroğrafi $PETRO$ (kodlu: $PETRO@C$) ``` Sonuç: `Derinlik 3,20 m olan petrografi ince kumdur (kod: fs)` Biçimlendirme yönergeleri birleştirilebilir VE sıraları önemli değildir: `$Data_field@.1+ds.$` uygulanır `8,23` verir `+8.2`. ### Sayısal alanlar | Talimat | Etki | Örnek | | ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------- | | `@.x` | Ondalık noktalar sayısı. Veritabanı içinde Parametre için tanımlanan ondalık noktalar sayısını geçersiz kılar. | `8.23` -> `$Data_field@.1$` -> `8.2` | | `@cutdec` | Önemsiz ondalık noktaları kaldırır. | `8,20` -> `8,2`; `3,000` -> `3` | | `@dsx` | Ondalık ayıracı ayarlar (standart, Windows bölgesel Ayarlar'dan gelir). | `8.23` -> `$Data_field@ds,$` -> `8,23` | | `@e` | Bilimsel gösterim. | `112.20` -> `1.122E+2` | | `@a` | Bir Derinliği, Sondaj Yüksekliğini kullanarak Mutlak Değer olarak yeniden hesaplar (`ZCOORDB`). Yalnızca Yükseklik bilgisi içeren alanlar için anlamlıdır. | `1.50` -> `8.50` ne zaman `ZCOORDB = 10.00` | | `@p` | Her zaman İçerik'i pozitif bir Değer olarak gösterir, Veritabanı'nda negatif olsa bile. | `-8.23` -> `8.23` | | `@+` | İçerik pozitif veya Sıfır olduğunda bir artı hane ekler. | `8.23` -> `+8.23` | | `@*Faktör` | İçerik bir Faktör ile çarpar. | `8.23` -> `$Veri alanı@*2$` -> `16.46` | | `@grd` | Ondalık dereceleri derece, Dakikalar, Saniyeler'e dönüştürür. | `123,456377` -> `123°27'22",9572` | | `@sigXX` | Çıktıyı XX Anlamlı sayılar'a (2 ile 15 arasında) sınırlar. | `1234,56` -> `$Veri alanı@sig4$` -> `1235,00` | | `@B(Faktör)` | Saptama limiti altındaki Değerler için (şu şekilde gösterilir: `<5`): şuradan kaldırır: `<` ve `-` sembolleri kaldırır ve Faktör ile çarpar, böylece sınırın bir kesri Hesaplamalar içinde kullanılabilir. | `<5` -> `$PARAM@B(0.5)$` -> `2,5` | Bilimsel gösterim olarak tanımlanan bir Veri alanı'na uygulanan herhangi bir biçim tanımı, onu Standart sayısal davranışına geri döndürür: `1,122E+2` -> `$Veri alanı@.2$` -> `112,20`. ### Karakter alanları Veri alanı'nın Sözlük'ü yoksa, biçim Bilgi'sinin etkisi olmaz. Bir Sözlük mevcutsa: | Talimat | Etki | | ------- | ------------------------------------------------------------------- | | `@T` | Veri alanı içeriği sözlük aracılığıyla yeniden çevrilir. | | `@C` | Veri alanı içeriği doğrudan kullanılır (kodlanmış biçim). | | `@R` | İçerik ilgili dolgu deseni ilişki Tablosu'nun anahtarına aktarılır. | | `@K` | Yalnızca tırnak içindeki Metin kullanılır. | Biçim yönergesi eksikse, bir Sözlük mevcut olduğunda İçerik yeniden çevrilir, mevcut olmadığında ise doğrudan kullanılır. İçerik için `fS,ms4,'Beton kalıntıları'`: ``` @T İnce kum, çok kumlu (orta), Beton kalıntıları @C fS, ms4, 'Beton kalıntıları' @R fS, ms, Beton kalıntıları @K Beton kalıntıları ``` İçin `@T` şuraya `@K`, Sonuç metni'nden kaldırılacak Ayırıcılar eklenebilir. İçerikten `sa,cl2`, `@R` verir `sa, cl'` iken `@R,-+` verir `sacl'` - veri girişi sırasında gerekli olan Ayırıcılar kaldırılır. Karakterler `,-+;():` bu şekilde hariç tutulabilir. Sayısal biçim yönergeleri, İçerik bir sayı olduğunda Karakter alanları'na ek olarak uygulanabilir. **Dize işlevleri** | Talimat | Etki | Örnek | | ------------------------------ | ----------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `@Kopyala(Başlat,End)` | Dizginin bir bölümünü çıktı olarak verir. | `$COMMENTARY@Kopyala(1,50)[...]$` alan İçerik içerdiğinde ilk 49 karakteri ve ardından üç noktayı çıktı olarak verir - uzun İç yazışma alanları için kullanışlıdır. | | `@PadLeft(Uzunluk,karakter)` | Dizeyi verilen karakterle belirtilen uzunluğa kadar uzatır. | `$ARNUM@PadLeft(4,0)$` dönüştürür `4` içine `0004`. | | `@Replace('şuradan','şuraya')` | Dizenin bir bölümünü değiştirir. | `$PRINSTYPE@Replace('SILT','silt')$` | | `@Replace('CHR13CHR10','...')` | Bir Çizgi sonunu değiştirir. | `$GEOLDESC@Replace('CHR13CHR10','')$` bir Tasviri tek bir Çizgi üzerinde birleştirir; `$GEOLDESC@Replace('CHR13CHR10',' ')$` her sonu bir Boşluk ile değiştirir. | ### Tarih alanları Tarihler Semboller ile biçimlendirilir `A`, `G` ve `Y`: ``` gg.aa.yyyy -> 01.03.1996 g aaaa yyyy -> 1 Mart 1996 ``` ### Birimler Parametre birimleri, birim karakterleri olarak yazdırıldı (`~US`) veya birim Metin olarak (`~UL`): ``` $S3STAMM.ZCOORDE~US$ -> m $S3STAMM.ZCOORDE~UL$ -> metre ``` birim sistemleri dinamik olarak değiştirilebilir (Anglo-Amerikan, metrik veya Veritabanı birimleri). Bir Düzenin geçerli Birimi Yazdırması için Kullanım: ``` $Parametre[ <#MesUnit FieldName= Parametre>]$ ``` **Örnek:** `$ZCOORDE[ <#MesUnit FieldName= ZCOORDE>]$` --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.geodin.com/geodin-desktop/tr/gorsellestirme-yerlesim-planlari-ve-raporlama/report-templates/text-macros-in-reports.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.