September 2016 WEBORDERSYSTEM 3.0. WOS-Connector-IP-DHK Server. Administrationshandbuch

Transkript

1 September 2016 WEBORDERSYSTEM 3.0 WOS-Connector-IP-DHK Server Administrationshandbuch

2 AED-SICAD Aktiengesellschaft Postfach D München Ihre Anregungen Wir nehmen gerne Ihre Rückmeldungen und Anregungen zu diesem Handbuch entgegen. Ihre Hinweise helfen uns dabei, die Dokumentation auf die Anforderungen unserer Kunden hin zu optimieren. Ein entsprechendes Faxformular finden Sie im hinteren Teil dieser Dokumentation. Natürlich können Sie uns Ihre Anregungen auch gerne online über unsere Homepage übermitteln.

3 WebOrderSystem 3.0 WOS-Connector-IP-DHK Server Administrationshandbuch

4 Wir bieten Ihnen Schulungen...zu dem in diesem Handbuch beschriebenen Produkt...und zu vielen weiteren AED-SICAD relevanten Themen Unser Training Center steht Ihnen bei Fragen gerne zur Verfügung. AED-SICAD Aktiengesellschaft Training Center Postfach D München Aktuelle Informationen über verfügbare Kurse finden Sie auch auf unserer Homepage Alle verwendeten Hard- und Softwarenamen sind Handelszeichen und/oder Warenzeichen der jeweiligen Hersteller. Copyright by AED-SICAD Aktiengesellschaft, All rights, including rights of translation, reproduction by printing, copying or similar methods, even of parts, are reserved. Offenders will be liable for damages. All rights, including rights created by parent grant or registration of a utility model or design, are reserved. Delivery subject to availability; right of technical modifications reserved.

5 Inhalt 1 Einleitung Technische Administration Konfiguration Datei web.xml GIS-Portal URM - Konfiguration Zugriffsberechtigung der öffentlichen Schnittstellen Fachliche Administration Anpassung IP-DHK Server Benutzungsauftrag Konfigurationsdatei wosipdhkserverproductconfig.xml XML-Element <Produkt> XML-Element <Fachauswahl> XML-Elemente <QuellSRS> XML-Elemente <ZielSRS> Überwachung der Software-Komponente Erreichbarkeit der Komponente Logging-Datei - WOS-Connector-IP-DHK_Server.log Einsatz von selbstsignierten SSL Serverzertifikaten HTTP und HTTPS Proxy Abbildungsverzeichnis AED-SICAD Aktiengesellschaft 5 / 24

6 1 Einleitung Der WOS-Connector-IP-DHK Server wird benötigt, um aus dem WOS den Export von AAA-Daten (AFIS, ALKIS, ATKIS) über den Produktionsdienst IP-DHK Server analog dem 3A Server zu ermöglichen. Der WOS-Connector-IP-DHK Server implementiert hierzu das WOS-API für Produktionsdienste und kann damit als Produktionsdienst in den WOS eingebunden werden. Der WOS-Connector-IP-DHK Server nutzt das API des IP-DHK Servers (Benutzungsauftrag), um den Export von AAA Daten anzustoßen. Das Zusammenstellen der zu bestellenden Daten kann über die WOS OrderClient Komponenten GeoShop oder Datenexport erfolgen. Diese ermöglichen es, durch den Datenbestand auf einer Kartendarstellung zu navigieren und anschließend ein räumliches Bestellgebiet, ein Produkt sowie dessen Produktionsparameter auszuwählen. Die Auswahl kann im Anschluss als eigenständige Bestellposition in den Warenkorb abgelegt werden. Abbildung 1: WOS OrderClient Komponente Datenexport Nach dem Bestellen wird durch WOS OrderService der WOS-Connector-IP-DHK Server zur Bereitstellung der Daten aufgerufen. Der Aufruf erfolgt über die SOAP Schnittstelle ProductionService des WOS-Connector-IP-DHK Server. Als Produktionsparameter werden - das Bestellgebiet, - das ausgewählte Produkt, - die ausgewählte Fachauswahl, - das ausgewählte Zielformat (nur NAS möglich) und - das ausgewählte ZielSRS (Raumbezugssystem) in welchem die AAA Daten abgegeben werden, übergeben. Jedem Produkt können 1-n Fachauswahlen, Zielformate und Zielkoordinatensysteme zugeordnet werden. Die möglichen Kombinationen werden nach fachlichen Kriterien durch die WOS OrderClient Komponenten vorgegeben. Weitere Details hierzu entnehmen Sie bitte dem WOS OrderClient Administrationshandbuch. Über den Parameter Fachauswahl können verschiedene Objektgruppen von AAA-Daten selektiert werden. Damit kann der Umfang der zu exportierenden AAA-Daten eingeschränkt werden. Die Menge AED-SICAD Aktiengesellschaft 6 / 24

