ACPGeoJSONService

Beschreibung - Service

Dieser Service ruft Geo-Daten der Nominatim-API von OpenStreetMaps ab und legt diese per REST-API in genesisWorld an. Wenn für ein Objekt schon GeoJSON-Daten hinterlegt sind, werden diese direkt aus der genesisWorld abgerufen.

Voraussetzungen

Der Datenbanktyp und die -Felder können manuell Erstellt oder importiert werden.

Datenbanktyp / -felder manuell erstellen

1. Datensatz-Typ erstellen

   • Name: WI_GEO_JSON
   • Titel: GeoJson
   • Kürzel: GEOJ
   • Dieser Datensatz-Typ ist benutzersensitiv = True
   • Erweiterter Datensatz-Typ = True
     • Datensatz-Typ ist verknüpfbar = True
     • Replikation zulassen = True
     • Datensatz-Typ ist im CAS genesisWorld-Client sichtbar = True

2. Datenbankfelder erstellen

   Technischer Name	Übersetzung	Datenfeldtyp	Zusätzliches
   WI_DATA	Beliebig	nvarchar(max)	-
   WI_CITY	Beliebig	nvarchar(200)	-
   WI_ZIP	Beliebig	nvarchar(20)	-
   WI_STREET	Beliebig	nvarchar(200)	-

Datenbanktyp / -felder importieren

1. Öffnen Sie die CAS Software Management Konsole als Administrator und melden Sie sich an.
2. Öffnen Sie den Bereich "Datenbank" und navigieren Sie im linken Menü in den Ordner "Eigene Datensatz-Typen".
3. Klicken Sie auf den Reiter "Import / Export" und wählen den Punkt "Datensatz-Typ importieren" aus.
4. Navigieren Sie nun zu dem Ordner "Datenbank" im Installationspaket, wählen Sie die XML-Datei aus und klicken Sie auf "Öffnen".
5. Bestätigen Sie anschließend im oberen Teil mit "Übernehmen" die Änderungen. Der Datensatz-Typ und die Felder werden erstellt.

Verknüpfungen erstellen

• Beispiel mit Adresse und ACPGeoJson

  Interner Name	Datensatz-Typ A	Datensatz-Typ B	Art	Kardinalität	Datensatz-Typ A Bezeichnung	Datensatz-Typ B Bezeichnung
  ACP_ADR2GEO	Adressen	WI_GEO_JSON	gerichtet	1:n	Adresse	GeoJson

Konfiguration IIS - URL Rewrite

Konfigurationsanleitung finden Sie hier
Bei dem Service wird keine Systemvariable benötigt.

Installation Service

Installationsanleitung finden Sie hier

Update Service

Updateanleitung finden Sie hier

Konfiguration Service

Konfigurationsdatei

INFO

In diesem Abschnitt können Datensatztypen, Felder und Verknüpfungsarten konfiguriert werden.
Bitte beachten Sie, dass hier immer die technischen Namen eingetragen werden müssen. Dabei sollten die technischen Namen vollständig in Großbuchstaben geschrieben werden!

ACHTUNG

Bitte bearbeiten Sie niemals die Beispieldatei.
Wenn Sie Anpassungen vornehmen möchten, kopieren Sie die Beispieldatei und benennen Sie sie entsprechend um.

1. Im Datei-Explorer folgenden Pfad öffnen:

   C:\Program Files (x86)\Common Files\CAS-Software\Server\JavaServices\smartdesign-apps\{@DATENBANKNAME}\smartdesign.base\smartdesign\base\webcontent\{WIDGETNAME}\assets\configs
   

2. Datei "example-config.json" im selben Ordner kopieren und einen entsprechenden Namen geben.

3. Kopierte Datei bearbeiten.

GwCom

"GwCom": {
    "UserName": "Username",
    "Password": "Password",
    "Database": "Databasename"
  }

Authentifizierungsdaten zur genesisWorld Schnittstelle.

Beschreibung

• UserName:
  • Beschreibung: Benutzername mit administrativen Berechtigungen im genesisWorld.
  • Mögliche Werte: Username
• Password:
  • Beschreibung: Passwort des Benutzers
  • Mögliche Werte: Password
• Database:
  • Beschreibung: Datenbankname für welchen der Service zuständig ist.
  • Mögliche Werte: Databasename

ApiConfig

"ApiConfig": {
    "ApiKey": "ACP-dx082Dge90rJgU4Mhrco"
  }

Der Schlüssel muss selber generiert werden und muss aus "ACP-" und 20 Zeichen bestehen. Eine zufällige, 20-stellige Zeichenfolge kann mithilfe dieses Onlinetools erstellt werden. Tool

Dieser Schlüssel muss dann in den Widget konfiguriert werden, sofern auf den Service zugegriffen wird.

Beschreibung

• ApiKey:
  • Beschreibung: API-Schlüssel
  • Mögliche Werte: ACP-dx082Dge90rJgU4Mhrco

ServiceConfig

"ServiceConfig": {
    "DisplayName": "ACP GeoJson",
    "ServiceName": "ACPGeoJson",
    "ServiceDescription": "Ein Service zur Rückgabe oder Erzeugung von GeoJson-Objekten"
  }

Authentifizierungsdaten zur genesisWorld Schnittstelle.

Beschreibung

• DisplayName:
  • Beschreibung: Anzeigename des Service
  • Mögliche Werte: Beliebiger String
• ServiceName:
  • Beschreibung: Name des Service, zum starten oder stoppen etc.
  • Mögliche Werte: Beliebiger String ohne Leerzeichen, Slash "/", oder Backslash "\"
• ServiceDescription:
  • Beschreibung: Beschreibung des Service
  • Mögliche Werte: Databasename

AllowedHosts

"AllowedHosts": "*"

Beschreibung

• AllowedHosts:
  • Beschreibung: Whiteliste von welchen Hosts auf den Service zugegriffen werden darf.
  • Mögliche Werte: Hostname