COM API

Übersicht

Übersicht

COM-Funktionen und Plugins

GeoDin bietet die Möglichkeit, GeoDin mit externen Anwendungen zu verbinden. Dieses Kapitel beschreibt die technischen Methoden und richtet sich an Softwareentwickler, die dabei sind, GeoDin mit anderen Produkten zu kombinieren oder Spezialfunktionen in GeoDin zu integrieren.

Für den Betrieb von GeoDin durch eine externe Anwendung sind mehrere Funktionen Verfügbar. Ein Teil dieser Funktionen wird zur Steuerung der GeoDin-Programmschnittstelle verwendet (in diesem Fall ist GeoDin für den Benutzer Sichtbar), aber eine externe Anwendung wie zum Beispiel ein GIS wählt selbstständig ein Objekt im GeoDin-Objektmanager aus und startet ein GeoDin-Verfahren. Ein anderer Teil der Funktionen wird verwendet, um Informationen aus der Datenbank von GeoDin bis hin zu Grafik-Bildern von Objekten bereitzustellen. Hier ist GeoDin normalerweise Unsichtbar und erledigt seine Aufgaben im Hintergrund. Die einzelnen Funktionen werden im Kapitel #GeoDinHelpLink:COM-Funktionen5284#. Für jede Funktion ist definiert, welche GeoDin-Edition Pflichtfeld ist.

Andererseits ist es möglich, externe Anwendungen oder Funktionen in die Programmschnittstelle von GeoDin zu integrieren. Solche Funktionen (sogenannte Plugins) können zum Beispiel Spezialberechnungen oder Datenexporte durchführen und werden in GeoDin mit einem Methodensymbol angezeigt. Eine Beschreibung zum Einbetten und Konfigurieren dieser externen Funktionen ist im Kapitel #GeoDinHelpLink:Plugins5285#.

COM-Funktionen

Tipps für die Benutzung von GeoDin als COM-Server

Die Verwendung von GeoDin als COM-Server (durch Erstellen eines Objekts von der Art GeoDin.GeoDinApplication) kann mit den folgenden Parametern gesteuert werden:

Arbeitsverzeichnis von der Anwendung GeoDin:

Als Standard wird das Verzeichnis "TEMP" im Verzeichnis "allgemeine Einstellungen" von des aktuell Benutzers als das verwendete Arbeitsverzeichnis der Anwendung GeoDin im Startmodus als COM-Server verwendet. Durch Eingabe von ExecutePath=Verzeichnis in der Sektion [System] von der #GeoDinHelpLink:Konfigurationsdatei GeoDin.ini3297# ein weiteres Verzeichnis kann definiert werden.

Einfg von plug-ins:

Als Standard #GeoDinHelpLink:Plugins5285# werden nicht geladen, wenn GeoDin Gestartet ist. Durch Eingabe von COMServerPlugins=Wahr in der Sektion [System] von der #GeoDinHelpLink:Konfigurationsdatei GeoDin.ini3297# das Laden des Plug-ins kann erreicht werden.

Anwendungsverzeichnis von GeoDin:

Das Anwendungsverzeichnis von GeoDin ist standardmäßig das Verzeichnis eine Ebene höher als das BIN-Verzeichnis (in dem die GeoDin.exe enthalten ist). Eine typische GeoDin-Installation hat die folgende Struktur:

C:\Programs\GeoDin (enthält GeoDin.ini)

C:\Programs\GeoDin\BIN (enthält GeoDin.exe)

C:\Programs\GeoDin\SYSLIB

C:\Programs\GeoDin\QUELLE

usw.

Das Anwendungsverzeichnis ist in diesem Fall <C:\Programs\GeoDin>, von wo auch die Konfigurationsdatei GeoDin.ini gelesen wird. Mit diesem Namen werden auch die Namen mehrerer Unterverzeichnisse erstellt (z. B. für QUELLE, QUERYDEF, LAYOUTS usw.)

Es ist möglich, das Anwendungsverzeichnis von GeoDin auf ein beliebiges anderes Verzeichnis zu konfigurieren, sodass man unterscheiden kann, wenn GeoDin direkt als Anwendung durch den Benutzer gestartet wird oder als COM-Server instanziiert ist. Für einen ("normalen") Start von GeoDin durch den Benutzer kann das Anwendungsverzeichnis über einen Befehlszeilenparameter gesetzt werden. Er muss mit dem Schlüsselwort -af beginnen und anschließend einen vollständigen Verzeichnisnamen enthalten.

C:\Programs\GeoDin\BIN\GeoDin.exe -afC:\Programs\GeoDin\Solutions\Water

Hinweis: Wenn der Verzeichnisname Leerzeichen enthält, muss der gesamte Parameter in Anführungszeichen gesetzt werden, z. B.:

C:\Programs\GeoDin\BIN\GeoDin.exe "-afC:\Programs\GeoDin Solutions\Water"

Durch das Starten von GeoDin als COM-Server ist ein Befehls Linie Parameter nicht möglich. Deshalb wurde ein Verfahren vorbereitet, um dies über die Registry einzugeben. Hier muss der Name des ausgewählten Anwendungsverzeichnisses VOR dem Start des COM-Servers im REG_SZ-Schlüssel "ApplicationFolder" im folgenden Registry-Schlüssel platziert werden:

[HKEY_CURRENT_USER\Software\GeoDin-System\COMServer]

Bei beiden Methoden prüft GeoDin das Vorhandensein des Verzeichnisses und ignoriert die Einstellung, wenn es es nicht findet. Weitere Prüfungen finden nicht statt. Stellen Sie sicher, dass das selektierte Verzeichnis eine Konfigurationsdatei GeoDin.ini und alle von GeoDin erforderlichen Unterverzeichnisse enthält.

Plugins

Plugins sind externe Module (Programme / COM-Server), die von der GeoDin-Benutzeroberfläche aus aufgerufen werden. So kann ein Softwareentwickler den Start einer bestimmten Anwendung, zum Beispiel eine spezielle Exportieren-Funktion oder ein neues Verfahren zur Berechnung, in die GeoDin-Programmbenutzeroberfläche integrieren. Für den Benutzer erscheint die Anwendung als eine "gewöhnliche" GeoDin-Methode. Alle Pflichtfeld Informationen für das selektierte Objekt(e) werden an das Plug-in im GeoDin-Objektmanager übertragen. So können zusätzlich Analysefunktionen für eine selektierte Menge von Objekten vom Plug-in angeboten werden. Ein Plug-in kann auch eine Anwendung sein, die nicht mit der GeoDin-Datenbank arbeitet. Die Plug-in-Konfiguration kann auch den "Rechner" aus dem Betriebssystem in die Programmbenutzeroberfläche von GeoDin integrieren.

Ein Plug-in kann als Anwendung (EXE-Datei) oder als COM-Funktion von einem registrierten COM-Server aufgerufen werden. Hier der Parameter Ausführen oder Server in der Plug-in-Konfiguration. Ein COM-Server, der als Plug-in aufgerufen werden soll, hat bestimmte Voraussetzungen zu erfüllen, die unten beschrieben werden.

Definition von einem Plug-in

Die Einstellung und Konfiguration der Plugins, die Sie Benutzen Sie, erfolgt in der Konfigurationsdatei GeoDin.INI.

Mit GeoDin 9 werden Plugins im System-Tab in der Systemkonfiguration unter der Sektion „Publikationen“ definiert.

1. Liste der Verfügbar Plug-ins