7 der Objektarten einer Objektgruppe wird in einem Benutzungsauftrag festgelegt. Der Umfang der Objektarten einer Objektgruppe kann projektspezifisch unterschiedlich sein. Für ALKIS- Standardprodukte sind beispielsweise die folgenden Fachauswahlen (Objektgruppen) möglich. o o o o o o o o Alle Flurstücke, Lage, Punkte Eigentümer Gebäude Tatsächliche Nutzung Bauwerke, Einrichtungen und sonstige Angaben Relief Gesetzliche Festlegungen, Gebietseinheiten, Kataloge Über den Parameter Zielformat kann das Ausgabeformat festgelegt werden. Der IP-DHK Server bietet nur die Abgabe von Daten im NAS Standardformat an. Über den Parameter ZielSRS kann das Raumbezugssystem (SRS) gewählt werden, in dem die Daten exportiert werden. Der Umfang der Zielformate ist abhängig, von den im IP-DHK Server zur Verfügung stehenden Transformationsbibliotheken. WOS-Connector-IP-DHK Server unterstützt die asynchrone Variante der Kommunikation zwischen WOS OrderService und einem Produktionsdienst. Mit der ersten Anfrage werden durch den WOS OrderService die Produktionsparameter an den WOS-Connector-IP-DHK Server übermittelt. WOS- Connector-IP-DHK Server erstellt aus diesen Produktionsparametern einen Benutzungsauftrag und übergibt diesen an das IP-DHK Server Auftragsmanagement. Durch das IP-DHK Server Auftragsmanagement wird im Anschluss für den Auftrag eine eindeutige Auftrags-ID erstellt. Diese Auftrags-ID wird zur Identifizierung des Auftrags bei späteren Anfragen durch den WOS-Connector-IP- DHK Server erfragt und in der Rückantwort an den WOS OrderServer übermittelt. In regelmäßigen Zeitabständen (siehe WOS OrderService Administrationshandbuch) wird durch den WOS OrderService am WOS-Connector-IP-DHK Server der Status des Produktionsauftrags erfragt. Dazu wird die eindeutige Auftrags-ID aus der ersten Anfrage an den WOS-Connector-IP-DHK Server zur Identifizierung des Auftrags übermittelt. WOS-Connector-IP-DHK Server erfragt mittels dieser Auftrags-ID den Status des Auftrags am IP-DHK Server Auftragsmanagement. Wurde die Produktion durch den IP-DHK Server abgeschlossen (erfolgreich oder nicht) wird dies dem WOS OrderService mit der nächsten Statusabfrage mitgeteilt. Zusätzlich werden in der letzten Rückantwort durch den WOS-Connector-IP-DHK Server eindeutige Kennungen zur Identifizierung der Produktionsdaten und Protokolle an den WOS OrderService geliefert. Hinweis: Um doppeltes Kopieren zu vermeiden, werden die Produktionsdaten nicht aus dem IP- DHK Server Auftragsmanagement in die Zwischenablage des Produktionsdienstes kopiert. In der Zwischenablage befinden sich lediglich die Produktionsprotokolle des WOS- Connector-IP-DHK Server. Ein Streaming der Produktionsdaten erfolgt direkt aus dem IP- DHK Server Auftragsmanagement. Über die HTTP Schnittstelle StreamingService des WOS-Connector-IP-DHK Server kann der WOS OrderService in Anschluss die Produktionsdaten und Protokolle herunterladen. Nach erfolgreichem Download wird durch den WOS OrderService das Löschen der Protokolle aus der Zwischenablage über die HTTP Schnittstelle StreamingService angestoßen. Die Produktionsdaten verbleiben im IP- DHK Server Auftragsmanagement. Produktionsdaten und Protokolle werden im Anschluss dem Kunden über das DownloadCenter zum Abruf bereitgestellt. AED-SICAD Aktiengesellschaft 7 / 24

