Mit dem Modul können Objekte aus einer ESRI-Geodatabase gelesen werden. Unterstützt werden:
ESRI SDE Geodatabase (Oracle)
ESRI Personal Geodatabase (ACCESS)
ESRI File Geodatabase
Der Modul wird mit:
|INCL \script\arcgisin.mod
in einer ICS RUN1-Konfiguration verfügbar gemacht.
Der Modul verwendet das ESRI ArcObjects API. Für die Anwendung des
Modules ist deshalb im Minimum eine ESRI Lizenz ArcGIS Engine
Runtime notwendig.
Folgende Parameter können in der Map ARCGISIN_PARAM für den Modul gesetzt werden:
| Parameter | req/opt | Beschreibung |
STATISTICS | o | ON oder OFF,
Default = OFF. Statistik
anzeigen. |
FENCE | o | string. Fence Definition. Es
werden nur Objekte gelesen, die innerhalb des Fences liegen.
Objekte ohne Geometrien werden vollständig gelesen. Der
Fence kann als Rechteck in der Form
minx/miny,maxx/maxy oder als
geschlossenes Polygon in der Form x1/y1,x2/y2, ...
xi/yi, ... xn/yn definiert werden. Der Fence kann
auch durch die Option OPT.fence gesetzt
werden. |
FENCE_MODE | o | OFF,INSIDE,OVERLAP. Definiert den
Modus für den Fence. OFF: Der Fence wird
nicht berücksichtigt. INSIDE : Es werden
nur Objekte gelesen, die vollständig innerhalb des Fences
liegen.OVERLAP : Es werden nur Objekte gelesen, die
innerhalb des Fences liegen oder den Fence
überlappen. |
READ_M | o | ON oder OFF.
Falls ON gesetzt wird, werden die
Measurement-Werte als Z-Koordinaten gelesen, falls
vorhanden. Eventuelle Z-Koordinaten werden nicht gelesen.
Mesurement-Werte können in fogenden Geometrie Typen
definiert werden: POINT,
MULTIPOINT,
POLYLINE,POLYGON. |
Der Connect zu einer ArcGIS SDE Datebank wird unterschieden zwischen einem
Direct Connect (ab 10.1 Standard)
und einem
SDE Service Connect (bis 10.0 Standard)
Bis und mit SDE Version 10.0 war der Connect über einen SDE Service der Standard. Ab SDE Version 10.1 ist Direct Connect der Standard. Direct Connect benötigt keinen SDE Service, sondern verwendet die Möglichkeiten der Datenbank für einen Connect.
Bis SDE Version 10.0 konnte der SDE Service über das Postinstallations-Programm von SDE interaktiv eingerichtet werden. Ab SDE Version 10.1 muss der SDE Service manuell eingerichtet werden.
Entsprechend der Verbindung über Direct Connect oder SDE Service sind die Connect-Parameter etwas anders. Nachfolgend werden Beispiele für die Verbindung zweier geläufigen Datenbanken aufgeführt.
| Datenbank | Connect | Connect Parameter Interaktiv | Connect Parameter Batch OPT.input/OPT.output |
| Oracle | Direct Connect |
|
|
| SDE Service |
|
| |
| SQL Server | Direct Connect |
|
|
| SDE Service |
|
|
Der Modul liefert pro IN-Objekt folgende Systemkomponenten:
| Komponente | req/opt | Beschreibung |
IN.TABLE(s) | r | Tablename des IN Objekts. |
IN.GDB_DATASET(s) | r | Enthält den Geodatabase Dataset-Namen. |
IN.<Attribute>(*) | o | Pro Attribut in der Geodatabase eine Komponente mit dem Attributnamen und dem Wert. |
IN.<Geom-Attribute>(g|li) | o | Falls es sich beim Attribut um eine Geometrie handelt, so enthält diese Komponente die Geometrie. Sind mehere Geometrien vorhanden, so enthält die Komponente eine Liste von Geometrien. |
Alle weiteren Komponenten sind abhängig von der Tabellen-Definition in der Datenbank.
Der Modul ARCGISIN stellt folgende Prozeduren und Methoden zur Verfügung.
| Prozedur | ARCGISIN_OPEN [s input][] |
| Beschreibung | Öffnet eine bestehende
Datenbank.Für eine Personal Geodatabase muss in input die
Access-Datenbank *.mdb gesetzt werden.Für eine File
Geodatabase muss in input die File-Datenbank *.gdb gesetzt
werden.Für eine SDE Geodatabase muss in input die SDE
connection in der Form
<server>,<instance>,<database>,<user>,<password>,<version>
gesetzt werden.Die Prozedur wird von RUN1
automatisch aufgerufen. |
| Beispiel | |
| Prozedur | ARCGISIN_READ_OBJECT [][b state] |
| Beschreibung | Liest das nächste IN-Objekt aus der geöffneten Datenbank-Tabelle. Die Prozedur wird von RUN1 automatisch aufgerufen. |
| Beispiel | |
| Prozedur | ARCGISIN_CLOSE [][] |
| Beschreibung | Schliesst den Modul und gibt die durch den Modul belegten Resourcen wieder frei. Die Prozedur wird von RUN1 automatisch aufgerufen. |
| Beispiel | |
! Diese ICS Konfiguration zeigt alle von ARCGISIN.mod ! gelesenen Objekte in der .log Datei an. |LICENSE \license\iltools.lic MAP USER_INPUT1 DIALOG => ARCGIS MESSAGE => 'Enter SDE or Database File' FILE_FILTER => mdb;gdb FILE_EXISTS => TRUE OPT => input END_MAP MAP ARCGISIN_PARAM STATISTICS => ON END_MAP MAP INPUT_SOURCES I1 => ARCGISIN,* END_MAP MAP INOUT I1 => DISPLAY_OBJECT1,IN END_MAP |INCL \script\ARCGISIN.mod |INCL \script\run1.prg
Die Module ARCGISIN/ARCGISOUT lösen die Module GDBIN/GDBOUT und SDEIN/SDEOUT ab. Bestehende Konfigurationen IL2GDB/GDB2IL und IL2SDE/SDE2IL sind deshalb durch Konfiguration IL2ARCGIS/ARCGIS2il abzulösen. Für dieser Migration steht folgendes Script zur Verfügung.
ILTOOLS\system\script\il2gdb\CFG_GDB2ARCGIS.cfg
Das Script verlangt als Input eine IL2GDB/GDB2IL oder IL2SDE/SDE2IL Konfiguration und schreibt als Output eine analoge IL2ARCGIS/ARCGIS2IL Konfiguration.