In der Sektion [Plugin] wird jedes Plug-in mit einer Linie definiert und erhält einen Namen, Beispiel:

[Plugins]

Plugin1=Berechnen

Plugin2=Exportieren

Hinweis: Möglicherweise muss die Sektion [Plugins] erstellt werden, wenn keine Vorige Plug-ins konfiguriert wurden. Hinzufügen Sie eine Linie mit [Plugins] mit einem Volltexteditor am Ende der Datei GeoDin.INI und mindestens eine Zeile wie Plugin1=Name des Plug-ins. Benutzen Sie aufeinanderfolgende Nummern (Plugin1=, Plugin2= usw.) für die Definition von mehr als einem Plug-in.

2. Definition eines einzelnen Plug-ins von der Liste

Für jedes in der Liste [Plugins] eingetragene Plug-in muss eine separate Sektion in der Konfigurationsdatei GeoDin.INI erstellt werden, die den in Schritt 1 definierten Namen des Plug-ins enthält, Beispiel:

[Berechnen]

Name=Berechnen

Ausführen=C:\PROGRAMS\GeoDin\BIN\GPI.EXE

oder

Server=GeoDinPlugin.GeoDinPluginSample

Modul=Modul1

Symbol=C:\PROGRAMS\GeoDin\BIN\CALC.ICO

Popup=Falsch

Warten=Falsch

DBNode1=1

DBNode2=2,1

Fügen Sie mit dem Volltexteditor die betreffenden Zeilen in die Datei GeoDin.INI ein.

Die Parameter in dieser Sektion steuern, auf welche Objekte (im GeoDin-Objektmanager) das Plug-in angewendet werden soll, welche Programmdateni oder welche COM-Server-Funktion ausgeführt werden soll und ob der Benutzer auf die Ausführung der Funktion warten muss.

Die folgenden Parameter sind festgelegt:

Name

Name des Plug-ins im GeoDin-Objektmanager (Diese Namen werden unter dem Methodensymbol oder im Popup-Menü angezeigt)

Ausführen

Ausführbares Programm (vollständiger Dateiname mit Pfad)

Beispiel: C:\WINDOWS\SYSTEM32\CALC.EXE)

oderServer

Name des COM-Servers, der die ausgewählte Funktion ausführen soll.

Beispiel: GeoDinPlugin.GeoDinPluginSample

DBNode1..n

Liste der Knoten im GeoDin-Objektmanager Datenbanken, bei denen das Plug-in gestartet werden kann. Hier wählen Sie aus, bei welchen Knoten (Zweige und Status von Knoten) der Plug-in-Aufruf möglich sein soll. Dies geschieht durch Auswahl einer Liste von Zweigdefinitionen beliebiger Länge, die durch eine Eingabe DBNodexx festgelegt werden sollte. Benutzen Sie die fortlaufenden Nummern (DBNode1=, DBNode2= usw.) für die Definition mehrerer Knoten, Beispiel:

Beispiel 1:

DBNode1=3,2,1

Bedeutung: Das Plug-in wird auf einem Projektknoten angezeigt. Das Projekt muss bereits geöffnet sein und in einer OneTableSet-Datenbank enthalten sein.

Beispiel 2:

DBNode1=3,Boreholedatabase,1

Bedeutung: Das Plug-in wird nur auf geöffneten Projekten der Datenbanken "Boreholedatabase" angezeigt.

Beispiel 3:

DBNode1=3, Boreholedatabase,0,P00001

DBNode2=3, Boreholedatabase,0,P00002

Bedeutung: Das Plug-in wird auf den Projekten mit der Projekt-Kennung P00001 oder P00002 der Datenbanken "Boreholedatabase" angezeigt. Es ist nicht wichtig, ob die Projekte geöffnet oder geschlossen sind.

Beispiel 4:

DBNode1=9,2,0,,2,JPG

Bedeutung: Das Plug-in wird in allen SQL-Datenbanken mit OneTableSet-Einstellung in den Dokumenten vom Typ JPG an der zweiten Position der Methodenliste angezeigt (nach der Methode 'Voransicht').

Syntax von der Definition DBNodeX=

Die Kennung muss zwingend eingegeben werden, weitere Parameter können durch Kommas getrennt hinzugefügt werden.

DBNode1..n=Kennung[,Param1][,Param2][,...]

Kennung Das Plug-in wird am Objekt ...

1 Datenbanken

2 Datenbank

3 Projekt

4 Abfrage oder Gruppe im Zweig Objekte

5 Abfrage oder Gruppe im Zweig Messpunkte

6 Objekt

7 Messpunkte Objekt

8 Dokumentverzeichnis

9 Dokument

Param1 Das Plug-in wird auf den Objekten angezeigt, die durch die Kennung in einer Datenbank in ... definiert sind

0 Alle Datenbanken

1 für Kennung=1 wird das Plug-in nur angezeigt, wenn derzeit keine Datenbank konfiguriert ist

für Kennung=2 nur in SQL-Datenbanken (keine dateibasierten Datenbanken)

2 nur in SQL-Datenbanken mit OneTableSet-Einstellung

Name nur in der betreffenden Datenbank mit dem eingegebenen Namen

Param2 Das Plug-in wird auf den Objekten angezeigt, die durch die Kennung in einer Datenbank definiert sind ...

0 unabhängig davon, ob die Datenbank oder das Projekt geöffnet ist

1 nur, wenn die Datenbank oder das Projekt geöffnet ist

2 nur, wenn die Datenbank oder das Projekt geschlossen ist

Param3 Das Plug-in wird auf den Objekten angezeigt, die durch die Kennung in einer Datenbank definiert sind ...

Leer in allen Projekten

PRJID nur in Projekten mit der eingegebenen Kennung

Param4 Das Plug-in wird in der Methodenliste an einer voreingestellten Position angezeigt...

Leer oder 0 am Ende der Liste (nach den GeoDin-Methoden)

1..n Am eingegebenen Position, z. B. 1 - Das Methodensymbol wird am Objekt auf der 1. Position angezeigt

Param5 Das Plug-in wird nur für Kennung=9 auf Dokumente der folgenden Art angezeigt ...

Leer auf Alle Dokumenttypen

JPG nur auf Dokumente von dieser Art (hier Beispiel: JPG Bilder)

Modul (optional)

Geben Sie das Programm-Modul im Plug-in an; dieser Name wird als Parameter an das ausführbare Programm oder die COM-Funktion übergeben. Wenn kein Modulname eingegeben ist, bleibt der Übertragungsparameter leer. Über diese Option ist es möglich, dass eine einzelne Anwendung oder COM-Serverfunktion unterschiedliche Aufgaben ausführen kann, die durch die Modul-ID gesteuert werden. Mehrere Funktionen können in einer externen Anwendung durch Verwendung von Modulnamen kombiniert werden, weil es erlaubt ist, mehrere Plug-ins mit derselben Anwendungsdatei oder COM-Serverfunktion zu verbinden. Durch die Übergabe des Modulnamens als Parameter können in der externen Anwendung oder Funktion verschiedene Prozesse aktiviert werden. In diesem Fall können unterschiedliche Funktionen über den Parameter "Icon" auf verschiedene Symbole ausgerichtet werden.

Symbol (optional)

Vollfarbe Dateiname von einer ICO-Datei für die Anzeige des Methodensymbols im Verfahren-Manager. Wenn dieser Parameter nicht eingegeben ist, wird das Symbol des ausführbaren Programms verwendete (nicht möglich für COM-Server). Wenn das Programm kein Symbol enthält, wird ein Normsymbol verwendete.