8 2 Technische Administration Hinweis: Ab WOS werden die meisten Konfigurationen über das User & Ressource Management (URM) durchgeführt. Hierfür werden Administrationsrechte am URM benötigt. Hinweis: Die folgenden Administrationsschritte wurden bereits durch das Setup während der Installation durchgeführt und dienen zur Dokumentation für spätere Veränderungen der Administration der Anwendung. 2.1 Konfiguration Datei web.xml Die Datei web.xml stellt die zentrale Konfiguration der Web-Applikation dar. Sie wird während der Installation automatisch erstellt und an die Installationsumgebung angepasst. Nachträgliche Änderungen sollten sich auf die Pfadangabe zur GIS-Portal Konfigurationsdatei URM.xml beschränken. Passen Sie hierzu den in der folgenden Abbildung dargestellten Parameter URMXMLPATH an. Sämtliche weiteren Konfigurationsparameter der Komponente sind im GIS-Portal URM hinterlegt. (siehe Kap.: 2.2 ) Abbildung 2: Verknüpfung zur Konfigurationsdatei URM.xml Hinweis: Beachten Sie die Schreibweise der Pfadangabe. ( \ durch / ersetzen) 2.2 GIS-Portal URM - Konfiguration Die Konfiguration des WOS-Connector-IP-DHK Server finden Sie im URM unter WebOrderSystem / Konfiguration / Produktionsdienste / WOS-Connector-IP-DHK Server / Ressourceneigenschaften bearbeiten. Nachfolgend werden die einzelnen Parameter näher erläutert. AED-SICAD Aktiengesellschaft 8 / 24

