cardo.COM - Standardschnittstellen

Unter Verwendung der Schnittstelle cardo4.COM gibt es einige Standard-Implementierungen, die in jeder Installation verfügbar sind.

Das Standard-Trennzeichen für Argumentlisten ist das Pipe-Zeichen (|), dieses kann über separator=xx überschrieben werden.

---

Aktion "loadSessionState"

Lädt eine gespeicherte Sitzung.

Argumente:

• storedSessionId: die Interne ID der gespeicherten Sitzung. Beachten Sie, dass der Aufrufer Berechtigungen an der Sitzung haben muss.
• onlyOnInit: (optional) Gibt vor, ob die Sitzung nur geladen werden soll, wenn das cardo durch den Aufruf "frisch" gestartet wird. Standard: false

---

Aktion "select"

Ruft die Daten einer Ebene per Selektion ab und stellt diese in der Karte oder als Tabelle dar.

Argumente:

• layer: Interner Ebenenname oder Ebenen-Tag der Ebene aus der ein Objekt selektiert werden soll (z.B. L34). Es können auch mehrere Ebenen durch "|" getrennt angegeben werden. Das Mischen von Ebenennamen und Ebenen-Tags ist erlaubt.

• field: Feldname oder durch "|" getrennte Liste von Feldnamen über die die Selektion ausgeführt werden soll.

• value: Selektionswert oder durch "|" getrennte Liste von Werten, die mit den Selektionsfeldern korrespondieren.

• compareOperator: (optional) Vergleichsoperator oder durch "|" getrennte Liste von Vergleichsoperatoren. Standardmäßig wird Equal verwendet. Unterstützte Operatoren sind: Equal, NotEqual, GreaterEqual, LessEqual, Greater, Less, Like, In, Between, NotLike, IsNull, IsNotNull. Die Operatoren In und Between erwarten als Wert eine Werte-Liste. Das standardmäßige Trennzeichen dafür ist das Komma. Das Wert-Listen-Trennzeichen kann jedoch auch abweichend festgelegt werden. Standard: Equal

• valueListSeparator: (optional) Trennzeichen für Wert-Listen, ausschließlich verwendet in Kombination mit den Vergleichs-Operatoren In und Between. Standardmäßig wird ein Komma verwendet.

• joinType: (optional) Verknüpfungstyp, wenn mehrere Felder angesprochen werden; mögliche Werte: AND oder OR; Standard ist AND.

• mode: (optional) Art der Selektion; mögliche Werte: MAP (Objekt zentrieren und markieren) oder TABLE (Anzeige in der Selektionstabelle); mehrere Werte durch "|" getrennt sind möglich. Standard: MAP

• offset: (optional) Abstand zum Kartenrand in Metern; Standard: 100.

• noLayerVisibility: (optional) Die in layer angegebenen Ebenen nicht zusätzlich anschalten. Falls die Ebene nicht ohnehin schon auf der Karte sichtbar ist, kann man mit dieser Option verhindern, dass sie beim Selektieren angeschaltet wird. Standard: false

• noZoom: (optional) Kein Zoom auf die Selektion. Falls nicht zum selektierten Objekt gezoomt werden soll, kann true übergeben werden. Standard: false

• extent: (optional) Expliziter Kartenausschnitt in der Form xmin|ymin|xmax|ymax|epsgCode (wird gegenüber dem Zoom auf die selektierten Objekte und gegenüber "noZoom" vorrangig behandelt)

• clear: (optional) Gibt an, ob eine bestehene Selektion entfernt werden sollen. Standard: true

Beispiel

https://IhrCardo/net4/icom.ashx?action=select&layer=L34&field=id&value=1|2

---

Aktion "startApp"

Startet eine Anwendung

• app: Typname(n) der zu startenden Anwendung(en)

Bsp:: https://IhrCardo/net4/icom.ashx?action=startApp&app=IduIT.cardo.Core.Applications.FileBrowser.FileBrowserApplication

Hier eine (unvollständige) Auswahl der Namen der internen Anwendungen:

• Ebenenbaum: IduIT.cardo.Core.Applications.TreeView.TreeViewApplication
• Datenbrowser: IduIT.cardo.Core.Applications.FileBrowser.FileBrowserApplication
• Karte: IduIT.cardo.Core.Applications.OpenLayers.OpenLayersApplication
• Anwendungsmanager: IduIT.cardo.Core.Applications.AppManager.AppManagerApplication
• Dashboard: IduIT.cardo.Core.Applications.Dashboard.DashboardApplication
• Mein cardo: IduIT.cardo.Core.Applications.OwnDocuments.OwnDocumentApplication

Für den Aufruf von cardo3 Anwendungen:

Für cardo3 Anwendungen wird eine Wrapper Klasse im Namespace IduIT.cardo.Core.Sys.Cardo3Applications erstellt, die Klasse hat dabei immer den Namen Cardo3App_{id}, wobei hier die ID der Registrierung der Anwendung in der cardo3 Datenbank ist.

---

Aktion "edit.layer"

Startet den "AnySourceEditor" und lädt die übergebenen Datensätze anhand der ID. Hier muss eine editierbare Ebene angegeben werden, für die in den Edit-Einstellungen "cardo4: als Anydatasource bearbeiten" markiert ist.

Argumente:

• layer: Interner Ebenenname oder Ebenen-Tag der Ebene aus der Datensätze bearbeitet werden sollen (z.B. L34).

• pkField: Name der Primärschlüssel-Spalte (primary key); muss mit der Bearbeitungskonfiguration der Ebene übereinstimmen

• pkValues: Die ID-Werte; "|"-getrennt, mehrere möglich.

Beispiel

https://IhrCardo/net4/icom.ashx?action=edit.layer&layer=L34&pkField=id&pkValues=1|2

---

Aktion "mapping.showLayer"

Fügt die angegebene Ebenen in die Karte ein und passt evtl. Ausschnitt/und oder Maßstab mit an.

Ist bereits eine Kartenanwendung vorhanden, wird diese verwendet, sonst wird eine neue geöffnet.

Argumente:

• layers: Liste der Ebenennamen oder Ebenen-Tags, Trennzeichen ist ein Pipe "|" oder per das "separator=" angegebene Zeichen.

• zoomToLayers : (optional) Kartenausschnitt auf das Gebiet der hinzugefügten Ebene(n) setzen; Standard ist false

• mapScale : (optional) Maßstabszahl, auf die die Karte eingestellt werden soll (bspw.: 1000)

Beispiel

https://IhrCardo/net4/icom.ashx?action=mapping.showLayer&layers=L159|L1&zoomToLayers=true&mapScale=1000

---

Aktion "mapping.zoomToPoint"

Setzt den Mittelpunkt der Karte in der Kartenanwendung auf den angegebenen Punkt und stellt einen Abstand zum Kartenrand oder einen bestimmten Kartenmaßstab ein.

Ist bereits eine Kartenanwendung vorhanden, wird diese verwendet, sonst wird eine neue geöffnet.

Argumente:

• point: Der Punkt, auf den der Mittelpunkt der Karte gesetzt werden soll, in der Form x|y|epsgCode. Für Angaben in Grad ("GPS-Koordinaten") muss die Dezimalnotation verwendet werden, an der x-Position muss die Länge (Longitude), an der y-Position die Breite (Latitude) und als EPSG-Code die 4326 angegeben werden.

• offset: (optional) Mindestabstand vom Punkt zum Kartenrand in Metern; kommt nicht zur Wirkung, wenn mapScale angegeben ist; Standard: 1000

• mapScale: (optional) Maßstabszahl, auf die die Karte eingestellt werden soll (bspw.: 1000)

• mark: (optional) Gibt vor, ob der Punkt durch eine Markierug kenntlich gemacht werden soll. Standard: false

Beispiel

https://IhrCardo/net4/icom.ashx?action=mapping.zoomToPoint&point=486397|5638285|25833&mapScale=1000&mark=true