Popup (optional)

Verfahren wird nur als Popup-Menü angezeigt (klicken Sie mit der Rechtes Maustaste auf das Objekt im GeoDin-Objektmanager). Setzen Sie die Werte auf =wahr, wenn das Plug-in nicht als Methodensymbol erscheinen soll, sondern nur im Popup-Menü; der Norm-Wert ist =falsch -> Symbol im Verfahrensmanager.

Warten (optional)

Steuert, ob GeoDin warten soll, um die Funktion im Plug-in Ausführen zu lassen. Für Anwendungen (EXE-Dateien) den Wert auf =Wahr setzen, wenn die Funktion abgeschlossen sein soll, um in GeoDin weiterzuarbeiten. Der Normwert dieses Parameters ist =Falsch.

Hinweis: Wenn ein COM-Server verwendet wird, wartet GeoDin Immer, bis die Funktion beendet wurde.

Offene Methoden zulassen (optional)

Definiert, ob das Plug-in ausgeführt werden kann, Wenn es Öffnen-Methoden gibt (z. B. Datenerfassung). Die Standard-Einstellung erlaubt es dem Plug-in, ausgeführt zu werden: setzen Sie den Parameter auf =Falsch, zu verhindern dies (in diesem Fall wird eine Warnung angezeigt).

Nicht darstellen (optional)

Steuert, ob das Plug-in im Verfahren-Manager sichtbar ist (als Symbol oder Popup-Menü). Standardmäßig ist es Sichtbar. Setzen Sie den Parameter Nicht darstellen auf =Wahr, zu das Plug-in auszublenden. Dann kann das Plug-in nur über den #GeoDinHelpLink aufgerufen werden:COM-Funktion5284# "ExecuteMethodParams".

Nach dem Erweitern ausführen (optional)

Legt fest, ob das Plugin beim Öffnen der Verzweigung beim erster Mal automatisch ausgeführt wird. Setzen Sie den Parameter =true, um das Plugin automatisch zu starten. Die durch den Parameter Nicht darstellen hide=true ausgeblendeten Plugins können automatisch gestartet werden. Auf diese Weise ist es möglich, eine Funktion aufzurufen

nicht vom GeoDin Benutzer, sondern wird automatisch ausgeführt, wenn dieser Zweig geöffnet wird (zum Beispiel nach dem Öffnen der Datenbank).

RefreshDatabaseDictionaries (optional)

Dies legt fest, ob nach der Ausführung des Plug-ins die Datenbank Wörterbücher entladen werden. Wenn nötig, werden diese automatisch neu geladen.

Eine Anwendung (EXE-Datei) als Plug-in verwenden

Um eine Anwendung als Plug-in zu verwenden, müssen Sie den Parameter Ausführen=vollständiger Pfadname der Anwendung in der Definition des Plug-ins eingeben. GeoDin startet die Anwendung, wenn das Verfahren aufgerufen wird, und überträgt alle Pflichtfeld-Parameter des selektierten Zweigs im GeoDin-Objektmanager. Mit diesen Daten kann das Plug-in spezielle Ausführungsoperationen für diese Objekte durchführen. Die Parameter werden über die Befehlszeile an die Anwendung übergeben. Abhängig vom selektierten Zweig im GeoDin-Objektmanager variiert die Zahl der Parameter, was in der folgenden Tabelle gezeigt wird:

Parameter Art Inhalt Kennung=1 Kennung=2 Kennung=3 Kennung=4-9

1 Zeichenfolge Modulname oder Leer X X X X

2 Ganzzahl Bildschirm Position Links X X X

3 Ganzzahl Bildschirmposition auf X X X

4 Ganzzahl Kennung von der Verzweigung X X X X

5 String Datenbankname *1 - X X X

6 String Registrierungsname der Datenbank - X X X

7 String Passwortdatenbank *2 - X X X

8 String Projektkennung GeoDin - - X X

oder String "DB"

für eine Verzweigung unten

eine Datenbankabfrage

9 String Abhängig von der - - - X

ODER Ganzzahl-Kennung-Auswahl

Die Art der Parameter 9 hängt von der Kennung des Zweigs ab, von dem aus das Plug-in gestartet wird:

Kennung Parameter 9

1,2,3 Leer

4 Dateiname einer temporären Datei mit PRJ_Kennung und LOCKennung der Objekte

5 Dateiname einer temporären Datei mit Zeichenkette von den INVIDs der Objekte

6 PRJ_Kennung UND LOCKennung von dem selektierten Objekt

7 INVID von dem selektiert Objekt als String

8 Dateiname einer temporären Datei mit Ganzzahlen der ADC_IDs von Dokumente

9 ADC_Kennung von den Dokumente

*1 Datenbankname: Zusätzlich zum Datenbanknamen enthält diese Zeichenfolge auch die Art der Verbindung (ADO oder FireDAC) und die Verbindungszeichenfolge selbst.

*2 Das Passwort kann Teil der Verbindungszeichenfolge sein, z. B. für Systemdatenbanken oder für Verbindungen mit einem gespeicherten Passwort. In diesem Fall ist die Zeichenfolge leer. Das Passwort muss direkt aus der Verbindungszeichenfolge extrahiert werden.

Wenn ein Dateiname mit den Ids der Objekte an die Plug-ins übertragen wird, ist das Plug-in dafür verantwortlich, diese Datei zu löschen! Wenn die Datei nicht gelöscht wird, verbleibt sie im Verzeichnis TEMP des aktuell Benutzer.

Die Datei mit den IDs enthält so viele Zeilen, wie Objekte in der Abfrage oder Gruppe enthalten sind.

Am Zweig Kennung = 4 enthält jede Linie die PRJID und LOCID, getrennt durch Kommas (Beispiel: PRJ001,3).

Am Zweig Kennung = 5 enthält jede Linie die INVID (Beispiel: PRJ0010004FIL001).

Am Zweig mit Kennung = 8 enthält jede Linie die ADC_Kennung (Beispiel: 23).

Die Parameter 1 und 2 der „idealen“ Fensterposition zulassen die Positionierung des Fensters der externen Anwendung analog zu den GeoDin Methoden am Rechtes Seite unterhalb des Methodensymbols oder der Popup-Menü Eingabe.

Verwendung eines COM-Servers als Plug-in

Um einen COM-Server als Plug-in zu Benutzen Sie müssen Sie den Parameter Server=Vollfarbe name von der COM-Server-Schnittstelle in der Definition von dem Plug-in eingeben. Der Vollfarbe Name besteht aus dem Namen von dem COM-Server und dem Namen von der Schnittstelle, die durch einen Punkt getrennt sind, z. B. GeoDinPlugin.PluginInterface

Die Schnittstelle muss eine Funktion mit dem Namen GeoDinExecutePlugin bereitstellen, die einen String als Übertragungsparameter empfängt und einen OleVariant-Parameter zurückgibt:

function GeoDinExecutePlugin(const Params: WideString): OleVariant;

Hinweis: Die Syntax der Definition der Funktion hängt von der Programmiersprache ab, in der das Plug-in erstellt wird.

Der in params übertragene String hat die Struktur einer Konfigurationsdatei mit den folgenden Abschnitten und Parametern:

[Params] Allgemeine Parameter

Links= X ideale Position einer Methode, die ein Fenster anzeigt

Oben= Y ideale Position einer Methode, die ein Fenster anzeigt

Modul= Modulname (Von GeoDin.ini)

DBNode= Kennung des selektierten Zweigs