9 ProductionService URL Abbildung 3: Konfiguration des WOS-Connector-IP-DHK Server Geben Sie an dieser Stelle die vollständige URL zur SOAP Schnittstelle ProductionService an (z.b. Anfrageart Produktionsdienste können durch WOS OrderService synchron oder asynchron angefragt werden. WOS-Connector-IP-DHK Server unterstützt die Anfrageart asynchron. StreamingService URL Geben Sie an dieser Stelle die vollständige URL zur HTTP Schnittstelle StreamingService an (z.b. PricingService URL Für den Produktionsdienst WOS-Connector-IP-DHK Server wird eine Preisberechnung im Zusammenhang mit der WOS OrderClient Komponente Datenexport angeboten. Nähere Erläuterungen dazu finden Sie im WOS OrderClient Administrationshandbuch. AED-SICAD Aktiengesellschaft 9 / 24

10 Konfiguration des Produktionsdienstes Produktkonfigurationsdatei Die Produktkonfigurationsdatei enthält die Zuordnung der WOS OrderService Produktionsparameter zu dem IP-DHK Server Parametern in einem Benutzungsauftrag. Geben Sie an dieser Stelle den absoluten Pfad zu der Konfigurationsdatei an (z.b. %TOMCAT_HOME%\webapps\WOSConnectorIPDHKServer_Mandant\etc\wosipdhkserverpr oductconfig.xml). Protokollverzeichnis Geben Sie an dieser Stelle den absoluten Pfad für die Zwischenablage der Produktionsprotokolle an (z.b. C:\AED-SICAD\WOS\WOS-Connector-IP-DHK Server\protocol). Das Verzeichnis der Zwischenablage muss für den HTTP StreamingService mittels Standardoperationen auf dem Dateisystem erreichbar sein. Bitte prüfen Sie hierfür die Zugriffsberechtigungen. Webservice Timeout [sec] Zeitdauer in Sekunden für das Warten auf Rückantwort von HTTP-Anfragen an den IP-DHK Server. 2.3 Zugriffsberechtigung der öffentlichen Schnittstellen WOS-Connector-IP-DHK Server bietet anderen Komponenten zwei öffentliche Schnittstellen an: - SOAP Schnittstelle ProductionService - HTTP Schnittstelle StreamingService Der Zugriff auf Methoden dieser Schnittstellen wird durch ein Rechtekonzept im GIS-Portal URM eingeschränkt. Hierzu wird mit jedem Funktionsaufruf ein Token übertragen. Mittels Token kann ein Aufruf eindeutig einem im URM bekannten Nutzer und damit seinen Berechtigungen zugeordnet werden. Die Token-Verwaltung wird zentral durch das GIS-Portal zur Verfügung gestellt. Während der Installation des WOS-Connector-IP-DHK Servers wurden im GIS-Portal URM die notwendigen Ressourcen, Rechte und Rollen erstellt. Die beiden Schnittstellen sowie die Methoden der Schnittstellen wurden als Ressourcen unterhalb Ressourcen / WebOrderSystem / Funktionen / Produktionsdienste / WOS-Connector-IP-DHK Server eingetragen. Jeder Ressource, die eine Methode einer Schnittstelle abbildet, wurde zusätzlich ein Recht execute hinzugefügt. AED-SICAD Aktiengesellschaft 10 / 24

11 Abbildung 4: Ressourcen der öffentlichen Schnittstellen Die erstellten Ressourcen und Rechte der Schnittstellen werden in der vorinstallierten Rolle WOS- Connector-IP-DHK Server zusammengefasst. Abbildung 5: Zuordnung Schnittstellen-Ressourcen und Rechte zu Rolle WOS-Connector-IP-DHK Server Diese Rolle muss (z.b. über ein Kunden- oder Mitarbeiterprofil) dem angemeldeten Kunden zugewiesen werden. Bei einer Bestellung (z.b. über die WOS OrderClient Komponenten GeoShop oder Datenexport) wird für den angemeldeten Kunden im GIS-Portal ein Token erstellt und verwaltet. Dem WOS OrderService wird das Token mit der Bestellung des Warenkorbs übergeben. Für die Produktion der Bestellposition ruft der WOS OrderService den WOS-Connector-IP-DHK Server auf. Dieser Aufruf enthält neben den Produktionsparametern zusätzlich ein Token welches mit dem angemeldeten Kunden verknüpft ist. AED-SICAD Aktiengesellschaft 11 / 24

12 Beim Aufruf einer Schnittstellenmethode wird zuerst geprüft, ob der mit dem Token verknüpfte Kunde das Recht execute an der jeweiligen Schnittstellenmethode besitzt. Nur wenn dieses Recht zugewiesen ist, wird der Aufruf der Methode akzeptiert. AED-SICAD Aktiengesellschaft 12 / 24

13 3 Fachliche Administration Der Export von AAA-Daten aus dem IP-DHK Server erfolgt unter Verwendung von Benutzungsaufträgen. Um einen Benutzungsauftrag im WOS-Connector-IP-DHK Server für die Produktion nutzen zu können, muss er angepasst werden. Dabei werden Informationen aus dem Benutzungsauftrag entfernt, die später durch dem WOS-Connector-IP-DHK Server für die jeweilige Produktion angepasst oder ersetzt werden müssen. (z.b. Bestellgebiet, Zielformat, ZielSRS) Die Zuordnung der Produktionsparameter aus dem WOS OrderService Produktionsauftrag zu den Parametern des IP-DHK Servers im Benutzungsauftrag wird über die Konfigurationsdatei wosipdhkserverproductconfig.xml beschrieben. Die folgenden beiden Unterkapitel erläutern die Anpassung von Benutzungsaufträgen und die Konfigurationsparameter der Konfigurationsdatei wosipdhkserverproductconfig.xml. 3.1 Anpassung IP-DHK Server Benutzungsauftrag Die Erstellung von Benutzungsaufträgen entnehmen Sie bitte der Dokumentation des IP-DHK Servers. Die folgende Abbildung zeigt beispielhaft einen Ausschnitt aus einem solchen Benutzungsauftrag. Abbildung 6: IP-DHK Server Benutzungsauftrag Um die Benutzungsaufträge für Datenabgaben im WOS-Connector-IP-DHK Server nutzbar zu machen, müssen die Benutzungsaufträge in Benutzungsauftrags-Templates umgewandelt werden. Suchen Sie dazu zuerst sämtliche XML Tags mit der Bezeichnung ogc:intersects, ogc:contains oder ogc:overlaps im Benutzungsauftrag. Entfernen Sie innerhalb der gefundenen XML-Tags die Geometrieangabe (z.b. XML Tag gml:multisurface oder gml:polygon) Das zusätzlich vorhandene XML Tag ogc:propertyname muss erhalten bleiben. AED-SICAD Aktiengesellschaft 13 / 24

14 Abbildung 7: Beispiel vor dem Entfernen der Geometrieangabe Abbildung 8: Beispiel nach dem Entfernen der Geometrieangabe Speichern Sie dieses Benutzungsauftragstemplate nach der Bearbeitung als XML Datei im Dateisystem ab. Der WOS-Connector-IP-DHK Server muss mittels Standarddateioperationen des Betriebssystems die Datei erreichen und lesen können. Hinweis: Durch die Installation der WOS Komponente WOS-Connector-IP-DHK Server wurde bereits im Kontext der Web-Applikation ein Unterverzeichnisse mit der Benennung etc_ni mit einem vordefinierten Benutzungsauftragstemplate erstellt. Zur Ausführungszeit werden die folgenden Setzungen in den Benutzungsauftrag-Templates mit den Produktionsparametern aus der WOS OrderService Produktionsanfrage ersetzt. - Ersetzung des räumlichen Bestellgebietes: Dazu wird das aktuelle Bestellgebiet in die XML Tags ogc:intersects, ogc:contains oder ogc:overlaps eingetragen. - Ersetzung des räumlichen Bezugssystems (SRS): Das XML Tag koordinatenreferenzsystem definiert ein von dem AAA-Daten im IP-DHK Server abweichendes SRS für die Datenabgabe. Ist das SRS der AAA-Daten im IP-DHK Server mit den gewünschten Abgabe-SRS identisch, wird dieser Tag automatisch aus dem Benutzungsauftrag entfernt. - Ersetzung des Datenformats: Das XML Tag datenformat definiert das Format (z.b. NAS) in welchen die AAA-Daten abgegeben werden. Abgaben von AAA-Daten, abweichend von dem Standardformat NAS werden nicht unterstützt. - Ersetzung der Antragsnummer: Das XML Tag antragsnummer überträgt die mit dem Produktionsauftrag übermittelte Antragsnummer in den Benutzungsauftrag. Wurde keine AED-SICAD Aktiengesellschaft 14 / 24

15 Antragsnummer mit dem Produktionsauftrag übergeben, wird durch den WOS-Connector-IP- DHK Server automatisch eine eindeutige Antragsnummer erstellt. - Ersetzung der Profilkennung: Das XML Tag profilkennung wird mit dem Inhalt des gleichnamigen Produktionsparameters des WOS OrderService Produktionsauftrags gefüllt. 3.2 Konfigurationsdatei wosipdhkserverproductconfig.xml Hinweis: Die folgenden Konfigurationsparameter sind beim Einsatz der WOS OrderClient Komponente Datenexport oder WOS GeoShop von dessen Produktkonfiguration abhängig. Beachten Sie hierzu weitere Hinweise in dem WOS OrderClient Administrationshandbuch. Die Datei wosipdhkserverproductconfig.xml wird während der Durchführung des Setups nicht vorab erstellt. Erstellen Sie daher zuerst eine Kopie der mit dem Setup gelieferten Datei wosipdhkserverproductconfig.xml _template und benennen Sie diese in wosipdhkserverproductconfig.xml um. Führen Sie anschließend die im Folgenden beschriebene Konfiguration durch. In der Datei wosipdhkserverproductconfig.xml werden Produkte definiert. Diese Produkte stehen in einer Beziehung mit der Produktkonfiguration der WOS OrderClient Komponenten Datenexport oder WOS GeoShop. Sie finden die Datei im folgenden Verzeichnis: %WOSCONNECTORIPDHKSERVER_HOME%\etc Die Parameter der Datei wosipdhkserverproductconfig.xml werden in den folgenden Unterkapiteln beispielhaft an Hand der folgenden Abbildung beschrieben: Abbildung 9: WOS-Connector-IP-DHK Server Konfigurationsdatei wosipdhkserverproductconfig.xml XML-Element <Produkt> Es können beliebig viele Elemente des Typs Produkt (<Produkt> </Produkt>) definiert werden. Das Element Produkt hat die folgenden Attribute: id Definiert die Id des Produkts. Die Produkt-Id muss eindeutig für alle im WOS-Connector-IP- DHK Server definierten Produkte sein (Schlüsselattribut). Die Produkt-Id muss beim Aufruf vom Bestellsystem (WOS) übergegeben werden. Die Produkt-Id muss daher mit dem aufrufenden Bestellsystem abgeglichen werden. (siehe Produktkonfiguration Bestellklient WOS Datenexport oder WOS GeoShop) name Definiert den Produktnamen. Der Produktname muss beim Aufruf vom Bestellsystem (WOS) übergegeben werden. Der Produktname muss daher mit dem aufrufenden Bestellsystem AED-SICAD Aktiengesellschaft 15 / 24

16 abgeglichen werden. (siehe Produktkonfiguration Bestellklient WOS Datenexport oder WOS GeoShop) AAAServerUrl URL des IP-DHK Server (an den ein Benutzungsauftrag gesendet wird). AAAServerLoginUrl URL des IP-DHK Loginserver (verschlüsselte SSL Verbindung). AAAServerLoginDeactivateSSLCertificateVerification Wird dieser Parameter auf true gestellt, kann die Überprüfung des SSL Serverzertifikates für den Verbindungsaufbau zum Loginserver deaktiviert werden. Dies ist z.b. beim Einsatz eines selbstsignierten SSL Serverzertifikat notwendig. Der Umgang mit selbstsignierten SSL Serverzertifikaten wird in einem späteren Kapitel beschrieben. Achtung: Das Abschalten der Überprüfung von SSL Serverzertifikates stellt ein Sicherheitsrisiko dar! AAAServerLoginUser Benutzername zur Anmeldung am IP-DHK Loginserver. AAAServerLoginPasswort Passwort zur Anmeldung am IP-DHK Loginserver. (GIS Portal Passwortverschlüsselung, mehr Infos finden Sie dazu im GIS-Portal-Administrationshandbuch, Kapitel ) XML-Element <Fachauswahl> Einem Produkt (siehe XML-Element <Produkt>) können beliebig viele Elemente des Typs Fachauswahl (<Fachauswahl> </Fachauswahl>) zugeordnet werden. Eine Fachauswahl definiert eine Auswahl von 1-n Layern bzw. Layergruppen eines Produkts. Abbildung 10: WOS-Connector-IP-DHK Server - wosipdhkserverproductconfig.xml Fachauswahlen Das XML-Element <Fachauswahl> hat die folgenden Attribute: id Das Attribut id stellt eine eindeutige Referenz auf die ID eines Wertes des Produktparameters Fachauswahl in der Produktkonfigurationsdatei des Bestellklienten WOS Datenexport oder WOS GeoShop her. (Weitere Informationen hierzu finden Sie im Administrationshandbuch der Komponente WOS OrderClient.) gidversion GeoInfoDok Version des IP-DHK Server Benutzungsauftragstemplates. AAAServerBenutzungsauftragTemplateFile Das Attribut AAAServerBenutzungsauftragTemplateFile enthält den Pfad zur Datei mit dem Benutzungsauftrag-Template (siehe Kapitel 2). In dieser Datei wird ein IP-DHK Server Benutzungsauftrag gespeichert. Insbesondere werden alle Objektarten zu der im Attribut id festgelegten Objektartengruppe aufgelistet. AED-SICAD Aktiengesellschaft 16 / 24

17 3.2.3 XML-Elemente <QuellSRS> Einem Produkt (siehe XML-Element <Produkt>) wird ein Element des Typs QuellSRS (<QuellSRS>) zugeordnet werden. Hiermit wird definiert, in welchem Raumbezugssystem (oder Spatial Reference System) die Daten im IP-DHK Server vorliegen. Abbildung 11: WOS-Connector-IP-DHK Server - wosipdhkserverproductconfig.xml QuellSRS Das XML-Element <QuellSRS> enthält die folgenden Attribute: id Das Attribut id stellt eine eindeutige Referenz auf die ID eines Wertes des Produktparameters QuellSRS in der Produktkonfigurationsdatei des Bestellklienten WOS Datenexport oder WOS GeoShop her. (Weitere Informationen hierzu finden Sie im Administrationshandbuch der Komponente WOS OrderClient.) AAAServerBezeichnung Das Attribut AAAServerBezeichnung enthält die Bezeichnungen des Raumbezugssystems im IP-DHK Server (siehe Kapitel 2, XML-Element <wfs: Query> des IP-DHK Server Benutzungsauftrags) XML-Elemente <ZielSRS> Einem Produkt (siehe XML-Element <Produkt>) können beliebig viele Elemente des Typs ZielSRS (<ZielSRS>) zugeordnet werden. Hiermit wird definiert in welchem Raumbezugssystem (oder Spatial Reference System) die Daten im IP-DHK Server bereitgestellt werden. Bei der Bereitstellung der Daten in einem Lagebezugssystem, welches nicht identisch ist mit dem QuellSRS, muss eine entsprechende Transformationsbibliothek in den IP-DHK Server eingebunden werden. Abbildung 12: WOS-Connector-IP-DHK Server - wosipdhkserverproductconfig.xml ZielSRS Das XML-Element <ZielSRS> enthält die folgenden Attribute: id Das Attribut id stellt eine eindeutige Referenz auf die ID eines Wertes des Produktparameters ZielSRS in der Produktkonfigurationsdatei des Bestellklienten WOS Datenexport oder WOS GeoShop her. (Weitere Informationen hierzu finden Sie im Administrationshandbuch der Komponente WOS OrderClient.) AAAServerBezeichnung Das Attribut AAAServerBezeichnung enthält die interne Bezeichnungen des Raumbezugssystems im IP-DHK Server (siehe Kapitel 2 XML-Element <koordinatenreferenzsystem> des IP-DHK Server Benutzungsauftrags). AED-SICAD Aktiengesellschaft 17 / 24

18 4 Überwachung der Software-Komponente 4.1 Erreichbarkeit der Komponente Um die Erreichbarkeit von WOS-Connector-IP-DHK Server zu testen, öffnen Sie einen Browser und geben Sie in die Adresszeile die URL ein. Ersetzen Sie <port> durch den von Ihrem Tomcat verwendeten Port und Mandant durch die Mandantenbezeichnung, die Sie ganz zu Anfang des Installationsvorgangs von WOS-Connector-IP- DHK Server gewählt haben. Es öffnet sich die nachfolgend abgebildete Versionsinformation zum WOS-Connector-IP-DHK Server. Abbildung 13: Versionsinformation des WOS-Connector-IP-DHK Server (Versionsnummer kann variieren) 4.2 Logging-Datei - WOS-Connector-IP-DHK_Server.log Die Komponente WOS-Connector-IP-DHK Server protokolliert in die Log-Datei WOS-Connector-IP- DHK_Server.log. Diese befindet sich bei einer Standardinstallation im folgenden Verzeichnis: %TOMCAT_HOME%\webapps\WOSConnectorIPDHKServer_%Mandant%\WEB-INF\logs AED-SICAD Aktiengesellschaft 18 / 24

19 5 Einsatz von selbstsignierten SSL Serverzertifikaten Wird durch den IP-DHK Server am Loginserver ein selbstsigniertes SSL Serverzertifikat angeboten, müssen zusätzliche Einstellungen getroffen werden. In der Produktkonfigurationsdatei muss die Überprüfung des SSL Serverzertifikates deaktiviert werden. (siehe Kapitel 3.2.1) Das selbstsignierte SSL Serverzertifikat muss in einen lokalen Keystore geladen und dem Tomcat bekannt gemacht werden. Dazu Laden Sie das SSL Zertifikat dazu herunter und speichern Sie es in einer Datei. Legen Sie mit dem folgenden Befehl einen Keystore an und importieren Sie das Zertifikat in den Keystore %JAVA_HOME%\bin\keytool -import -v -trustcacerts -file <CertFile> -keystore truststore.ks Führen Sie die Datei tomcat8w.exe (Tomcat 8 Installation) im bin Ordner ihrer Tomcat Installation aus. Wechseln Sie in den Karteireiter Java Fügen Sie unter den Java Options die folgenden beiden Parameter hinzu. -Djavax.net.ssl.trustStore=<Pfad zum Keystore>\truststore.ks -Djavax.net.ssl.trustStorePassword=<Keystore Passwort> AED-SICAD Aktiengesellschaft 19 / 24

20 6 HTTP und HTTPS Proxy Ist für die Verbindung zum IP-DHK Server ein HTTP/HTTPS Proxy notwendig, führen Sie die folgenden Konfigurationsschritte an Ihrer Apache Tomcat durch. Führen Sie die Datei tomcat8w.exe (Tomcat 8 Installation) im bin Ordner Ihrer Tomcat Installation aus. Wechseln Sie in den Karteireiter Java Fügen Sie unter den Java Options die folgenden beiden Parameter hinzu. -Dhttp.proxyHost=<http Proxy> -Dhttp.proxyPort=8080 -Dhttps.proxyPort=8080 -Dhttps.nonProxyHost=<https Proxy> AED-SICAD Aktiengesellschaft 20 / 24

21 7 Abbildungsverzeichnis Abbildung 1: WOS OrderClient Komponente Datenexport... 6 Abbildung 2: Verknüpfung zur Konfigurationsdatei URM.xml... 8 Abbildung 3: Konfiguration des WOS-Connector-IP-DHK Server... 9 Abbildung 4: Ressourcen der öffentlichen Schnittstellen Abbildung 5: Zuordnung Schnittstellen-Ressourcen und Rechte zu Rolle WOS-Connector-IP- DHK Server Abbildung 6: IP-DHK Server Benutzungsauftrag Abbildung 7: Beispiel vor dem Entfernen der Geometrieangabe Abbildung 8: Beispiel nach dem Entfernen der Geometrieangabe Abbildung 9: WOS-Connector-IP-DHK Server Konfigurationsdatei wosipdhkserverproductconfig.xml Abbildung 10: WOS-Connector-IP-DHK Server - wosipdhkserverproductconfig.xml Fachauswahlen Abbildung 11: WOS-Connector-IP-DHK Server - wosipdhkserverproductconfig.xml QuellSRS Abbildung 12: WOS-Connector-IP-DHK Server - wosipdhkserverproductconfig.xml ZielSRS 17 Abbildung 13: Versionsinformation des WOS-Connector-IP-DHK Server (Versionsnummer kann variieren) AED-SICAD Aktiengesellschaft 21 / 24

22

23 AED-SICAD Aktiengesellschaft Postfach D München Ihre Anregungen Absender: Produkt: Kommentare:

24 Herausgegeben von / Published by AED-SICAD Aktiengesellschaft Postfach D München Printed in Germany