> 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/entegrasyonlar-ve-eklentiler/overview-1/method-reference.md). # Yöntem Referansı Bu Sayfa, GeoDin COM API için kanonik referanstır. Bir dış uygulamanın GeoDin'i (bir COM sunucusu olarak) çalıştırmak için çağırabileceği Metodlar ile harici işlevleri GeoDin'e eklenti olarak gömmek için kullanılabilecek olanları açıklar. Bu referans, GeoDin'i diğer ürünlerle birleştiren veya GeoDin'e Özel fonksiyonlar entegre eden yazılım geliştiricilerine yöneliktir. Her Yöntem için İhtiyaç duyulan GeoDin sürümü belirtilmiştir. ## toplu bakış ### COM-Fonksiyonları ve Eklentiler GeoDin, GeoDin'i harici uygulamalara şuraya bağlama seçeneği sunar. Bu bölüm teknik Metodlar'ı açıklar ve, GeoDin'i diğer ürünlerle birleştirmek üzere olan veya Özel fonksiyonlar'ı GeoDin'e şuraya entegre etmek üzere olan yazılım geliştiricilerine yöneliktir. GeoDin'i harici bir uygulama aracılığıyla çalıştırmak için çeşitli işlevler Mevcut. Bu işlevlerin bir kısmı GeoDin program arayüzünü kontrol etmek için kullanılır (bu durumda GeoDin Kullanıcı için Görünür durumdadır); böylece örneğin bir CBS benzer harici uygulama GeoDin Nesne yöneticisinde bağımsız olarak bir Nesne seçer ve bir GeoDin Yöntem başlatır. İşlevlerin diğer bir kısmı, GeoDin Veritabanı Bilgi sağlamaktan Nesneler ait Grafik Resimler sağlamaya kadar kullanılır. Burada GeoDin genellikle Görünmezdir ve görevlerini Arkaplan içinde yönetir. Ayrı ayrı işlevler Bölüm içinde açıklanmıştır [COM işlevleri](#com-functions). Her işlev için hangi GeoDin sürümünün İhtiyaç duyulan olduğu tanımlanmıştır. Üzerinde, öte yandan GeoDin'e ait program arayüzü içinde dış uygulamaları veya işlevleri programa entegre etmek mümkündür. Bu tür işlevler (sözde eklentiler) örneğin özel Hesaplamalar veya veri dışa aktarımları gerçekleştirebilir ve GeoDin içinde bir metod sembolü ile gösterilir. Bu dış işlevlerin gömülmesi ve yapılandırılması için bir Tasvir, Bölüm içinde verilmiştir [Eklentiler](#plug-ins) ve içinde [Eklentiler yükleniyor](/geodin-desktop/tr/entegrasyonlar-ve-eklentiler/installing-plug-ins.md). ### COM-Fonksiyonları **GeoDin ait COM sunucusu olarak Kullanım için ipuçları** GeoDin'i COM sunucusu olarak kullanma (bir Tip ait Nesne oluşturarak `GeoDin.GeODinApplication`) aşağıdaki Parametreler tarafından kontrol edilebilir. #### GeoDin uygulamasına ait çalışma dizini standart olarak, Mevcut kullanıcıya ait "Yerel ayarlar" Klasörü içinde bulunan "TEMP" Klasörü, GeoDin uygulamasına ait çalışma dizini olarak COM sunucusu başlatma modunda kullanılır. Girilerek `YürütmeYolu=` Bölüm içinde `[Sistem]` ait olan [Konfigürasyon Dosya GeoDin.ini](/geodin-desktop/tr/yukleme-ve-lisanslama/configuration-file-reference.md) başka bir Klasör tanımlanabilir. #### Eklentilerin ait kullanılabilirliği standart olarak [Eklentiler](#plug-ins) GeoDin Başladı olduğunda yüklenmiş değil. Girerek `COMServerPlugins=Doğru` Bölüm içinde `[Sistem]` ait olan [Konfigürasyon Dosya GeoDin.ini](/geodin-desktop/tr/yukleme-ve-lisanslama/configuration-file-reference.md) Eklentinin yüklenmesi sağlanabilir. #### GeoDin ait uygulama dizini GeoDin'e ait uygulama dizini standart olarak BIN Klasörü'nden bir Seviye yukarıdaki Klasördür (GeoDin.exe'nin içinde bulunduğu). Tipik bir GeoDin Yüklemesi aşağıdaki yapıya sahiptir: ``` C:\Programs\GeoDin (İçerikler GeoDin.ini) C:\Programs\GeoDin\BIN (İçerikler GeoDin.exe) C:\Programs\GeoDin\SYSLIB C:\Programs\GeoDin\Kaynak vb. ``` Uygulama dizini bu durumda içinde `C:\Programs\GeoDin`, burada ayrıca Konfigürasyon Dosya GeoDin.ini okunur. Bu Ad ile ayrıca birkaç alt klasörün adları da oluşturuldu (örn. Kaynak, QUERYDEF, Yerleşim planları vb. için). GeoDin’in uygulama dizini başka herhangi bir Klasör şuraya Yapılandırılabilir; böylece, İse GeoDin’in Kullanıcı tarafından doğrudan uygulama olarak mı Başladı yoksa bir COM sunucusu olarak mı örneklendiği ayırt edilebilir. Kullanıcı tarafından GeoDin’in (“normal”) Başlatılması için uygulama dizini bir komut Çizgisi Parametre şuraya ayarlanabilir. Anahtar sözcük "Başlat" ile başlamalıdır. `-af` VE sonradan Tamamen bir Klasör Ad şuraya içermelidir. ``` C:\Programs\GeoDin\BIN\GeoDin.exe -afC:\Programs\GeoDin\Çözümler\Water ``` **Not:** Eğer Klasör Adı İçerikler Boş alanlar varsa tüm Parametre tırnak işaretleri içine şuraya alınmalıdır, örn.: ``` C:\Programs\GeoDin\BIN\GeoDin.exe "-afC:\Programs\GeoDin Çözümler\Water" ``` GeoDin COM sunucusu olarak Başlatıldığında, komut Çizgi Parametre mümkün değildir. Bu nedenle, bunu kayıt defteri üzerinden girmek için bir Yöntem hazırlandı. Burada, seçilen uygulama dizininin Adı, COM sunucusunun Başlatılması şuraya ÖNCE içinde yerleştirilmelidir `REG_SZ` "ApplicationFolder" anahtarı aşağıdaki kayıt defteri anahtarı içinde: ``` [HKEY_CURRENT_USER\Software\GeoDin- Sistemi\COMServer] ``` İkisi birden Metodlar ile GeoDin Klasörün varlığını kontrol eder ve ayarı, onu bulmaz İse geçerli değil sayılır. Daha fazla kontrol yapılmaz. Seçildi Klasör, GeoDin.ini adlı bir Konfigürasyon dosyasını ve GeoDin ait İhtiyaç duyulan Hepsi alt klasörleri İçerikler. ### Eklentiler **Eklentiler** GeoDin kullanıcı arayüzünden çağrılan harici modüllerdir (programlar / COM sunucusu). Böylece bir yazılım geliştiricisi, belirli bir uygulamanın başlatılmasını, örneğin özel bir Gönder işlevini veya yeni bir hesaplama işlevini, GeoDin program kullanıcı arayüzüne entegre edebilir. Kullanıcı için uygulama, "sıradan" bir GeoDin yöntemi olarak görünür. Seçilen nesne(ler) için ihtiyaç duyulan tüm bilgi GeoDin nesne yöneticisinde eklentiye aktarılır. Böylece seçili sayıda nesne için ek olarak analiz işlevleri eklenti tarafından sunulabilir. Bir eklenti, GeoDin veritabanı ile çalışmayan bir uygulama da olabilir. Eklenti Konfigürasyonu, işletim sistemindeki "hesap makinesi"ni de GeoDin program kullanıcı arayüzüne entegre edebilir. Bir eklenti, uygulama (EXE dosyası) veya kayıtlı bir COM sunucusunun COM işlevi olarak çağrılabilir. Burada Çalıştır parametresi **veya** Eklenti konfigürasyonundaki Sunucu. Eklenti olarak çağrılması gereken bir COM sunucusunun, aşağıda açıklanan belirli Gereklilikler ile uyumlu olması gerekir. Adım adım kurulum için bkz. [Eklentiler yükleniyor](/geodin-desktop/tr/entegrasyonlar-ve-eklentiler/installing-plug-ins.md). **Bir eklentinin tanımı** Kullanılacak eklentilerin ayarı ve yapılandırması GEODIN.INI yapılandırma dosyasında yapılır. GeoDin 9'da, eklentiler sistem sekmesinde, Sistem yapılandırması altındaki "yayın" bölümünde tanımlanır. **1. Mevcut eklenti listesi** Bölümde `[Eklentiler]` her eklenti bir Çizgi ile tanımlanır ve bir Ad alır, örnek: ``` [Eklentiler] Plugin1=Hesapla Plugin2=Gönder ``` ***Not:*** *Muhtemelen Bölüm `[Eklentiler]` İse Hayır, Önceki eklentiler yapılandırılmadıysa Bölüm oluşturuldu şuraya. İçeren bir Çizgi Ekle `[Eklentiler]` Yazı düzenleyicisiyle, GEODIN.INI Dosyasına ait sonunda Üzerinde ve En azından benzer bir Çizgi `Plugin1=Eklentiye ait Ad`. Kullanım ardışık numaralar (`Plugin1=`, `Plugin2=` vb.) birden fazla eklentiye ait tanım için.* **2. Listeye ait tek bir eklentinin tanımı** Liste içinde yer alan her eklenti için `[Eklentiler]` 1. Aşamada tanımlanan eklentinin Adını içeren, GEODIN.INI Konfigürasyon Dosyası içinde ayrı bir Bölüm oluşturuldu, örnek: ``` [Hesapla] Ad=Hesapla Çalıştır=C:\PROGRAMS\GEODIN\BIN\GPI.EXE ``` ***veya*** ``` Sunucu=GeODinPlugin.GeODinPluginSample Modül=Modül1 Simge=C:\PROGRAMS\GEODIN\BIN\CALC.ICO Popup=Yanlış Bekle=Yanlış DBNode1=1 DBNode2=2,1 ``` Yazı düzenleyicisi ile belirli satırları şuraya Ekle: GEODIN.INI Dosyası. Bu Bölümdeki Parametreler, GeoDin Nesne yöneticisi içinde hangi Nesneler üzerinde uygulanacağını, hangi program Dosyası veya hangi COM sunucu fonksiyonunun Çalıştırılacağını (Çalıştır) ve Kullanıcı İse fonksiyonun Çalıştırılmasına ait bekleyip beklememesi gerektiğini denetler. Aşağıdaki Parametreler ayarlanmıştır: | Parametre | Tasvir | | ------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `Ad` | GeoDin nesne yöneticisindeki eklentinin Adı (bu adlar metod sembolü altında veya açılır menü içinde gösterilir). | | `Çalıştır` | Çalıştırılabilir program (Tamamen Dosya adı yol ile birlikte). **Örnek:** `C:\WINDOWS\SYSTEM32\CALC.EXE` | | ***veya*** `Sunucu` | Seçilen işlevi Çalıştıracak COM sunucusunun Adı. **Örnek:** `GeODinPlugin.GeODinPluginSample` | | `DBNode1..n` | GeoDin nesne yöneticisindeki düğümlerin Liste'si **Veritabanları**, eklentinin Başladı olabileceği yer. Burada seç, eklenti çağrısının hangi düğümler Üzerinde (dallar ve düğüm Durumu içinde) mümkün olacağını. Bu, herhangi bir Uzunlukta dal Tanımları listesi seçilerek yapılır; bu liste bir Giriş ile ayarlanmalıdır `DBNodexx`. Kullanım ardışık numaraları (`DBNode1=`, `DBNode2=` vb.) birkaç düğümün tanımı için. Aşağıdaki örneklere ve sözdizimine bakın. | | `Modül` (isteğe bağlı) | Program Modülüne ait Ad, eklenti içinde; bu Ad, çalıştırılabilir programa VEYA COM işlevine Parametre olarak aktarılır. İse modül Adı girilmezse (Hayır), aktarım Parametresi Boş kalır. Bu seçenek sayesinde tek bir uygulama VEYA COM sunucusu işlevi, Modül kimliği tarafından kontrol edilen farklı İşlemler gerçekleştirebilir. Birkaç işlev, Modül adları kullanılarak harici bir uygulamada birleştirilebilir; çünkü aynı Uygulama Dosyası VEYA COM sunucusu işleviyle birkaç eklenti bağlamak mümkündür. Modül adını bir Parametre olarak şuraya aktararak, harici uygulama içinde VEYA işlevde farklı İşlemler Etkin olabilir. Bu durumda farklı işlevler, "Icon" Parametresi kullanılarak farklı Semboller ile eşleştirilebilir. | | `Icon` (isteğe bağlı) | Yöntem yöneticisinde metod sembolü gösterimi için bir ICO Dosyasına ait Tamamen Dosya adı. İse bu Parametre girilmiş değilse, yürütülebilir programın simgesi kullanılır (COM sunucuları için mümkün değil). İse programın hiçbir ikonu İçerikler yoksa, Hayır; bir Standart simge kullanılır. | | `Açılır pencere` (isteğe bağlı) | Yöntem yalnızca açılır menü olarak gösterilir (GeoDin Nesne yöneticisi içinde Nesne üzerinde sağ fare şalteriyle tıklayın). Değer şuraya ayarlayın `=Doğru`, İse eklenti metod sembolü olarak görünmemelidir, yalnızca açılır menü içinde. Standart Değer şudur `=Yanlış` -> Sembol, yöntem yöneticisinin içinde. | | `Bekle` (isteğe bağlı) | GeoDin'in eklenti içinde işlevi Çalıştırmadan önce bekleyip beklemeyeceğini denetler. Uygulamalar (EXE Veriler) için Değer'i şuraya ayarlayın `=Doğru`, İse fonksiyon tamamlandı olmalıysa, şuraya GeoDin içinde çalışmayı üzerinde sürdürmek. Bu Standart Değer ait bu Parametre şudur `=Yanlış`. ***Not:*** *Bir COM sunucusu kullanıldığında GeoDin Her zaman işlev sona erene kadar bekler.* | | `AçMetodlaraİzinVer` (isteğe bağlı) | Eklentinin, Aç Metodlar varsa İse çalıştırılıp çalıştırılamayacağını tanımlar (örn. Veri toplama). standart ayar, eklentinin çalışmasına izin verir: Parametreyi şuraya ayarlayın `=Yanlış`, bunu önlemek için (bu durumda, içinde bir Uyarı gösterilir). | | `Sakla` (isteğe bağlı) | Eklentinin Yöntem yöneticisinde (Sembol ya da açılır menü olarak) Görünür olup olmadığını denetler. standart olarak Görünür durumdadır. Parametreyi ayarlayın `Sakla` şuraya `=Doğru`, eklentiyi Sakla. Ardından eklenti yalnızca şu kullanılarak çağrılabilir [COM işlevi](#com-functions) **"Yöntem parametrelerini çalıştır"**. | | `Genişletildikten sonra çalıştır` (isteğe bağlı) | Eklentinin, dalı birinci Saat açarken otomatik olarak çalıştırılıp çalıştırılmayacağını kontrol eder. Parametreyi ayarlayın `=Doğru` şuraya eklentiyi otomatik olarak Başlatmak için. Parametre tarafından gizlenen Eklentiler `sakla=doğru` otomatik olarak Başladı edilebilir. Bu şekilde, bir işlevi GeoDin Kullanıcı tarafından değil, bu dal açıldığında otomatik olarak yürütülen şuraya çağırmak mümkündür (örneğin Veritabanı açıldıktan sonra). | | `Veritabanı Sözlüklerini Yenile` (isteğe bağlı) | Bu, eklenti çalıştıktan sonra veritabanı sözlüklerinin bellekten çıkarılıp çıkarılmayacağını tanımlar. İse gerekli olduğunda, bunlar otomatik olarak yeniden yüklenecektir. | **DBNode örnekleri** **Örnek 1:** ``` DBNode1=3,2,1 ``` Anlamı: Eklenti bir Proje düğümü üzerinde gösterilir. Proje zaten açılmış olmalı ve bir OneTableSet Veritabanı içinde yer almalıdır. **Örnek 2:** ``` DBNode1=3,BoreholeVeritabanı,1 ``` Anlamı: Eklenti yalnızca Veritabanı "BoreholeVeritabanı"na ait açık Projeler Üzerinde gösterilir. **Örnek 3:** ``` DBNode1=3, BoreholeVeritabanı,0,P00001 DBNode2=3, BoreholeVeritabanı,0,P00002 ``` Anlamı: Eklenti, Veritabanı "BoreholeVeritabanı"na ait Proje kimliği P00001 veya P00002 olan Projeler Üzerinde gösterilir. Projeler açık ya da kapalı İse önemli değil. **Örnek 4:** ``` DBNode1=9,2,0,,2,JPG ``` Anlamı: Eklenti, Hepsi SQL Veritabanları içinde OneTableSet ayarı olan Yöntem Listesinin Saniye Konumundaki JPG Tipindeki Belgeler Üzerinde, Önizleme Yönteminden sonra gösterilir. **DBNodeX= tanımının sözdizimi** Parametre ID zorunlu olarak girilmelidir, diğer parametreler virgülle ayrılarak eklenebilir. ``` DBNode1..n=ID[,Param1][,Param2][,...] ``` | ID | Eklenti nesnede gösterilir ... | | -- | ------------------------------------------- | | 1 | Veritabanları | | 2 | Veritabanı | | 3 | Proje | | 4 | Nesneler dalındaki Sorgula veya Grup | | 5 | Ölçüm noktaları dalındaki Sorgula veya Grup | | 6 | Nesne | | 7 | Ölçüm noktası nesnesi | | 8 | Belge klasörü | | 9 | Belge | | Param1 | Eklenti, bir Veritabanı içinde ID tarafından tanımlanan nesneler üzerinde ... gösterilir | | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 0 | tüm veri tabanları | | 1 | ID=1 için Eklenti, yalnızca şu anda hiçbir Veritabanı yapılandırılmamışsa gösterilir; ID=2 için yalnızca SQL Veritabanları içinde (dosya tabanlı Veritabanları yok) | | 2 | yalnızca OneTableSet ayarı olan SQL Veritabanları içinde | | Ad | yalnızca girilen ada sahip belirli Veritabanında | | Param2 | Eklenti, bir Veritabanı içinde ID tarafından tanımlanan nesneler üzerinde ... gösterilir | | ------ | ---------------------------------------------------------------------------------------- | | 0 | Veritabanı ya da Proje açık olup olmadığına bakılmaksızın | | 1 | yalnızca Veritabanı ya da Proje açıksa | | 2 | yalnızca Veritabanı ya da Proje kapalıysa | | Param3 | Eklenti, bir Veritabanı içinde ID tarafından tanımlanan nesneler üzerinde ... gösterilir | | ------ | ---------------------------------------------------------------------------------------- | | boş | tüm projeler içinde | | PRJID | yalnızca girilen ID'ye sahip Projeler içinde | | Param4 | Eklenti, yöntem listesinde önceden ayarlanmış bir konumda gösterilir... | | ---------- | ------------------------------------------------------------------------ | | Boş veya 0 | listenin sonunda (GeoDin metodlarından sonra) | | 1..n | girilen konumda, örn. 1 - metod sembolü nesnenin 1. konumunda gösterilir | | Param5 | Eklenti, ID=9 için yalnızca aşağıdaki tipteki Belgelerde gösterilir ... | | ------ | ----------------------------------------------------------------------- | | Boş | tüm Belge Tiplerinde | | JPG | yalnızca bu tipteki Belgelerde (burada örnek: JPG Resimleri) | **Bir uygulamayı (EXE dosyası) eklenti olarak kullanma** Bir uygulamayı eklenti olarak kullanmak için parametreyi girmeniz gerekir `Çalıştır=uygulamanın tam yol adı` Eklenti tanımında. GeoDin, yöntem çağrıldığında uygulamayı başlatır ve GeoDin nesne yöneticisinde seçili dalın tüm ihtiyaç duyulan parametrelerini aktarır. Bu verilerle eklenti bu nesneler için özel İşlemler gerçekleştirebilir. Parametreler uygulamaya komut satırında aktarılır. GeoDin nesne yöneticisinde seçili dala bağlı olarak parametre sayısı değişir; bu, aşağıdaki tabloda gösterilmiştir: | Parametre | Tip | İçerik | ID=1 | ID=2 | ID=3 | ID=4-9 | | --------- | ----------------- | ------------------------------------------------------------------------------------- | ---- | ---- | ---- | ------ | | 1 | Dize | Modül adı VEYA Boş | X | X | X | X | | 2 | Tamsayı | Ekran Konum sol | | X | X | X | | 3 | Tamsayı | Ekran Konum üst | | X | X | X | | 4 | Tamsayı | Şubenin ait kimliği | X | X | X | X | | 5 | Dize | Veritabanı adı \*1 | | - | X | X | | 6 | Dize | Veritabanı kayıt adı | | - | X | X | | 7 | Dize | Şifre Veritabanı \*2 | | - | X | X | | 8 | Dize | Proje kimliği GeoDin, VEYA bir Veritabanı Sorgula altındaki bir şube için "DB" dizesi | | - | - | X | | 9 | Dize veya Tamsayı | ID Seçimine bağlı olarak | | - | - | X | Parametre 9'un türü, eklentinin Şuradan başlatıldığı dalın ID'sine bağlıdır: | ID | Parametre 9 | | ----- | ---------------------------------------------------------------- | | 1,2,3 | boş | | 4 | Nesnelerin PRJ\_ID ve LOCID'sini içeren geçici Dosya adı | | 5 | Nesnelerin INVID'lerinin dizesini içeren geçici Dosya adı | | 6 | Seçildi olan Nesnenin PRJ\_ID ve LOCID'si | | 7 | Seçildi olan Nesnenin INVID'si dize olarak | | 8 | Belgelerin ADC\_ID'lerinin Tamsayılarını içeren geçici Dosya adı | | 9 | Belgelerin ADC\_ID'si | \*1 Veritabanı adı: Veritabanı adına ek olarak, bu dize ayrıca bağlantı türünü (ADO veya FireDAC) ve Bağlantı dizisi'nin kendisini de içerir. \*2 Şifre bağlantı dizisinin bir parçası olabilir; örn. sistem veritabanları veya kayıtlı bir şifre içeren bağlantılar için. Bu durumda dize boştur. Şifre doğrudan bağlantı dizisinden çıkarılmalıdır. {% hint style="warning" %} Kimlikleri olan bir dosya eklentilere aktarılırsa, bu dosyayı silmek eklentinin sorumluluğundadır! Dosya silinmezse, mevcut kullanıcının TEMP klasöründe kalır. {% endhint %} Kimliklere sahip dosya, sorguda veya grupta bulunan nesneler kadar satır içerir. Şube ID = 4 üzerinde her satır, virgülle ayrılmış PRJID ve LOCID içerir (Örnek: PRJ001,3). Şube ID = 5 üzerinde her satır INVID içerir (Örnek: PRJ0010004FIL001). Şube ID = 8 üzerinde her satır ADC\_ID içerir (Örnek: 23). "ideal" pencere konumunun 1 ve 2 parametreleri, dış uygulamanın penceresini GeoDin metodlarıyla benzer şekilde metod sembolünün sağ altına veya açılır menü girişine konumlandırmaya izin verir. **Bir COM sunucusunu eklenti olarak kullanma** Bir COM sunucusunu eklenti olarak kullanmak için parametreyi girmeniz gerekir `Server=COM sunucusuna ait Tamamen Ad` Eklentinin tanımının içinde. Tamamen Ad, COM sunucusuna ait Ad ve arayüze ait Ad; bunlar bir Nokta ile ayrılır, örn. `GeODinPlugin.PluginInterface`. Arayüz, Ad adlı bir işlev sağlamalıdır `GeODinExecutePlugin`, bir dizeyi aktarım Parametresi olarak alır ve bir OleVariant Parametresi döndürür: ``` function GeODinExecutePlugin(const Params: WideString): OleVariant; ``` ***Not:*** *İşlevin tanımının sözdizimi, eklentinin oluşturulduğu programlama Diline ait olup içinde kullanılan kurallara bağlıdır.* Parametreler içinde aktarılan dize, aşağıdaki bölümler VE Parametreler ile bir Konfigürasyon Dosya yapısına sahiptir: ``` [Params] Genel Parametreler sol= Bir pencere gösteren bir Yöntemin ideal X konumu üst= Bir pencere gösteren bir Yöntemin ideal Y konumu Modül= Modül adı (Şuradan GeoDin.ini) DBNode= Seçildi dala ait ID Çözüm Adı= GeoDin çözümünün Adı (İse kuruluysa) Çözüm Versiyonu= GeoDin çözümünün Versiyonu (İse kuruluysa) Veritabanı= Veritabanı adı: ADOConnection Kullanıcı adı= Kullanıcı kimliği Şifre= Veritabanı şifresi Sahip= Veritabanı Tablosuna ait sahibin Adı PRJID= Proje Kimliği veya "DB" SorguAdı= Seçilen nesnelerin bulunduğu sorgunun adı [Nesneler] Seçilen nesnelerin nesne kimliklerinin listesi ID1 ID2 ... [Sorgula] Sorgu öğelerini içeren Bölüm (yalnızca Sistem sorguları için) seç= SQL komutu içindeki seç bölümü Şuradan= SQL komutu içindeki Şuradan bölümü Where= SQL komutu içindeki koşul bölümü Order By= SQL komutu içindeki sıralama bölümü ``` Açıklama: Konum, eklenti tarafından GeoDin metodları için konumlara karşılık gelen bir diyalog yerleştirmek üzere kullanılabilir. Parametre DBNode, Seildi dalın ID'sini İçerikler (DBNode'un yukarıdaki Tasvirine bakın). Veritabanı bağlantısı, Veritabanı adıyla belirtilir (Ad ve Bağlantı dizisi, iki nokta üst üste ile ayrılmıştır), giriş bilgileri (SQL Veritabanları için) ve sonunda sahip adı. Parametre PRJID, Seildi dallar bir Proje altındaysa GeoDin Projesi Kimliği ile doldurulur; aksi halde bu Parametre "DB" sabit dizgisini İçerikler. Nesne ID türü: * Nesneler: PRJ\_ID ve LOCID virgülle ayrılmış * Ölçüm noktaları: INVID dize olarak * Belgeler: belgelerin ADC\_ID'si İse Sistem sorguları kullanılıyorsa, nesne yöneticisinde Nesnelerin girişine neden olmuş SQL komutlarının Özellikler'i "Sorgula" Bölümünde aktarılır. Fonksiyonun dönüş değeri daha sonraki genişletmeler için ayrılmıştır. Değer sıfır olarak ayarlanmalıdır, çünkü şu anda döndürülmemektedir. **Raporlar oluşturmak için eklenti** GeoDin nesne yöneticisinde eklentilerin metod olarak Çalıştırılmasının yanı sıra, eklentiler Raporlar oluşturmak için de kullanılabilir. Bu tür eklentiler Yerleşim planları ve Grafiklerde, bir Grafik içinde çok özel bir Rapor et türünü gerçekleştirmek için kullanılabilir. Böyle bir eklentiyi geliştirmek karmaşık bir görevdir, çünkü XML biçiminde bir GeoDin sınıfı oluşturulmalı ve işleve Parametre olarak döndürülmelidir. XML biçimindeki bir GeoDin sınıfının Tasviri burada yer almamaktadır (Bilgi talep üzerine sağlanır); burada yalnızca rapor eklentilerinin ayarlanması açıklanmaktadır: **1. Mevcut rapor et eklenti Listesi** Bölümde `[Rapor et Eklentileri]` her eklenti bir Çizgi ile tanımlanır ve bir Ad verilir. **Örnek:** ``` [Rapor et Eklentileri] Eklenti1=Özel Rapor et ``` **2. Listeye ait tek bir rapor et eklentisinin tanımı** Liste içinde tanımlanan her eklenti için `[Rapor et Eklentileri]` 1. aşamada tanımlanan eklentinin Adı ile, GEODIN.INI Konfigürasyon Dosyası içinde ayrı bir Bölüm oluşturulması gerekir. **Örnek:** ``` [Özel Rapor et] Ad=Özel Rapor et suyu Sunucu=GeODinRapor etEklentisi.GeODinRapor etEklentisiÖrneği Modül=Modül1 ExecuteWithOutData=yanlış ``` | Parametre | Tasvir | | -------------------- | -------------------------------------------- | | `Ad` | Rapor et Ad Üzerinde Grafik öğesi "Rapor et" | | `Sunucu` | COM sunucusuna ait arayüz Ad | | `Modül` | isteğe bağlı Modül Ad | | `ExecuteWithOutData` | Eklentiye ait Çalıştır Tip Seçim | Modül Adı eklentiye aktarılır, böylece bir COM işlevi içinde farklı Raporlar oluşturuldu. Seçeneği şuraya ayarlayarak `ExecuteWithOutData=yanlış` GeoDin, Grafik bir veri bağlantısı Hariç bir Düzen İse eklentiyi Başladı. Seçeneği ayarlayarak `ExecuteWithOutData=Doğru` Bağlı verilerle bir Grafik içinde yalnızca başlar. Bir COM sunucusunu bir rapor eklentisi olarak kullanmak için, eklentinin tanımına parametreyi girin `Server=COM sunucusuna ait Tamamen Ad`. Tam ad, COM sunucusunun adı ve arabirimin adı virgülle ayrılmıştır, örn. `GeODinPlugin.PluginInterface`. Girilen arabirimin, şu adı taşıyan bir işlev sağlaması gerekir `GeODinGetGraphicReport`, transfer parametresi olarak bir dize ve dönüş parametresi olarak bir OleVariant alan: ``` function GeODinGetGraphicReport(const Params: WideString): OleVariant; ``` ***Not:*** *İşlevin tanımının sözdizimi, eklentinin oluşturulduğu programlama Diline ait olup içinde kullanılan kurallara bağlıdır.* params içinde aktarılan dize, yukarıda sunucu eklentileri için açıklandığı benzer şekilde bölümler ve parametreler içeren bir konfigürasyon dosyası yapısına sahiptir. Karşılık olarak GeoDin sınıfı C\_GraphicDrawReport'e göre bir XML veri akışı beklenir. ### Hata numaraları Hata numaraları tüm işlevler için sabittir. Bunlar tarafından döndürülür [İstisna değer](#exceptionvalue). | sayı | Anlam | | ---- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 1 | Sistem hatası (Sistem kaynakları tükenmiş vb.) | | 2 | İşlev lisanslı değil | | 3 | Başlatma hatası (COM-Server başlamamış ya da eksik başlamış) | | 4 | Yerleşim planı dosyası (Parametre LayoutFileName) veya yerleşim planı / rapor yerleşim planı listesinden yüklenemiyor (yanlış ad, dosya eksik, bozuk vb.) | | 5 | Yerleşim planında hata (örn. mevcut Nesne çerçevesi yok) | | 6 | Veritabanı açılamıyor (yanlış veritabanı adı, yanlış giriş) | | 7 | Nesne yüklenemiyor (yanlış veya bozuk Proje ID'si, Nesne ID'si, GeoDin SYSLIB klasöründeki bozuk dosyalar) | | 8 | Parametre OutFileName içinde seçilen Dosya kaydedilemiyor (yanlış dosya adı, izinler) | | 9 | Seçilen çıktı (yazdırma) aygıtı konfigürasyon dosyası GeoDin.INI içinde tanımlanmamış. | | 10 | Konfigürasyon girdisi tarafından tanımlanan yazdırma aygıtı kurulu yazıcı sürücüleri listesinde bulunamıyor. | | 11 | Yazdırma dosyası oluşturulurken hata (örn. kağıt biçimi ayarının yanlış olması, yazıcı sürücüsü bu biçimi desteklemiyor) | | 12 | İşlev sonucunda tamamlanan yazdırma dosyası aktarılırken hata (SpoolTimeOut tanımlayın) | | 13 | Nesne girdisi veya nesne grubunun oluşturulması mümkün değil (yanlış Nesne ID, Nesne tipi) | | 14 | Geçersiz MethodID - işlev kullanılamıyor | | 15 | Seçim mümkün değil çünkü işaretli nesneden çıkılamıyor. Örnek: Mevcut nesne düzenleniyorsa ve verilerdeki yazım hatası nedeniyle bırakılamıyorsa, başka bir nesnenin seçilmesi mümkün değildir. | | 16 | Açıklama başlatılamıyor çünkü hiçbir Grafik penceresi açılmamış. | ## Referans: COM metodlar ### İstisna değer Hata durumunu belirlemek için işlevler. ``` function İstisna değer:Tamsayı; ``` Bu işlev, daha önce çağrılan işlevin hata durumunu gösterir. Dönen değer 0'dır, eğer daha önce çağrılan işlev doğru çalışmışsa. Olası hata sayıları aşağıda açıklanmıştır [Hata numaraları](#error-numbers). ``` function ExceptionMsg:string; ``` (Standart sürüm İhtiyaç duyulan) Önceki başarısız bir işlev çağrısının hata metninin döndürülmesi. Eğer `İstisna değer <> 0` tam hata mesajı bu işlevle sorgulanabilir. ### Görünür Nesne Yöneticisi GeoDin penceresini gösterme veya saklama işlevi. ``` özellik Görünür Nesne Yöneticisi:boolean ``` Bu özellik "Doğru" veya "Yanlış" olarak ayarlanarak GeoDin nesne yöneticisinin görünürlüğü kontrol edilir. ### Lisans Bilgisi Lisans bilgilerini belirlemek için işlevler. ``` function Lisans Bilgisi:string; ``` Bu işlev esas sürümden itibaren kullanılabilir. Yanıt, GeoDin ve mevcut modüller hakkındaki bilgileri içerir. ``` Lisans bilgisi: Yapım numarası: G1840809 Dongle numarası: bilinmeyen GeoDin - Sürümler Profesyonel ``` Sürüm numarasıyla birlikte çözüm bilgileri, mevcutsa çıktıda yer almaya devam eder. ### Konum seç Nesne yöneticisinde bir nesneyi işaretlemek (seçim) için işlevler. ``` function Konum seç(Veritabanı, Kullanıcı adı, Şifre, ProjectID:Widestring; LocationID:Tamsayı):Tamsayı; ``` Bu işlev temel modülden itibaren kullanılabilir. Belirtilen Nesne GeoDin nesne yöneticisinde işaretlenir ve mevcut Nesne olur. Nesne ID olarak da -1 aktarılabilir. Bu durumda GeoDin Proje nesne yöneticisinde işaretlenir ve mevcut Nesne olur. | Parametre | Tasvir | | --------------- | ---------------------------------------------------------------------------------- | | `Veritabanı` | Veritabanı bağlantısı adı, örneğin "GeoDin COM example" | | `Kullanıcı adı` | Veritabanı giriş adı (Access için bir boşluk karakteri ' ', boş bir dize değil!) | | `Şifre` | Veritabanı oturum açma Şifre (Access için bir boşluk karakteri ' ', boş dize yok!) | | `ProjeKimliği` | GeoDin proje kimliği (6 basamak) | | `NesneKimliği` | GeoDin nesne kimliği | {% hint style="info" %} Fonksiyon yürütülürse dönüş değeri 0'dır. Bir hata oluşmuşsa dönüş değeri 1'dir. Bkz. [İstisna değer](#exceptionvalue) ve ExceptionMsg. {% endhint %} ### Nesne seç ``` fonksiyon Nesne seç(Params:Widestring):tamsayı; ``` Belirtilen nesne (veritabanı, proje, sorgu, nesne, ölçüm noktası) GeoDin nesne yöneticisinde işaretlenir ve Mevcut nesne olur. Fonksiyonun denetimine, bir konfigürasyon bloğu biçimindeki bir dize aracılığıyla erişilir: ``` [Params] Veritabanı= KullanıcıAdı= Şifre= NesneTip= ParentNode= Sorgula= NesneKimliği= genişletmek= ``` Parametreler aşağıdaki anlama sahiptir: | Parametre | Tasvir | | --------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `Veritabanı` | Veritabanı bağlantısı adı, örneğin "GeoDin COM example" | | `Kullanıcı adı` | Veritabanı oturum açma adı (Access için boş, dahili olarak bir boşluk karakteri ' ' kullanılır!) | | `Şifre` | Veritabanı oturum açma Şifre (Access için boş, dahili olarak bir boşluk karakteri ' ' kullanılır!) | | `NesneTip` | `0` - Veritabanı dalı veya proje dalı seçilmelidir. Veritabanı dalını seçmek için parametre `ParentNode` şu değere ayarlanmalıdır: `=Veritabanı`, parametreler `Sorgula` ve `NesneKimliği` boş kalır (giriş yok). Bir proje dalını seçmek için parametre `ParentNode` şu değere ayarlanmalıdır: `=Proje`, parametre `NesneKimliği` proje kimliğini içermelidir (ör. `NesneKimliği=PRJ001`), parametre `Sorgula` boş kalır (giriş yok). `1` - "nesneler" dalı veya bir nesne sorgusu seçilmelidir. `2` - "ölçüm noktaları" dalı veya bir ölçüm sorgusu ya da bir ölçüm noktası seçilmelidir. | | `ParentNode` | `=Veritabanı`: seçilecek nesnenin, bir sorgu olarak doğrudan veritabanının altında veya bu türdeki bir sorgunun içinde olması gerektiğini tanımlar. Parametre `Sorgula=` bu türdeki sorgunun adını tanımlar. `=DatabaseQueries`: seçilecek nesnenin, veritabanındaki nesneler dalında (`NesneTip=1`) veya ölçümler dalında (`NesneTip=2`) olması gerektiğini tanımlar. Parametre `Sorgula=` bu türdeki sorgunun adını tanımlar. `=Proje`: seçilecek nesnenin doğrudan sorgunun altında veya bu türdeki bir sorgunun içinde olması gerektiğini tanımlar. Parametre `Sorgula=` bu türdeki bir sorgunun adını tanımlar. `=ProjectQueries`: seçilecek Nesne'nin ya da dal Nesneleri (`NesneTip=1`) veya ölçümler dalında (`NesneTip=2`) Proje ait. Parametre `Sorgula=` Sorgula'nın adını tanımlar. | | `Sorgula` | Bu Opsiyonel parametre, seçilecek Sorgula'nın adını veya seçilecek Nesne'yi İçerikler Sorgula'yı tanımlar. İse bu Parametre girilmezse GeoDin, otomatik olarak "Tüm nesneler" Sorgularını ya da ilgili Sorgula'yı veya INVID'de üç haneli ölçüm ID'si tarafından tanımlanan ölçüm tipini seçer. | | `NesneKimliği` | Parametre `NesneKimliği` seçilen Nesne'yi belirtir. İse `NesneKimliği` Boş ise veya yalnızca altı haneli bir Proje ID'si İçeriklerse, yalnızca dallar (bu durumda Sorgular), belirli bir Nesne veya Ölçüm noktası seçilmeden seçilir, `ParentNode` ve `Sorgula`bir ID nesnesinin Proje ID'sini doğrudan takip etmesi gerekir ve tam dört karakterden oluşmalıdır, örneğin `PRJ0010022` = Proje ID: PRJ001 ve ID nesnesi 22. ID nesnesinin sayısı sıfırlarla tamamlandı ve tam olarak dört karakterden oluşmalıdır. İse bir Ölçüm noktası Seçildi ise, örneğin `PRJ001022FIL001`. Bir istisna, Tipi "Filtre" veya "Örnek" olan bir GeoDin ölçüm noktasını sorgula Seçimidir. Bir `NesneKimliği` Tip ait `= PRJ001????FIL` (`NesneTip=2`, `ParentNode=ProjectQueries`, `Sorgula=Boş`) örneğin, Proje PRJ001'e ait dalın Ölçüm noktaları içinde "Filtre" Sorgula, bu dal içinde belirli bir Ölçüm noktası seçimi Hariç Seçildi. | | `genişletmek` | Bu Parametre, Seçildi dalın aynı anda açılıp açılmayacağını tanımlar. Kullanım girişleri `=Doğru` veya `=Yanlış` Açılma İşlemini belirlemek şuraya. Standart Değer ait `genişletmek` dir `=Doğru`. | {% hint style="info" %} Fonksiyon çalıştırıldı İse fonksiyonun dönen değeri 0'dır. Bir Hata oluştu İse dönen değer 1'dir. Bkz. [İstisna değer](#exceptionvalue) ve İstisnalar. {% endhint %} ### Nesne seçimi oluştur ``` fonksiyon Nesne seçimi oluştur(Veritabanı, Kullanıcı adı, Şifre, NesneKimlikleri: WideString; NesneTürü: Tamsayı; RefAdı: WideString; YöntemKimliği: Tamsayı; YöntemParametreleri: WideString): Tamsayı; ``` Bir veya daha fazla Nesne GeoDin Nesne yöneticisine eklenir. İsteğe bağlı olarak, parametrelerle bir Yöntem bir Nesne ya da bir Nesne Grubu üzerinde başlatılabilir. | Parametre | Tasvir | | --------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `Veritabanı` | Veritabanı bağlantısı adı, örn. "GeoDin COM örneği" | | `Kullanıcı adı` | Veritabanı giriş adı (Access için bir boşluk karakteri ' ', boş bir dize değil!) | | `Şifre` | Veritabanı oturum açma Şifre (Access için bir boşluk karakteri ' ', boş dize yok!) | | `Nesne Kimlikleri` | Bir veya daha fazla Nesne kimliği içeren dize. Bunlar, ilgili durumda INVID değerleri olarak yorumlanır `Nesne Türü = 1` veya `2`. İse `ObjectType = 3` onlar ADC\_ID Değerler olarak yorumlanır. INVID'ler Şuradan Tablolar LOCREG, FILREG VEYA PRBREG alınabilir ya da kurallara göre oluşturulabilir. ADC\_ID'ler Tablo ADC\_DATA içinde bulunmalıdır. Tek bir ID girilerek tek bir Nesne eklenir ve Seçildi. Birden fazla ID girildiğinde bunlar CRLF ile ayrılmalıdır (`$0D$0A`) (birden fazla satırlı dize Liste Nesnesi). İse birkaç Nesne eklenirse bir Grup Sonuçlar oluşur, bu da eklendikten sonra Seçildi olur. | | `NesneTip` | Kullanılarak `ObjectType=0` Nesneler bir Nesne olarak yorumlanır. Kullanılarak `NesneTip=1` Nesneler Ölçüm noktaları olarak eklenir. Bu seçenek özellikle Tablo LOCREG şuradan gelen INVID'ler için geçerlidir, çünkü bunlar ya Nesneler ya da Ölçüm noktaları olabilir. Tablolar FILREG veya PRBREG şuradan INVID'ler eklenirken kullanılan `ObjectType=0` bir Hata'ya yol açar. Kullanılarak `ObjectType=3` Belgeler eklenir ve ID'ler ADC\_ID'ler olarak yorumlanır. | | `RefAd` | İse `Nesne Kimlikleri` yalnızca bir Nesne İçeriklerse bu Parametre Kullanılmıyor. Birden fazla Nesne için bu Parametre, Kullanıcı Gezinimini basitleştirmek için bir Grup adı İçermelidir (eğer Boş bir dize seçilirse Grup "Yeni grup" olarak adlandırılır). | | `YöntemID` | YöntemID'ye ait isteğe bağlı bir gösterge. İlgili Yöntemi Başlatır. Yöntem Başladı değilse, YöntemID -1 olarak aktarılır (Hayır). | | `YöntemParametreleri` | Yalnızca İse kullanılır. `YöntemID <> -1`. Yöntemin çağrısını kontrol etmek için şuraya ait olarak kullanılır. Bakınız [Yöntem parametrelerini çalıştır](#executemethodparams). | {% hint style="info" %} Fonksiyon yürütülürse dönüş değeri 0'dır. Bir hata oluşmuşsa dönüş değeri 1'dir. Bkz. [İstisna değer](#exceptionvalue) ve ExceptionMsg. {% endhint %} ### Karakter dizisi halinde bulunan yöntem listesi GeoDin Metodlarını başlatmak için işlevler. ``` fonksiyon Karakter dizisi halinde bulunan yöntem listesi:string; ``` Seçildi Nesne üzerinde çağrılabilen Metodlar listesini döndürür. Sonuç dizisi, CRLF ile ayrılmış birkaç Çizgiden oluşabilir; burada her Çizgi bir Yöntemdir. Bir Yöntem Girişi, MethodID'nin ardından bir virgül ve Yöntemin Adından oluşur (örneğin `2,Grafiği düzenle`). MethodID, Yöntem içinde kullanılabilir [Yöntemi çalıştır](#executemethod). İse, hiçbir Yöntem yoksa, Sonuç dizisi Boş olur. ### Yöntemi çalıştır ``` fonksiyon Yöntemi çalıştır(MethodID:Tamsayı):Tamsayı; ``` Bu işlev GeoDin Temel Modülünde mevcuttur. Diğer modüller, yönteme bağlı olarak gerekli olabilir (ör. Loglar, Lablar...). Bu işlev aracılığıyla kullanılabilen MethodID'ler (ve [Yöntem parametrelerini çalıştır](#executemethodparams)) şurada belgelenmiştir [Yöntem Parametreleri](#method-parameters). {% hint style="info" %} Fonksiyon yürütülürse dönüş değeri 0'dır. Bir hata oluşmuşsa dönüş değeri 1'dir. {% endhint %} ### Yöntem parametrelerini çalıştır ``` fonksiyon Yöntem parametrelerini çalıştır(MethodID:Tamsayı; MethodParams: WideString):Tamsayı; ``` Bu işlev GeoDin Temel Modülünde mevcuttur. Diğer modüller, yönteme bağlı olarak gerekli olabilir (ör. Loglar, Lablar...). Parametrelerle bir GeoDin yöntemi başlatır. Geçerli yöntem kimlikleri şurada açıklanmaktadır [Yöntemi çalıştır](#executemethod) ve içinde [Yöntem Parametreleri](#method-parameters). {% hint style="info" %} Fonksiyon yürütülürse dönüş değeri 0'dır. Bir hata oluşmuşsa dönüş değeri 1'dir. {% endhint %} ### Resim al Bir resim oluşturma işlevi. ``` fonksiyon Resim al(const Veritabanı, Kullanıcı adı, Şifre, ProjectID: WideString; LocationID: Tamsayı; const VersionName, LayoutFileName, OutFileName: WideString; ImageType, MaxResolution, Compression, Ölçek, PageNumber: Tamsayı; out PageCount: Tamsayı): OleVariant; ``` {% hint style="info" %} **Not:** Bu işlev yalnızca bir GeoDin Server Lisansı ile mevcuttur. Bu özellik resim sunucu modülünde mevcuttur. {% endhint %} | Parametre | Tasvir | | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `Veritabanı` | Veritabanı bağlantısı Adı, örn. "GeoDin COM Example" | | `Kullanıcı adı` | Veritabanı giriş adı (Access için bir boşluk karakteri ' ', boş bir dize değil!) | | `Şifre` | Veritabanı oturum açma Şifre (Access için bir boşluk karakteri ' ', boş dize yok!) | | `ProjeKimliği` | GeoDin Projesi Kimliği / tanımlama (6 karakter) | | `NesneKimliği` | GeoDin ID nesnesi / tanımlama numarası | | `VersiyonAdı` | Boş dize `''` veya gösterilecek sondaj loglarının / zemin profili ve kuyu tasarımının ilgili versiyonları. Bu Parametre yalnızca Bavyera bölgesel jeoloji otoritesinin (Landesamt) Nesne tipleri için desteklenir. `VersiyonAdı` ya sekme karakteri olmayan bir dize İçerikler - o zaman burada zemin profili versiyonunun Adı verilir - ya da `VersiyonAdı` iki dize, bir sekme karakteriyle bağlanmış halde İçerikler, o zaman bu zemin profili versiyonunun adı ve ardından kuyu tasarımı versiyonunun adı ile eşdeğerdir (`SVVersiyon+chr(9)+ASBVersiyon`). Bavyera Landesamt'e ait Nesne tipleri içinde, sürüm adları PKEY tarafından tanımlanır. | | `Düzen Dosya Adı` | Tamamen / eksiksiz Dosya adı ait Yerleşim planı Dosya, örn. `"C:\PROGRAMs\GEODIN\Yerleşim planları\BOREHO1.GLO"` veya `'C:\PROGRAMDATA\GEODIN\Yerleşim planları\BOHRPR1.GLO'` | | `Çıktı Dosya Adı` | Boş dize (dosya yok, oluşturulmaz) VEYA sonuçta oluşan JPG Resim Dosyası için Tamamen eksiksiz Dosya adı, ör. `"C:\SAMPLE1.JPG"` | | `Görüntü Türü` | `1` (=JPG); `2` (=JPG, eksik veriler VEYA yanlış Grafik öğeleri, Önizleme içinde benzer biçimde kesikli olarak görüntülenir); `11` (=PNG); `12` (=PNG, kesikli olarak görüntülenir); `21` (=EMF); `22` (=EMF, kesikli olarak görüntülenir); `31` (=WMF); `32` (=WMF, kesikli olarak görüntülenir) | | `MaksÇözünürlük` | Seçilen Düzen'e ait kağıt formatının en uzun kenarı için bitmap Resim Çözünürlük değeri, örn. 1500 | | `Sıkıştırma` | 0 Şuradan 100 şuraya olan Değerler Aralığı. JPG Resimler için kalite / sıkıştırmayı ve PNG Resimler için hız / sıkıştırmayı kontrol eder. Ayrıntılı Bilgi aşağıda verilmiştir. | | `Ölçek` | Düzendeki Nesnenin Düşey ölçeği (Düzen içindeki Ayarlar üzerine yazar; "Sayfaya sığdır" ve "Otomatik doğrulama" Seçenekleri etkilenmez ve Ölçeğin Otomatik ayarlanmasına yol açabilir; Düzen içindeki "şuradan oku" ön ayarları yoksayılır). | | `SayfaSayı` | Gösterilecek sayfa numarası | | `SayfaSayısı` | Seçildi Ölçek içindeki Mevcut Nesnenin görselleştirmesinin Sayfa numarasını döndürür | Fonksiyon, resmi OleVariant olarak döndürür, böylece OutFile üzerinden bir dolambaç gerekmez. ***Not:*** *Parametre `Sıkıştırma` oluşturma sırasında EMF veya WMF Resimler tarafından kullanılmaz.* Bir EMF Resim oluşturur İse, Parametre `MaksÇözünürlük` çözünürlüğü kontrol etmek için kullanılabilir. 0 aktararak EMF resmine ait çözünürlük dahili olarak Hesaplandı (GeoDin program kullanıcı arayüzünden yapılan doğrudan bir Gönder benzer). İse bir Değer `> 0` aktarılırsa EMF resmine ait Maksimum yatay Aralık, girilen Değer aşılmayacak şekilde uyarlanır. Ortaya çıkan Resim, girilen Değerden daha düşük bir yatay Aralığa sahip olabilir; çünkü EMF resmine ait Sınırlar (Boundary box), içerilen Grafik öğeleriyle hizalanır. Bu nedenle, aynı Düzen ile yapılan görselleştirme, farklı Sondaj kuyuları için farklı bir yatay Aralığa sahip EMF Resimler'e yol açabilirken, bitmap Resimlerin Aralığı eşittir, eğer bitmap Resimler oluşturulursa. **Parametre Sıkıştırma kullanılarak:** JPG: Kalite ve sıkıştırma * 0 = düşük kalite / yüksek sıkıştırma * 100 = yüksek kalite / düşük sıkıştırma ile örnek Büyüklükler `Maksimum Çözünürlük = 1500` bir A4 Sayfa için standart Düzen "Sondaj logu" ile: | Sıkıştırma | KB içinde Büyüklük | Yorum | | ---------- | ------------------ | ------------------------------- | | 0 | 48 | kullanılabilir değil | | 25 | 85 | çok yoğun şeritler | | 50 | 109 | belirgin şeritler | | 75 | 135 | iyi görüntü | | 85 | 157 | iyi görüntü | | 100 | 320 | çok Temizle Resim ama çok büyük | PNG: Hız ve sıkıştırma * 0 = çok zaman alıcı / yüksek sıkıştırma * 100 = çok hızlı / düşük sıkıştırma | Sıkıştırma | KB içinde Büyüklük | Yorum | | ---------- | ------------------ | ------------------------------- | | 0 | 42 | son derece zaman alıcı (>30 sn) | | 25 | 72 | verimli oluşturma (5 sn) | | 50 | 99 | hızlı oluşturma | | 75 | 157 | hızlı oluşturma | | 75 | 564 | çok büyük dosya | | 100 | 564 | çok büyük dosya | 70'in üzerindeki Değerler'in kullanılması doğru değil; kullanılan kütüphane bu PNG Verileri'ni aralıklı olarak hatalı oluşturur, bu nedenle Resimler, tüm (Hepsi) programlarda görüntülenemez. ### Çıktı dosyası al Fonksiyon şuraya bir Yazdır Dosyası Oluştur. ``` fonksiyon Çıktı dosyası al(const Veritabanı, Kullanıcı adı, Şifre, ProjectID: WideString; LocationID: Tamsayı; const VersionName, LayoutFileName, OutFileName, PrintDevice: WideString; PrintFileType, Ölçek, StartPageNumber, EndPageNumber: Tamsayı; out PageCount: Tamsayı): OleVariant; ``` {% hint style="info" %} **Not:** Bu işlev Resim sunucu ve Portal Sunucu modülleri içinde Mevcut. {% endhint %} | Parametre | Tasvir | | -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `Veritabanı` | Veritabanı bağlantısı Adı, örn. "GeoDin COM Example" | | `Kullanıcı adı` | Veritabanı giriş adı (Access için bir boşluk karakteri ' ', boş bir dize değil!) | | `Şifre` | Veritabanı oturum açma Şifre (Access için bir boşluk karakteri ' ', boş dize yok!) | | `ProjeKimliği` | GeoDin Projesi Kimliği / tanımlama (6 karakter) | | `NesneKimliği` | GeoDin ID nesnesi / tanımlama numarası | | `VersiyonAdı` | Boş dize `''` VEYA şuraya gösterilecek Sondaj Loglar ve Kuyu tasarımı ait sürümleri. Aynı genişletilmiş kuralları izler `VersiyonAdı` Parametre ait [Resim al](#getimage). | | `Düzen Dosya Adı` | Tamamen / eksiksiz Dosya adı ait Yerleşim planı Dosya, örn. `'C:\PROGRAMs\GEODIN\Yerleşim planları\BOREHO1.GLO'` | | `Çıktı Dosya Adı` | Ya boş dize (dosya yok) ya da ortaya çıkan yazdırma dosyası için Tamamen / eksiksiz Dosya adı, örn. `'C:\SAMPLE1.JPG'` | | `Yazdırma Aygıtı` | Çıkış aygıtına ait Ad. Çıkış aygıtları şuraya Konfigürasyon Dosya GEODIN.INI içinde yapılandırılmalıdır (bkz [Yazdır aygıtlarını yapılandırma](#configuring-print-devices) aşağıda). | | `Yazdırma Dosya Türü` | `1` (= bir Grafik Düzen Kullanım ait; diğer biçimlendirme şu anda desteklenmiyor değil) | | `Ölçek` | Yerleşim planı içinde Nesne ait Düşey ölçek (Yerleşim planı içinde Ayarlar'ın üzerine yazar) | | `Başlangıç Sayfa Numarası` | İlk sayfa yazdırıldı (`0` Hepsi için) | | `Son sayfa sayı` | Son sayfa yazdırıldı (`0` Hepsi için) | | `SayfaSayısı` | Seçildi ölçek içinde Mevcut Nesne'nin Sayfa sayı değerinin döndürülmesi | İse Parametre `Çıktı Dosya Adı` boş bir dize olarak aktarılırsa, işlev yazdırma dosyasını OleVariant olarak döndürür, diske yazmak yerine. **İşlevi kullanarak** Bu işlevle, yüklü bir Yazıcı sürücüsü kullanılarak bir yazdırma dosyası oluşturulabilir. Hangi sürücünün kullanılacağı, iletilen İkinci ad tarafından belirlenir, bu nedenle yazıcı sürücüsü COM çağrısını değiştirmek Hariç değiştirilebilir. `Yazdırma Aygıtı`COM çağrısını değiştirmeden Yazıcı sürücüsü değiştirilebilir. #### Yazdır aygıtlarını yapılandırma Kullanılabilecek yazıcı sürücüleri ayrı bir bölüm içinde şuraya yapılandırılmalıdır `[Yazdırma Aygıtları]` GEODIN.INI içinde Konfigürasyon Dosya: ``` [Yazdırma Aygıtları] PDF=Acrobat PDFwriter Win2PDF=Win2PDF SW=Canon GP300-405 PCL COL=\\UWG4\CLC900_Yazdır ``` Örnekte dört olası Yazıcı sürücüsü yapılandırılmıştır; bunların birinci ikisi PDF dosyaları oluşturmak için kullanılır. Her girişe ait sol üzerinde bulunan ikinci ad, şuraya aktarılması gereken şeydir `Çıktı dosyası al` Parametre içinde `Yazdırma Aygıtı` - örneğin dize `PDF` Acrobat PDF Writer'ı Kullanım için. Yazıcı sürücülerinin doğru adları en kolay şekilde Herhangi bir uygulamanın Yazdır iletişim kutusundan alınır, çünkü Sistem denetiminde gösterilen Yazıcı adları genellikle çıktı aygıtlarının doğru adlarından şuradan farklıdır. Aynı `[Yazdırma Aygıtları]` Bölüm sağlar `Yazdırma Aygıtı` Yazdır Yöntemi altında açıklanan Değerler [Grafiği yazdır VEYA Rapor et](#print-graphic-or-report). #### Spool zaman aşımı uyarısı Çünkü yazdırma Dosyası işletim Sisteminin yazdırma yöneticisi aracılığıyla oluşturulur, - Dosyanın geri OleVariant olarak istenmesi durumunda - geçici yazdırma Dosyasının oluşturulması, yazdırma yöneticisi bunu bildirmiş olsa bile henüz tamamlandı değil olabilir. Fonksiyonun Sonuçu o zaman yalnızca yazdırma Dosyasının bir kısmını içerir ya da geçici yazdırma Dosyasının açılamadığını belirten bir Hata Mesajı Yükseltilmiş olur. Bu zaman açısından kritik davranışı önlemek için, Parametreyi tanımlayın `SpoolTimeOut` Bölüm içinde `[Sistem]` GEODIN.INI'ye ait: ``` [Sistem] ... SpoolTimeOut=5 ... ``` Değer, fonksiyonun onu OleVariant olarak sunup çağrıyı sonlandırmadan önce yazdırma Dosyası'nın son tamamlanmasını beklediği saniye sayısıdır. ### Grafik genişliği ``` fonksiyon Grafik genişliği:tamsayı ``` Son kez Resim al çağrıldığında oluşturulan şeklin genişliğini döndürür. Fonksiyon yalnızca, çağrılan uygulamada bu parametreleri kendi başınıza çağırma imkânı yoksa kullanılmalıdır. ### Grafik yüksekliği ``` fonksiyon Grafik yüksekliği:tamsayı ``` Son kez Resim al çağrıldığında oluşturulan şeklin yüksekliğini döndürür. Fonksiyon yalnızca, çağrılan uygulamada bu parametreleri kendi başınıza çağırma imkânı yoksa kullanılmalıdır. ### Grafik sayfa sayısı ``` işlev Grafik sayfa sayısı:tamsayı ``` Resim al veya Çıktı dosyası al en son çağrıldığında oluşturuldu olan sayfanın numarasını döndürür. Her iki işlevin Sayfa sayısı çıkış parametresine ait değere şuraya eşittir. Çağıran uygulama, her iki işlevin çıkış parametresini işleyemiyor İse işlev yalnızca kullanılmalıdır. ### SysInfo Sistem bilgilerini şuraya belirleme işlevi. ``` işlev SysInfo(Param:string):OleVariant; ``` Bu işlev esas-Edition'dan itibaren kullanılabilir. Seçilen parametre üzerinde bağlı olarak sistem bilgilerini döndürür. Aşağıdaki parametreler kullanılabilir: 1. `SysInfo(GeODinINIFileName)`: Mevcut GeoDin.ini'ye ait tam yolu ve dosya adını döndürür. 2. `SysInfo(ProgramDataKlasör)`: program veri yolunu döndürür. 3. `SysInfo(UygulamaKlasör)`: uygulama klasörünü döndürür. ## Yöntem Parametreleri Aşağıdaki bölümler şunu açıklar `YöntemParametreleri` tarafından kabul edilen dizeleri [Yöntemi çalıştır](#executemethod) ve [Yöntem parametrelerini çalıştır](#executemethodparams) tek tek GeoDin Metodlar için (MethodID'leriyle tanımlanan). ### Veri yönetimi **MethodID = 1 (Veri yönetimi)** - `YöntemParametreleri`: A) Hayır Giriş Veri toplama başlatıldı (Genel veriler düzenleyicisi); eğer bu Yöntem zaten başlatılmışsa, Mevcut veri maskesi (Genel veriler, Katman verisi, vb.) etkin kalır. B) Şu biçime ait bir Parametre veri dizgesi sağlayarak istenen düzenleyici maskesinin seçilmesi: ``` [Params] EditType=sayı ``` Mevcut sayılar şunlardır: | sayı | Düzenleyici maskesi | | ---- | ----------------------------------------------------------------------------- | | 1 | Genel veriler | | 2 | Katman verisi | | 3 | Örnek veri | | 4 | Kuyu tasarım datası | | 5 | Veri dizileri | | 6 | Ek olarak veriler (1:n), nesne tipine bağlı olarak, örn. yeraltı suyu tablosu | ### Grafiği düzenle **MethodID = 2 (Grafiği düzenle)** - `YöntemParametreleri`: A) Hayır Giriş Standart yerleşim planı listesi açılır. Yerleşim planı listesinin mevcut yerleşim planı gösterilir. B) Bir (yerleşim) dosya adı girişi, nesneyi göstermelidir. C) `"Düzen:Düzenadı"` Standart yerleşim planı listesi açılır ve "düzenadı" seçildi. İsteğe bağlı olarak kullanılacak yerleşim planı listesi, yol olarak tanımlanabilir: ``` örn.: "Düzen:Düzenadı|c:\\programs\\geodin\\syslib\\geo.gll" ``` E) `"Rapor:Raporadı"` Standart yerleşim planı listesi açılır ve "reportname" raporu Seçildi. İsteğe bağlı olarak, kullanılacak yerleşim planı listesi yol olarak belirtilebilir: ``` örn.: "Rapor:Raporadı|c:\programme\geodin\syslib\geo.gll" ``` ### Açık grafik **Yöntem Kimliği = 4 (Açık grafik)** - `YöntemParametreleri`: Bir GeoDin grafiği, düzeni veya düzen listesinin tam yol adı beklenir. Dosya grafik penceresinde açılır. ### Ölçüm verilerini İçe aktar **Yöntem Kimliği = 12 (Ölçüm değerleri İçe aktar)** - `YöntemParametreleri`: ``` [Params] Veritabanı= Kullanıcı adı= Şifre= DatType= İçe aktarTip=<İçe aktar Tip DBF_Satır,CSV_Satır,ACC_Satır> İçe aktarKomutDosya= İçe aktarVeriDosya= | İçe aktarRaporDosya= ``` Verilerin Adları Tamamen Uzunluk yol olarak beklenir. ``` [Veri Kaynağı] İçe aktarFormat= GrupAlan1= GrupAlanın= Parametre Alanı= Değer Alanı= MesPointBağlantısı= [MesPointBağlantısı] = ... ... [ParametreBağlantısı] = ... ... [İçeAktarmaSeçenekleri] KayıtlarıEkle=Doğru KayıtlarıGüncelle=Yanlış KayıtlarıAra= GüncellemeTürü= SayılarıYuvarla=Yanlış MetniKes=Yanlış MantıklılıkHatalarınıYoksay=Yanlış KayıtDeğişiklikleriniHesapla=Yanlış AyrıntıProtokolü=Doğru ``` ### Grafiği yazdır VEYA Rapor et **YöntemID = 13 (Grafiği yazdır VEYA Rapor et)** - `YöntemParametreleri`: Giriş yok: Yazdırma, Mevcut Yazıcı üzerinde bir yazdırma iletişim kutusu olmadan yapılır. Eğer hiçbir Grafik açık değilse (ayrıntı görünümü veya Yerleşim planı genel görünümü) ya da Yerleşim planı genel görünümünde Düzen ile bağlantılı Nesneler yoksa, hiçbir şey yazdırılmaz ve hata numarası 16 döndürülür. Yazdırma çıktısı isteğe bağlı olarak bir Parametre bloğu girilerek yapılandırılabilir: ``` [YazdırmaSeçenekleri] YazdırmaİletişimKutusuGöster=Doğru Bir yazdırma iletişim kutusu görüntülenir YazdırmaAygıtı=Aygıt Adı Kullanılacak Yazıcı YazdırmaDosyaAdı=Dosya Adı Seçildi dosyaya yazdır ``` **Aygıt Adı:** Kullanılacak Yazıcı için, GEODIN.INI içinde yazıcı bilgileri içeren bir Bölüm girilmelidir. Örnek: ``` [Yazdırma Aygıtları] PDF=Acrobat PDFwriter Win2PDF=Win2PDF SW=Canon GP300-405 PCL ``` Bu Bölümün daha ayrıntılı Tasvirini şurada bulabilirsiniz [Yazdır aygıtlarını yapılandırma](#configuring-print-devices) işlevinde [Çıktı dosyası al](#getprintfile). `Aygıt Adı` bu Konfigürasyon bölümünün geçerli bir Girişini İçerikler. **Dosya Adı:** Eğer "PrintFileName" Parametresini kullanırsanız, tam bir Dosya adı girin. Aynı ada sahip mevcut bir dosyanın Üzerine yazıldı. Örneğin, bir PDF-Dosyası oluşturmak için Yazdırma işlevini kullanmak istiyorsanız, Parametre bloğu şöyle görünürdü: ``` [YazdırmaSeçenekleri] YazdırmaAygıtı=Win2PDF YazdırmaDosyaAdı=C:\GEODINPrints\Ausdruck1.PDF ``` ### Eklentiyi başlat **YöntemID = 14 (Eklentiyi başlat)** - `YöntemParametreleri`: En azından şu Girişi İçerikler bir Konfigürasyon bloğu aktarılmalıdır: ``` [Params] Eklenti= ``` Olarak **Ad** eklenti işlevinin ayırt edici Adı girilmelidir. ***Not:*** *Buradaki konu, Nesne yöneticisinde Eklentilerin adı olarak Görünür olan "Ad" Parametresi değildir,* [*Eklentiler*](/geodin-desktop/tr/entegrasyonlar-ve-eklentiler/installing-plug-ins.md)*ancak bu eklentinin Konfigürasyon bölümünün Adı. Eklenti, Nesne yöneticisindeki Mevcut dal (düğüm) için konfigüre edilmiş ve çalıştırılabilir olmalıdır. Yöntem listesinde de gizlenebilir (eklenti konfigürasyonundaki "Sakla" Parametresi).* İsteğe bağlı olarak Konfigürasyon bloğu, "PluginParams" adıyla başka bir bölüm ve herhangi bir Parametreler içerebilir. Örnek: ``` [Params] Eklenti=Özel işlev [EklentiParametreleri] Param1=Benim Parametre 1 Param2=Benim Parametre 2 ..... ``` Bu Konfigürasyon bölümü eklentiye (yalnızca COM sunucu Eklentileri) tamamen aktarılır ve GeoDin tarafından analiz edilmez. Bu nedenle herhangi bir Parametre COM işlevi üzerinden çağrı yapılarak eklentiye aktarılabilir. ### Ölçümleri kontrol et **MethodID = 53 (Ölçüm değerlerini kontrol et)** - `YöntemParametreleri`: "Gerileme" bölümünü, ölçüm değerlerini bir gerileme analizi kullanarak kontrol etmek için kullanın. Değer `Düzen` Kullanılacak gerileme grafiğinin adını içerir. Bu yönteme ilişkin daha fazla Bilgi bölümde bulunabilir. [Ölçümleri kontrol et](/geodin-desktop/tr/veri-analizler/data-checks-and-validations.md) ve açıklamada [Geri çekilme hesaplaması](/geodin-desktop/tr/veri-analizler/regression-and-curve-fitting.md) zaman serisi öğesinin. **Örnek:** ``` [Gerileme] Düzen=AnalizlerLayout1 ``` --- # 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/entegrasyonlar-ve-eklentiler/overview-1/method-reference.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.