SolutionName= Name der GeoDin-Lösung (Wenn installiert)

SolutionVersion= Version der GeoDin-Lösung (wenn installiert)

Datenbank= Datenbankname: ADOConnection

Benutzername= Benutzerkennung

Passwort= Datenbank-Passwort

Owner= Name des Eigentümers der Datenbanktabelle

PRJID= Projekt-Kennung ODER "DB"

QueryName= Name der Abfrage, in der die selektierten Objekte enthalten sind

[Objekte] Liste der Objekt-Kennungen der selektierten Objekte

Kennung1

Kennung2

...

[Abfrage] Sektion mit Elementen von der Abfrage (nur für Systemabfragen)

Auswählen= Auswählen eines Teils von einem SQL-Befehl

Von= Von Teil eines SQL-Befehls

Where= Where-Teil von einem SQL-Befehl

Bestellen nach= Bestellteil von einem SQL-Befehl

Erklärung:

Die Position kann vom Plug-in verwendet werden, um einen Dialog zu platzieren, der den Positionen für GeoDin-Methoden entspricht. Der Parameter DBNode enthält die Kennung des selektierten Zweigs (siehe Bezeichnung von DBNode oben). Die Datenbankverbindung wird durch den Datenbanknamen angegeben (bestehend aus Name und Verbindungszeichenfolge, getrennt durch einen Doppelpunkt), Anmeldeinformationen (für SQL-Datenbanken) und gegebenenfalls den Eigentümernamen. Der Parameter PRJID wird von der GeoDin-Projektkennung belegt, wenn die selektierten Zweige unter einem Projekt liegen; andernfalls enthält dieser Parameter den festen String "DB".

Art der Objekt-ID:

Objekte: PRJ_Kennung und LOCKennung, getrennt durch Kommas

Messpunkte: INVID als Zeichenkette

Dokumente: ADC_Kennung von Dokumente

Wenn Systemabfragen verwendet werden, werden die Eigenschaften der SQL-Befehle, die die Eingabe der Objekte im Objektmanager verursacht haben, in der Sektion "Abfrage" übertragen.

Der Rückgabewert der Funktion ist für weitere Erweiterungen reserviert. Der Wert sollte auf NULL gesetzt werden, da er im Moment nicht zurückgegeben wird.

Plug-in zum Erstellen von Berichten

Neben der Ausführung von Plug-ins als Verfahren im GeoDin-Objektmanager können Plug-ins außerdem verwendet werden, um Berichte zu erstellen. Diese Art von Plug-ins kann in Layouts und Grafiken verwendet werden, um eine sehr spezielle Art von Bericht in einer Grafik zu realisieren. Um ein solches Plug-in zu entwickeln, ist eine komplexe Aufgabe, weil eine GeoDin-Klasse im XML-Papierformat erstellt und als Parameter zu der Funktion zurückgegeben werden muss. Eine Bezeichnung einer GeoDin-Klasse im XML-Papierformat ist hier nicht enthalten (Informationen werden auf Anfrage bereitgestellt) es wird hier nur die Einstellung von Bericht-Plug-ins beschrieben:

1. Liste von Verfügbar Bericht-Plugins

In der Sektion [ReportPlugins] wird jedes Plug-in durch eine Linie definiert und erhält einen Namen.

Beispiel:

[ReportPlugins]

Plugin1=Sonderbericht

2. Definition eines einzelnen Bericht-Plugins von der Liste

Für jedes in der Liste [ReportPlugins] definierte Plug-in muss eine separate Sektion in der Konfigurations Datei GeoDin.INI mit dem Namen des in Schritt 1 definierten Plug-ins erstellt werden.

Beispiel:

[Sonderbericht]

Name=Spezialbericht Wasser

Server=GeoDinReportPlugin.GeoDinReportPluginSample

Modul=Modul1

ExecuteWithOutData=falsch

Name: Berichtname bei dem Grafikelement "Bericht"

Server: Schnittstellenname von dem COM-Server

Modul: optionaler Modulname

ExecuteWithOutData: Auswahl / Selektion von der Ausführung Art von dem Plug-in

Der Modulname wird an das Plug-in übertragen, damit verschiedene Berichte in einer COM-Funktion erstellt werden können. Durch das Festlegen der Option ExecuteWithOutData=false wird das Plug-in von GeoDin gestartet, wenn die Grafik ein Layout ohne Datenverbindung ist. Durch das Festlegen der Option ExecuteWithOutData=true startet es nur in einer Grafik mit verbundenen Daten.

Benutzen Sie einen COM-Server als Bericht-Plug-in, geben Sie in der Definition von des Plug-ins den Parameter Server=Vollfarbe-Name von der COM-Server-Schnittstelle ein. Der Vollfarbe-Name besteht von dem Namen des COM-Servers UND dem Namen von der Schnittstelle, die durch Kommas getrennt sind, z. B. GeoDinPlugin.PluginInterface

Die eingegebene Schnittstelle muss eine Funktion mit dem Namen GeoDinGetGraphicReport bereitstellen, die einen String als Übergabeparameter UND einen OleVariant als Rückgabeparameter zu empfangen hat:

Funktion GeoDinGetGraphicReport(const Params: WideString): OleVariant;

Hinweis: Die Syntax der Definition der Funktion hängt von der Programmiersprache ab, in der das Plug-in erstellt wird.

Der String, der in params übertragen wird, hat die Struktur einer Konfigurationsdatei mit den Abschnitten und Parametern wie oben für die Server-Plugins beschrieben. Als Rückgabe ein XML

Datenstrom gemäß zu der GeoDin-Klasse C_GraphicDrawReport wird erwartet.

Ausnahmewert

Funktionen zu identifizieren den Fehlerstatusfunktion ExceptionValue:Ganzzahl;

Diese Funktion zeigt den Fehlerstatus der zuvor aufgerufenen Funktion an. Der Rückgabewert ist 0, wenn die zuvor aufgerufene Funktion korrekt funktioniert hat. Die möglichen Fehlernummern sind am Ende des Dokuments beschrieben.

function ExceptionMsg:string;

(Norm-Ausgabe Pflichtfeld)

Rückgabe von dem Fehlertext eines zuvor fehlgeschlagenen Funktionsaufrufs. Wenn ExceptionValue <>0 kann die Vollfarbe Fehlermeldung mit dieser Funktion abgefragt werden.

Fehlernummern

Die Fehlernummern sind für alle Funktionen festgelegt.

1

Systemfehler (Systemressourcen sind abgenutzt o. Ä.)

2

Funktion nicht lizenziert

3

Initialisierungsfehler (COM-Server hat NICHT ODER unvollständig gestartet)

4

Layout-Datei (Parameter LayoutFileName) oder das Layout / Bericht des Layoutliste kann nicht geladen werden (falscher Name, Datei fehlt, ist fehlerhaft o.ä.)

5

Fehler im Das Layout (z. B. wenn kein Objektrahmen vorhanden ist)

6

Datenbank kann nicht geöffnet werden (Falscher Datenbankname, falscher Login)

7

Objekt kann nicht geladen werden (falsche oder defekte Projekt-Kennung, Objekt-Kennung, defekte Dateien im GeoDin SYSLIB Verzeichnis)

8

Die im Parameter OutFileName selektierte Datei kann nicht gespeichert werden (falscher Dateiname, Rechte)

9

Das selektierte Ausgabegerät (Druck) ist in der Konfigurationsdatei GeoDin.INI nicht definiert.

10

