|
<< Click to Display Table of Contents >> Navigation: Über SIRISWeb (RISView und FIN-Web) > SIRISCli-Schnittstelle |
SIRISCli steuert die Kommunikation von SIRISWeb mit externen Programmen. SIRISWeb kann mit Hilfe von SIRISCli als Webviewer von Fachanwendungen eingerichtet werden: Bereits realisiert wurde z.B. die Kommunikation mit Bausoftware der Firmen OTS, Kolibri, Prosoz Herten oder Boll & Partner. SIRISCli überträgt Kommandos je nach Konfiguration an SIRISWeb oder FIN-View. Zur Übermittlung der Kommandos dient das Consolen-Programm SirisCliBat.
SIRISCli-Parameter:
Parameter -s:
Die Auswahl des GeoClients erfolgt am Arbeitsplatz über Aufruf von SirisCliBat mit Parameter –s=FIN oder –s=RIS. Der –s Parameter kann auch mit anderen Parametern kombiniert werden. Sein Wert bleibt solange bestehen, bis ein anderer Wert gesetzt wird.
Parameter -c:
Die Kommandos werden mit dem Parameter –c="…" angegeben. Die Kommandos müssen in Anführungszeichen gesetzt werden, dadurch können auch Leerzeichen in der Aufzählung von Parametern verwendet werden.
Zur Übergabe von Anführungsstriche der Stringparameter in der Kommandozeile müssen sie jeweils entwertet werden ("_\"ID=‘3‘\"_").
Bei den Kommandos selbst wird nicht auf Groß-/Kleinschreibung geachtet, sie werden untereinander mit einem Strichpunkt separiert. Kommandoparameter hingegen werden durch ein Komma getrennt, Zahlendarstellung erfolgt in amerikanischer Schreibweise.
Parameter -f:
Die Kommandos können auch in einer Textdatei abgelegt werden. Mit dem Parameter –f=Datei können die Kommandos der Textdatei ausgeführt werden. Soll die Datei nach der Ausführung automatisch gelöscht werden, verwendet man den Parameter –fd=Datei.
(Beim ersten Kommando, bei dem ein Fehler auftritt, wird die Verarbeitung abgebrochen. In SirisCliBat erfolgt eine Fehlermeldung.).
SirisCli Kommandos:
Die Klasse MapExtent:
MapExtent:Objects(layers, [,xmin, ymin, xmax, ymax], query)
Zoomt auf die Objekte, die durch den Parameter query gefunden wurden. Siehe auch InfoList:Append.
MapExtent:InfoList
Zoomt auf alle Objekte, die in der Trefferliste aufgeführt sind.
MapExtent:Rectangle(xmin, ymin, xmax, ymax)
Diese Funktion dient zur Anzeige eines rechteckigen Kartenausschnitts. Die Typen der Parameter sind reelle Zahlen und entsprechen den Gauß-Krüger-Koordinaten der Ecke links unten bzw. rechts oben. Die aktiven Themen werden nicht verändert.
MapExtent:Offset(xofs, yofs)
Diese Funktion dient zur Verschiebung des Kartenausschnitts um einen festen Betrag. Die Typen der Parameter sind reelle Zahlen und entsprechen im Gauß-Krüger-Koordinatensystem der Einheit Meter.
Die aktiven Themen werden nicht verändert.
Beispiel: SirisCliBat –c=" MapExtent:Rectangle( 4568000.1, 5365000.2, 4571000.3, 5367300.4) "
Die Klasse InfoList:
InfoList:Replace(layers, [,xmin, ymin, xmax, ymax], query)
InfoList:Append(layers, [,xmin, ymin, xmax, ymax], query)
Diese Funktion dient zur Ermittlung der Grafik-Objekte der durch den String-Parameter layers vorgegebenen Themen.
Die einzelnen Themen können als GeoService:Name zur eindeutigen Identifizierung angegeben werden und dürfen selbst kein Komma (bzw. Blank oder Strichpunkt) enthalten. Mehrere Themen werden durch Kommata getrennt und als Ganzes mit Anführungsstriche geklammert. In der Auflistung können auch Alias-Namen verwendet werden, z.B. $(TK25).
Durch eine BoundingBox kann eine räumliche, durch den Parameter query eine thematische Einschränkung vorgenommen werden.
Die Parameter der BoundingBox sind reelle Zahlen und entsprechen den Gauß-Krüger-Koordinaten der Ecke links unten bzw. rechts oben.
Der String-Parameter query entspricht der where-Klausel einer SQL-Abfrage (z.B. "ID=‘7540‘"). Mit den ermittelten Objekten wird die Abfrageliste der jeweiligen Applikation modifiziert (ersetzt oder erweitert).
Beispiel 1:
SirisCliBat –c=" InfoList:Replace( \"$(DFK), RVB3\", 4568000.1, 5365000.2, 4571000.3, 5367300.4, \"\") "
SIRISWeb/FIN-View führt in den Layern DFK und RVB3 eine Sachdatenauskunft in dem angegebenen Rechteck durch. Die aktuelle Trefferliste wird durch das Ergebnis dieser Abfrage ersetzt
Beispiel 2:
SirisCliBat –c=" InfoList:Append( \"$(DFK)\", \"NAME=’6402/7/2’\") "
SIRISWeb/FIN-View sucht in der Ebene DFK das entsprechende Flurstück (6402/7/2). Die aktuelle Trefferliste wird durch das Ergebnis dieser Abfrage ergänzt.