VIS-Connector Administration

Im Folgenden werden die notwendigen Schritte beschrieben, um den VIS-Connector nebst ORF Modul als Basis für die Objektreferenzierung zu konfigurieren.

Installation und Konfiguration

ORF Einrichtung

Dieser Abschnitt widmet sich der initialen Einrichtung des Moduls ORF. Für die Funktion des VIS-Connectors ist es notwendig, dass ein VIS-Dokumenttyp (interner Typ des Moduls ORF) registriert ist. Dieser führt notwendige Daten zur Kommunikation mit dem VIS-Server mit, auf welche der VIS-Connector zugreift. Weiterhin sollte mindestens eine Ebene für die Verwendung zur Objektreferenzierung registriert sein.

Administrative Funktionen können über den ORF-Webservice unter:

http://ihrServer/net3/services/orfservice.asmx

aufgerufen werden.

Dort erhalten Sie eine Übersicht über die möglichen Methoden und können diese auch ausführen, wenn Sie über entsprechende Berechtigungen verfügen.

Die folgenden Schritte können entfallen, falls VIS-Dokumenttyp und entsprechende Ebenen schon angelegt wurden.

VIS-Dokumenttyp anlegen/aktualisieren

Rufen Sie die Methode RegisterOrUpdateVISDocumentTyp auf:

Tragen Sie folgendes in die Maske ein:

Parameter	Beschreibung
visServerUrl	Die Basis-Url des VIS-Servers: http://[IhrVisServer]/vis/
mandantId	Die Mandanten ID in der Form {123456789-ABCD-123A-0012-123456789ABC} (mit geschweiften Klammern)
userName	Nutzername für die VIS-Anmeldung (ggf. bei WindowsAuth mit vorangestellter Domäne: vissystem@lra)
password	Passwort für die VIS-Anmeldung
useDefaultProxy	Nutzung des in cardo hinterlegten Standard-Proxys (Werte: true / false)
visVersion	die genutzte VIS-Version (Werte: Vier / Fünf / Sechs)
useWindowsAuth	Windows Authentifizierung verwenden? (Werte: true / false)
ignoreSslCertificateErrors	alle SSL-Zertifikatsfehler ignorieren

Das zu verwendende Nutzerkonto sollte genügend Berechtigungen am VIS-Server besitzen. Die einzelnen Nutzer, welche den VIS-Connector verwenden, können dagegen eingeschränkte Rechte besitzen um ggf. nicht auf alle VIS-Objekte Zugriff zu erhalten.

Siehe auch: https://www.cardogis.com/?pgId=1028

Hinweis: Konfigurationsdaten im ORF-Kontext werden gecacht. Nach Änderungen wie dem Anlegen oder dem Aktualisieren von Dokumententypen leeren Sie im Anschluss den Cache über das Dashboard.

Ebene(n) registrieren

Damit es mindestens eine Quelle von zu referenzierenden Objekten gibt, muss noch mindestens eine Ebene für die Georeferenzierung registriert werden.

Rufen Sie die Methode RegisterOrfLayerStore auf:

Parameter	Beschreibung
sourceId	ID der Ebene in der Form 123 (Ebene L123)
idColumnName	Name der Primärschlüsselspalte
displayColumnName	optionale Angabe von kommagetrennten Spaltennamen für die Generierung des Datensatztitels
displayColumnFormat	aktuell nicht verwendet
searchRadius	Standard-Suchradius für diese Ebene in Metern (um Objekte in der Nähe zu finden)

Siehe auch: https://www.cardogis.com/?pgId=1030

Optional: GSS-Suche für Objektreferenzen konfigurieren

Meistens wird ein zu referenzierendes Objekt mit Hilfe der Karte ausgewählt. Es besteht jedoch die Möglichkeit für die Auswahl der Objekte eine GSS-Suche zu konfigurieren.

Die dazu notwendigen Hinweise finden Sie unter:

https://www.cardogis.com/?pgId=1030#5203

im Abschnitt Verwendung der GSS-Suche bei der Zuweisung der Objektreferenzen.

Verbindung zwischen VISKompakt und cardo

Im VisKompakt wird ein neuer Menüeintrag am Dokument bzw. an der Akte benötigt, welcher den VIS-Connector über eine URL startet unter Angabe des aktuellen VISKompakt-Geschäftsobjektes.

Ihr VIS-Betreuer kann einen entsprechenden Aktionsschalter im VISKompakt einrichten.

Der Aufruf des VIS-Connectors basiert auf der VIS-BoId und der Mandanten-Id.

Die URL zum Aufruf der VIS-Connector Anwendung muss dem folgenden Format entsprechen:

http://[CARDOSERVER]/net4/icom.ashx?action=visConnector.show&boid=[BUSINESS-OBJECT-ID]&vismandant=[VIS-MANDANT-ID]

Registrierung der Anwendung in cardo

Die Anwendung wird unter "Anwendungen verwalten" registriert. Danach werden noch die Standardberechtigungen für das Starten und das Verwalten der Anwendung gegeben.

Neu, seit v1.0.4:

Im Tab 'Einstellungen' lässt sich festlegen ob der VIS-SmartClient genutzt wird. In diesem Fall ist der Eintrag auf <ja> zu setzen. Dadurch werden Links zu VIS-Objekten in einer für den VIS-SmartClient-Protokollhandler nutzbaren Form ausgegeben. Bleibt das Feld frei oder wird <nein> ausgewählt, werden die Links wie bisher, für die Nutzung des VISKompakt WebClients aufbereitet. Nutzende, welche keinen SmartClient verwenden, müssen an dieser Stelle keine Anpassungen vornehmen.

Nutzung von globalen Symbolen

Die Geometrien der Referenzen können in der Karte angezeigt werden. Dabei kommen bestimmte Darstellungsstile zum Tragen.

Falls ein globaler Stil für die Geometrien dieser Anwendung angelegt wurde, wird dieser für die Darstellung der Georeferenzen genutzt.

• Stilname: IduIT.cardo.Core.CoreModules.Orf.Editor.ReferenceGeomStyle

Der Stil kann über die Anwendung Einstellungen -> Allgemeine Einstellungen -> cardo-Einstellungen -> Symbole erstellt bzw. geändert werden.

Weiterhin können Sie einen Stil direkt für die Ebene angeben, im Format:

IduIT.cardo.Map.VectorLayerSelection.L[SourceID]

wobei SourceID = Ebenennummer

Ist solch ein Stil vorhanden, werden die entsprechenden Georeferenzen in dem zu der Ebene passenden Stil dargestellt.

Weiterführende Informationen zu globalen Symbolen: https://www.cardogis.com/?pId=11372#p11372