Das durch den Konfigurationseintrag definierte Druckgerät kann in der Liste der installierten Druckertreiber nicht gefunden werden.

11

Fehler beim Erstellen der Druckdatei (z. B. falsche Einstellung des Papierformats, der Druckertreiber unterstützt dieses Papierformat nicht)

12

Fehler beim Übertragen der abgeschlossenen Druckdatei als Ergebnis der Funktion (SpoolTimeOut definieren)

13

Das Erstellen des Objekt-Eintrags oder der Objektgruppe ist nicht möglich (falsche Objekt-Kennung, Objektart)

14

Ungültige MethodID - die Funktion ist nicht verfügbar

15

Eine Auswahl / Selektion ist nicht möglich, weil das markierte Objekt nicht verlassen werden kann. Beispiel: Wenn das aktuelle Objekt bearbeitet wird und es aufgrund eines Syntaxfehlers in den Daten nicht verlassen werden kann, ist das Markieren eines anderen Objekts nicht möglich.

16

Der Ausdruck kann nicht gestartet werden, da kein Grafikfenster geöffnet ist.

ObjectManagerVisible

Funktion zum Darstellen oder Nicht darstellen des GeoDin-Fensterproperty ObjectManagerVisible:boolean

Durch Setzen dieser Eigenschaft auf "Wahr" oder "Falsch" wird die Sichtbarkeit des GeoDin-Objektmanagers gesteuert.

LizenzInfo

Funktionen zur Bestimmung der Lizenzinformationfunction LicenceInfo:string;

Diese Funktion ist ab der Essentials-Edition verfügbar.

Die Antwort enthält Informationen über GeoDin und die verfügbaren Module.

Lizenzinformation:

Buildnumber: G1840809

Donglenummer: unbekannt

GeoDin - Editionen

Professionell

Lösungsinformationen mit Versionszahl werden weiter ausgegeben, wenn sie Verfügbar sind.

Standort auswählen

Funktionen zum Markieren (Auswahl / Selektion) eines Objekts im Objektmanagerfunction SelectLocation(Datenbank, Benutzername, Passwort, ProjectID:Widestring; LocationID:Ganzzahl):Ganzzahl;

Diese Funktion ist Verfügbar Von dem Basismodul aufwärts.

Das angegebene Objekt wird im GeoDin-Objektmanager markiert und wird zum aktuellen Objekt. Als Objektkennung kann auch die -1 übertragen werden. In diesem Fall wird das GeoDin-Projekt im Objektmanager markiert und wird zum aktuellen Objekt.

Datenbank

Name der Datenbankverbindung, zum Beispiel "GeoDin COM example"

Benutzername

Datenbank-Anmeldename (für Access: ein Leerzeichen ' ', Nein zu leerer String!)

Passwort

Datenbank-Anmeldepasswort (für den Zugriff ein Leer-Zeichen ' ' kein Leer-String !)

Projekt-ID

GeoDin-Projektkennung (6 Ziffern)

**Objekt-ID

GeoDin Objekt-ID

Der Rückgabewert der Funktion ist 0, wenn die Funktion ausgeführt wird. Der Rückgabewert ist 1, wenn ein Fehler aufgetreten ist. Siehe ExceptionWert und ExceptionMsg.

Objekt auswählen

function SelectObject(Params:Widestring):Ganzzahl;

Das angegebene Objekt (Datenbank, Projekt, Abfrage, Objekt, Messpunkte) ist im GeoDin-Objektmanager markiert und wird zum aktuell ausgewählten Objekt.

**Parameter

Die Steuerung der Funktion wird durch eine Zeichenfolge im Papierformat von einem Konfigurationsblock aufgerufen:

[Parameter]

Datenbank=

Benutzername=

Passwort=

Objekttyp=

ÜbergeordneterKnoten=

Abfrage=

Objekt-ID=

Erweitern=

Die Parameter haben folgende Bedeutung:

Datenbank

Name der Datenbankverbindung, zum Beispiel "GeoDin COM example"

Benutzername

Datenbank-Anmeldename (für Access Leer, intern wird ein Leerzeichen ' ' verwendet!)

Passwort

Datenbank-Anmeldepasswort (für Access Leer, intern wird ein Leerzeichen ' ' verwendet!)

ObjektTyp

0 - Der Datenbankzweig oder Projektzweig sollte selektiert werden.

Um den Datenbankzweig zu selektieren, muss der Parameter ParentNode auf =Datenbank gesetzt werden, die Parameter Abfrage und ObjektKennung bleiben Leer (keine Eingabe).

Um einen Projektzweig zu selektieren, muss der Parameter ParentNode auf =Projekt gesetzt werden, der Parameter ObjektKennung muss die Projekt-Kennung enthalten (z. B. ObjektKennung=PRJ001), der Parameter Abfrage bleibt Leer (keine Eingabe).

1 - Der Zweig "Objekte" oder eine Objektabfrage sollte selektiert werden.

2 - Der Zweig "Messpunkte" oder eine Abfrage für Messpunkte oder ein Messpunkt sollte selektiert werden.

ParentNode

=Datenbank

Dies definiert, dass das auszuwählende Objekt direkt unter der Datenbank als Abfrage oder innerhalb einer Abfrage dieses Typs liegen muss. Der Parameter Abfrage= definiert den Namen der Abfrage dieses Typs.

=DatenbankAbfragen

Dies definiert, dass das auszuwählende Objekt im Zweig Objekte (ObjectType=1) oder im Zweig Messpunkte (ObjectType=2) der Datenbank liegen muss. Der Parameter Abfrage= definiert den Namen der Abfrage dieses Typs.

=Projekt

Dies definiert, dass das auszuwählende Objekt direkt unter der Abfrage oder innerhalb einer Abfrage dieses Typs liegen muss. Der Parameter Abfrage= definiert den Namen einer Abfrage dieses Typs.

=ProjektAbfragen

Dies definiert, dass das auszuwählende Objekt entweder im Zweig Objekte (ObjectType=1) oder im Zweig Messpunkte (ObjectType=2) des Projekts liegen muss. Der Parameter Abfrage= definiert den Namen der Abfrage.

Abfrage

Dieser Optionaler Parameter definiert den Namen der Abfrage, die selektiert werden soll, oder der Abfrage, welche das Objekt enthält, das selektiert werden soll. Wenn dieser Parameter nicht eingegeben wird, selektiert GeoDin automatisch die Abfragen „Alle Objekte“ oder die entsprechende Abfrage bzw. die Messart, die durch die dreistellige Kennung der Messung in der INVID definiert ist.

Objekt-ID

Der Parameter ObjectID gibt das gewählte Objekt an. Wenn ObjectID leer ist oder nur eine sechsstellige Projektkennung enthält, werden nur die Zweige (in diesem Fall Abfragen), die durch ParentNode und Query definiert sind, ausgewählt, ohne ein bestimmtes Objekt oder einen Messpunkt auszuwählen. Eine Objekt-ID muss direkt der Projektkennung folgen und aus einer vierstelligen Zeichenkette bestehen; zum Beispiel PRJ0010022 = Projektkennung: PRJ001 und Objekt-ID 22. Die Zahl der Objekt-ID muss mit Nullen ergänzt werden und aus genau vier Zeichen bestehen. Wenn ein Messpunkt ausgewählt werden soll, muss eine sechzehnstellige INVID eingegeben werden, zum Beispiel PRJ001022FIL001. Eine Ausnahme ist die Auswahl einer GeoDin Messpunktabfrage vom Typ "Filter" oder "Beispiel". Wenn eine Objekt-ID vom Typ = PRJ001????FIL verwendet wird (ObjectType=2, ParentNode=ProjectQueries, Query=empty) kann zum Beispiel die Abfrage "Filter" im Zweig Messpunkte des Projekts PRJ001 ausgewählt werden, ohne in diesem Zweig einen bestimmten Messpunkt auszuwählen.

Erweitern

Dieser Parameter definiert, ob der selektierte Zweig gleichzeitig geöffnet werden soll. Benutzen Sie die Einträge =Wahr oder =Falsch, um den Öffnungsprozess zu bestimmen.

Der Norm Wert von Erweitern ist =wahr.

Der Rückgabewert der Funktion ist 0, wenn die Funktion ausgeführt wurde. Der Rückgabewert ist 1, wenn ein Fehler aufgetreten ist. Siehe ExceptionWert und Ausnahmen.

ObjektauswahlErstellen

function CreateObjectSelection(Datenbank, Benutzername, Passwort, ObjectIDs: WideString; ObjectType: Ganzzahl; RefName: WideString; MethodID: Ganzzahl; MethodParams: WideString): Ganzzahl;

Ein oder mehrere Objekte werden zum GeoDin-Objektmanager hinzugefügt. Optional kann ein Verfahren mit Parametern an einem Objekt oder einer Objektgruppe gestartet werden.

Datenbank

Name der Datenbankverbindung, z. B. "GeoDin COM-Beispiel"

Benutzername

Datenbank-Anmeldename (für Access: ein Leerzeichen ' ', Nein zu leerer String!)

Passwort

Datenbank-Anmeldepasswort (für den Zugriff ein Leer-Zeichen ' ' kein Leer-String !)

Objekt-IDs

Zeichenfolge mit einer oder mehreren Objektkennungen. Diese werden als INVID-Werte interpretiert, falls der ObjectType = 1 oder 2 ist. Falls der ObjectType= 3 ist, werden sie als ADC_ID-Werte interpretiert. Die INVIDs können aus den Tabellen LOCREG, FILREG oder PRBREG entnommen werden oder gemäß den Regeln erstellt werden. Die ADC_IDs müssen in der Tabelle ADC_DATA enthalten sein. Durch Eingabe einer einzelnen Kennung wird ein einzelnes Objekt hinzugefügt und selektiert. Beim Eingeben mehrerer Kennungen müssen diese durch CRLF ($0D$0A) getrennt werden (Zeichenfolgenliste-Objekt mit mehreren Zeilen). Wenn mehrere Objekte hinzugefügt werden, entsteht eine Gruppe, die nach dem Hinzufügen selektiert wird.

ObjektTyp

Bei Verwendung von ObjectType=0 werden die Objekte als ein Objekt interpretiert. Bei Verwendung von ObjectType=1 werden die Objekte als Messpunkte hinzugefügt. Diese Option ist besonders relevant für INVIDs aus der Tabelle LOCREG, da diese entweder Objekte oder Messpunkte sein können. Das Hinzufügen von INVIDs aus den Tabellen FILREG oder PRBREG mit ObjectType=0 führt zu einem Fehler. Bei Verwendung von ObjectType=3 werden Dokumente hinzugefügt und die IDs werden als ADC_IDs interpretiert.

RefName

Enthält ObjectIDs nur ein Objekt, ist dieser Parameter nicht verwendet. Für mehrere Objekte sollte dieser Parameter einen Gruppennamen enthalten, um die Navigation des Benutzers zu vereinfachen (Wenn eine leerer String gewählt wird, wird die Gruppe "Neue Gruppe" genannt).

Methoden-ID

Optionale Angabe einer VerfahrenID. Gestartet wird das entsprechende Verfahren. Wird als VerfahrenID -1 übertragen, wenn kein Verfahren gestartet wird.

Methodenparameter

Ist nur verwendete, Wenn MethodID <>-1. Wird verwendet, zu steuern den Aufruf von der Methode. Siehe ExecuteMethodParams.

Der Rückgabewert der Funktion ist 0, wenn die Funktion ausgeführt wird. Der Rückgabewert ist 1, wenn ein Fehler aufgetreten ist. Siehe ExceptionWert und ExceptionMsg.

MethodListAsString

Funktionen zum Starten von GeoDin-Verfahrenfunction MethodListAsString:string;

Gibt eine Liste von Verfahren zurück, die auf dem selektierten Objekt aufgerufen werden können. Der Ergebnis-String kann aus mehreren Zeilen bestehen (getrennt durch CRLF), wobei jede Zeile ein Verfahren ist. Eine Verfahrenseingabe besteht aus der MethodID, gefolgt von einem Komma und dem Namen des Verfahrens (z. B. 2,Grafik bearbeiten). Die MethodID kann im Verfahren ExecuteMethod verwendet werden. Wenn kein Verfahren verfügbar ist, ist der Rückgabe-String Leer.

ExecuteMethod

function ExecuteMethod(MethodID:Ganzzahl):Ganzzahl;

Diese Funktion ist im Basis-GeoDin-Modul verfügbar. Abhängig vom Verfahren können weitere Module erforderlich sein (z. B. Logs, Labs...).

Der Rückgabewert der Funktion ist 0, wenn die Funktion ausgeführt wird. Der Rückgabewert ist 1, wenn ein Fehler aufgetreten ist.

ExecuteMethodParams

function ExecuteMethodParams(MethodID:Ganzzahl; MethodParams: WideString):Ganzzahl;

Diese Funktion ist im Basis-GeoDin-Modul verfügbar. Abhängig vom Verfahren können weitere Module erforderlich sein (z. B. Logs, Labs...)

Startet ein GeoDin-Verfahren mit Parametern. Die gültigen Verfahrens-IDs werden unter ExecuteMethod <ExecuteMethod>CLASS_HLP_COM_ExecuteMethod# beschrieben.

Der Rückgabewert der Funktion ist 0, wenn die Funktion ausgeführt wird. Der Rückgabewert ist 1, wenn ein Fehler aufgetreten ist.

Bild abrufen

Funktion zum Erstellen einer Bildfunktion GetImage(const Datenbank, Benutzername, Passwort, ProjectID: WideString; LocationID: Ganzzahl; const VersionName, LayoutFileName, OutFileName: WideString; ImageType, MaxResolution, Kompression, Maßstab, PageNumber: Ganzzahl; out PageCount: Ganzzahl): OleVariant;

Hinweis: Diese Funktion ist nur mit einer GeoDin Server Lizenz Verfügbar.

Datenbank

Name der Datenbankverbindung z. B. "GeoDin COM Example"

Benutzername

Datenbank-Anmeldename (für Access: ein Leerzeichen ' ', Nein zu leerer String!)

Passwort

Datenbank-Anmeldepasswort (für den Zugriff ein Leer-Zeichen ' ' kein Leer-String !)

Projekt-ID

GeoDin-Projektkennung (6 Zeichen)

Objekt-ID

GeoDin Objekt-ID

Versionsname

Leerzeichenkette '' oder Versionen der Bohrlochprotokolle und des Ausbauplans, die angezeigt werden sollen

Layout-Dateiname

Vollfarbdateiname der Layout-Datei, z. B. "C:\PROGRAMs\GeoDin\LAYOUTS\BOREHO1.GLO"

OutFileName- Funktion zum Erstellen von Bilddatei

Entweder Leerstring (es wird keine Datei erstellt) oder vollständiger Dateiname für die Ergebnis-JPG-Bilddatei, z. B. "C:\SAMPLE1.JPG"

function GetImage(const Datenbank, Benutzername, Passwort, ProjektID: WideString; LocationID: Ganzzahl; const VersionName, LayoutFileName, OutFileName: WideString; ImageType, MaxResolution, Kompression, Maßstab, PageNumber: Ganzzahl; out PageCount: Ganzzahl): OleVariant;

Diese Funktion ist im Bildservermodul verfügbar.

Datenbank

Name der Datenbankverbindung, z. B. 'GeoDin COM Example'

Benutzername

Datenbank-Anmeldename (für Access ein Leerzeichen ' ' kein Leerstring !)

Passwort

Datenbank-Anmeldepasswort (für Access ein Leerzeichen ' ' kein Leerstring !)

Projekt-ID

GeoDin-Projektidentifikation (6 Zeichen)

Objekt-ID

GeoDin-Objektidentifikationsnummer

Versionsname

Leerstring " oder die relevanten Versionen des Bodenprofils und Ausbauplans. Dieser Parameter wird nur für Objektarten der bayerischen regionalen geologischen Behörde (Landesamt) unterstützt. VersionName enthält entweder einen String ohne Tabulatorzeichen - dann ist hier der Name der Version des Bodenprofils angegeben oder VersionName enthält zwei Strings, verbunden durch ein Tabulatorzeichen, dann entspricht dies dem Namen der Version des Bodenprofils, gefolgt vom Namen der Version des Ausbauplans (SVVersion+chr(9)+ASBVersion). Im Falle der Objektarten des bayerischen Landesamts werden die Namen der Versionen durch den PKEY definiert.

Layout-Dateiname

vollständiger Dateiname des Layouts, z. B. 'C:\PROGRAMDATA\GeoDin\LAYOUTS\BOHRPR1.GLO'

Ausgabedateiname

Entweder Leerer String (keine Datei wird erstellt) oder vollständiger Dateiname für die resultierende JPG-Bilddatei, z. B. "C:\SAMPLE1.JPG"

Bildtyp

1 (=JPG)

2 (=JPG, fehlende Daten oder falsche Grafikelemente werden gestrichelt angezeigt (wie in der Voransicht))

11 (=PNG)

12 (=PNG, fehlende Daten oder falsche Grafikelemente werden gestrichelt dargestellt (wie in der Voransicht))

21 (=EMF)

22 (=EMF, fehlende Daten oder fehlerhafte Grafikelemente werden gestrichelt dargestellt (wie in der Voransicht))

31 (=WMF)

32 (=WMF, fehlende Daten oder fehlerhafte Grafikelemente werden gestrichelt dargestellt (wie in der Voransicht))

Maximale Auflösung

Auflösung von einem Rasterbild für die längste Seite des Papierformats des gewählten Layouts, z. B. 1500

Kompression

Bereich von Werten von 0 zu 100. Steuert die Qualität / Kompression für JPG-Bilder und die Geschwindigkeit / Kompression für PNG-Bilder. Detaillierte Informationen sind unten angegeben.

Maßstab

Vertikalmaßstab des Objekts im Layout (überschreibt die Einstellungen im Layout; die Optionen "Auf Seite skalieren" und "Bei Fehldarstellung anpassen" sind nicht betroffen und können zu einer automatischen Anpassung des Maßstabs führen; Voreinstellungen im Layout "Lesen von" werden ignoriert).

Seitenzahl

Seite Zahl, die zu angezeigt werden soll

Seitenanzahl

Rückgabe der Zahl der Seite der Visualisierung des aktuell Objekt von dem selektiert Maßstab

Die Funktion gibt das Bild als OleVariant zurück, sodass kein Umweg über die OutFile erforderlich ist.

Hinweis: Der Parameter Kompression ist bei EMF- oder WMF-Bildern während der Erstellung Nicht verwendet.

Wenn Sie eine EMF-Bild erstellen, kann der Parameter MaxResolution verwendet werden, um die Auflösung zu steuern. Durch Übertragen von 0 wird die Auflösung des EMF-Bilds intern berechnet (wie ein direkter Export aus der GeoDin-Programm-Benutzeroberfläche). Wenn ein Wert > 0 übertragen wird, wird der maximale horizontale Bereich des EMF-Bilds so angepasst, dass der eingegebene Wert nicht überschritten wird. Das resultierende Bild kann einen geringeren horizontalen Bereich als den eingegebenen Wert haben, weil die Grenzen des EMF-Bilds (Boundary box) an die enthaltenen Grafik-Elemente ausgerichtet sind. Aufgrund dieser Visualisierung mit demselben Layout können EMF-Bilder mit einem unterschiedlichen horizontalen Bereich für verschiedene Bohrungen entstehen, während der Bereich der Bilder gleich ist, wenn Rasterbilder erstellt werden.

Verwendung des Parameters Kompression:

JPG: Qualität und Kompression

0 = niedrig Qualität / hoch Kompression

100 = hoch Qualität / niedrig Kompression

Beispielgrößen mit MaxResolution = 1500 für eine A4-Seite mit dem Standardlayout „Bohrprofil":

Kompression Größen in KB Kommentar

0 48 nicht brauchbar

25 85 stark intensive Streifen

50 109 deutliche Streifen

75 135 gute Darstellung

85 157 gute Darstellung

100 320 stark klares Bild aber stark groß

PNG: Geschwindigkeit und Kompression

0 = stark zeitaufwendig / hohe Kompression

100 = stark schnell / niedrige Kompression

Kompression Größen in KB Kommentar

0 42 extrem zeitaufwendig (>30 sek)

25 72 effiziente Erstellung (5 sek)

50 99 schnelle Erstellung

75 157 schnelle Erstellung

75 564 sehr große Datei

100 564 sehr große Datei

Werte über 70 sollten nicht verwendet werden, die verwendete Bibliothek erstellt diese PNG-Dateien sporadisch fehlerhaft, sodass die Bilder mit allen Programmen nicht angezeigt werden können.

GraphicWidth

function GraphicWidth:Ganzzahl

Gibt die Breite der Grafik zurück, die erstellt wurde, als GetImage zuletzt aufgerufen wurde. Die Funktionen sollten nur verwendet werden, wenn es in der aufgerufenen Anwendung keine Möglichkeit gibt, diese Parameter selbst aufzurufen.

GrafikHöhe

function GraphicHeight: Ganzzahl

Gibt die Höhe der Grafik zurück, die erstellt wurde, als GetImage das letzten Mal aufgerufen wurde. Die Funktionen sollten nur verwendet werden, wenn es in der aufrufenden Anwendung keine Möglichkeit gibt, diese Parameter selbst aufzurufen.

GrafikSeitenzahl

function GraphicPageCount: Ganzzahl

Gibt die Seitennummer zurück, die erstellt wurde, als GetImage oder GetPrintFile das letzten Mal aufgerufen wurde. Entspricht dem Ausgabewert PageCount beider Funktionen. Die Funktionen sollten nur verwendet werden, wenn die aufrufende Anwendung mit dem Ausgabewert beider Funktionen nicht umgehen kann.

Datenerfassung und -pflege

MethodID = 1 (Datenerfassung und -pflege) MethodParams:

A) keine Eingabe

Datenerfassung wird gestartet (Allgemein Dateneditor), wenn diese Methode bereits gestartet ist, bleibt die aktuell Datenmaske (Allgemeine Sondierungen, Schichtdaten usw.) aktiv.

B) Auswahl der gewünschten Bearbeitungsmaske durch Angabe einer Parameter-Datenzeichenfolge der Form:

[Parameter]

EditType=Zahl

Die verfügbaren Zahlen sind:

1 - Allgemeine Sondierungen

2 - Schichtdaten

3 - Probendaten

4 - Ausbaudaten

5 - Bohrlochmessungen, Sondierungen

6 - zusätzlich Daten (1:n), abhängig von der Objektart, z. B. die Tabelle Grundwasser

Grafik bearbeiten

MethodID = 2 (Grafik bearbeiten) MethodParams:

A) keine Eingabe

Die Standardlayoutliste wird geöffnet. Das aktuelle Layout der Standardlayoutliste wird angezeigt.

B) Eingabe eines (Layout) Dateinamens, der das Objekt anzeigen soll.

C) "Layout wählen:Layoutname"

Die Standardlayoutliste ist geöffnet und das Layout "layoutname" ist selektiert. Optional kann die Layoutliste, die verwendete werden soll, als Pfad beschrieben werden:

z. B.: "Layout wählen:Layoutname|c:\programs\GeoDin\syslib\geo.gll"

E) "Meldung:Berichtname"

Die Standardlayoutliste wird geöffnet und der Bericht "reportname" wird selektiert. Optional kann die Layoutliste, die verwendet werden soll, als Pfad beschrieben werden:

z. B.: "Meldung:Berichtsname|c:\programme\GeoDin\syslib\geo.gll"

Grafik öffnen

MethodID = 4 (Grafik öffnen) Methodenparameter:

Es wird ein vollständiger Pfadname einer GeoDin Grafik, Layout oder Layoutlist erwartet. Die Datei wird im Grafikfenster geöffnet.

Messwerte importieren

MethodID = 12 (Messwerte Importieren) MethodParams:

[Parameter]

Datenbank=<Datenbankname>

Benutzername=

Passwort=

DatType=<Datentypzuordnung>

ImpArt=<Importieren Art DBF_ZEILE,CSV_ZEILE,ACC_ZEILE>

ImpCmdDatei=<Name Pfad von einer Importieren-Befehlsdatei *.xml>

ImpDatFile=<Name einer Importdatei *.dbf,*.csv,*.mdb> |<Tabellenname für Access>

ImpRepDatei=<Name von einer Bericht-Datei *.txt>

Die Namen von den Dateien werden als Vollfarbe-Längenpfad erwartet.

[DataSource]

ImportFormat=<Zeile,Spalte>

GroupField1=

GroupFieldn=

ParameterField=

ValueField=

MesPointLink=

[MesPointLink]

<GeoDinINVID>=<DatasourceID>

...

...

[ParameterLink]

<GeoDinParameter>=<DatasourceParameter>

...

...

[ImportOptions]

AddRecords=Wahr

UpdateRecords=Falsch

SearchRecords=<SMPDATE,SMPNAME,SMPID>

UpdateType=<Extend,Replace,Ignorieren>

RoundNumbers=Falsch

CutText=Falsch

IgnorePlausibilityErrors=Falsch

CalcRecordChanges=Falsch

DetailProtocol=Wahr

Grafik drucken ODER Bericht

MethodID = 13 (Grafik drucken ODER Bericht) MethodParams:

Kein Eintrag: Die Ausgabe auf Drucker erfolgt ohne Druckdialog auf dem aktuellen Drucker. Wenn kein Grafik geöffnet ist (Detailansicht oder Layoutübersicht) oder wenn keine Objekte mit dem Layout in der Layoutübersicht verbunden sind, wird nichts gedruckt und die Fehlernummer 16 zurückgegeben.

Die Druckausgabe kann optional durch Eingabe eines Parameterblocks konfiguriert werden:

[Druckoptionen]

ShowPrintDialog=true Ein Druckdialog wird angezeigt

PrintDevice=DeviceName Drucker zu Benutzen Sie

PrintDateiname=Dateiname Drucken zu selektierter Datei

Dateiname:

Damit der Drucker, der in der GeoDin.INI benutzt werden soll, eine Sektion mit Druckerinformationen enthält, muss eine Sektion eingetragen werden. Beispiel:

[PrintDevices]

PDF=Acrobat PDFwriter

Win2PDF=Win2PDF

SW=Canon GP300-405 PCL

Eine ausführlichere Bezeichnung dieser Sektion finden Sie in den Informationen über die Funktion "GetPrintFile". DeviceName muss einen gültigen Eingabe dieser Konfiguration Sektion enthalten.

Dateiname:

Wenn Sie den Parameter "PrintDateiname" benutzen, geben Sie einen Vollfarbe Dateinamen ein. Eine eventuell vorhandene Datei mit demselben Namen wird überschrieben.

Zum Beispiel würde der Parameterblock so aussehen, wenn Sie die Drucken-Funktion verwenden möchten, um eine PDF-Datei zu erstellen:

[Druckoptionen]

PrintDevice=Win2PDF

PrintFileName=C:\GeoDinPrints\Ausdruck1.PDF

Plugin starten

MethodID = 14 (Plugin starten) MethodParams:

Ein Konfigurationsblock muss übertragen werden, der mindestens die Eingabe enthält:

[Parameter]

Plug-in=<Name>

Wie Name der eindeutige Name der Plug-in-Funktion eingegeben werden muss.

Hinweis: Das Thema hier ist nicht der Parameter "Name", der im Objektmanager sichtbar ist als der Name von der Plugins, aber der Name der Konfiguration Sektion dieses Plug-ins. Das Plug-in muss für den aktuell Zweig (Knoten) im Objekt-Manager konfiguriert und ausführbar sein. Es kann in der Verfahren-Liste selbst Nicht dargestellt werden (Parameter "Nicht darstellen" in der Plug-in-Konfiguration).

Optional kann der Konfigurationsblock eine weitere Sektion mit dem Namen "PluginParams" und beliebig Parameter enthalten. Beispiel:

[Parameter]

Plugin=Sonderfunktion

[PluginParams]

Param1=Mein Parameter 1

Param2=Mein Parameter 2

.....

Diese Sektion der Konfiguration wird vollständig an das Plug-in (nur COM-Server-Plugins) übertragen und wird von GeoDin nicht analysiert. Aus diesem Grund kann Beliebig Parameter durch Aufruf über die COM-Funktion zu dem Plug-in übertragen werden.

Messwerte prüfen

MethodID = 53 (Messwerte prüfen) MethodParams:

Benutzen Sie die Sektion „Regression“, um Messwerte mithilfe einer Regressionsanalyse zu überprüfen.

Der Wert Layout enthält den Namen der Regressionsgrafik, die verwendet wird.

Weitere Informationen zu diesem Verfahren finden sich im Kapitel Messwerte prüfen und in der Bezeichnung Regressionsberechnung von dem Zeitreihenserien-Element.

Beispiel:

[Regression]

Layout wählen=AnalysisLayout1

SysInfo

Funktion zu bestimmen Systeminformationenfunction SysInfo(Param:string):OleVariant;

Diese Funktion ist Verfügbar Von Essentials-Edition.

Es gibt Systeminformationen je nach ausgewähltem Parameter zurück.

Die folgenden Parameter sind verfügbar:

1. SysInfo(GeoDinINIFileName): gibt den vollständigen Pfad und Dateinamen der aktuell verwendeten GeoDin.ini zurück.

2. SysInfo(ProgramDataFolder): gibt den Programmdatenpfad zurück.

3. SysInfo(ApplicationFolder): gibt das Anwendungsverzeichnis zurück.