Zum Inhalt

ACPAddressMap

Beschreibung - Widget

Das Widget integriert eine Karte auf Basis von OpenStreetMap, auf der die Adresse aus einem Datensatz visualisiert wird.

image.png

Beschreibung - ACPGeoJsonService (Optional)

Die Adressdaten (Straße, PLZ und Ort) werden an den ACPGeoJsonService übermittelt. Dieser Service berechnet daraus die benötigten Kartendaten, speichert sie für zukünftige Abrufe im Datensatz und stellt sie anschließend dem Widget zur Verfügung.

Voraussetzungen

Das Widget kann mit oder ohne dem ACPGeoJsonService verwendet werden, je nachdem müssen unterschiedliche Voraussetzungen erfüllt werden.

Folgend Datenbankfelder sind im verwendeten Datensatz-Typ entsprechend der Verwendung erforderlich:

Datenbankanpassungen mit ACPGeoJsonService

Technischer Name Übersetzung Datenfeldtyp Zusätzliches
ACP_STREET Beliebig varchar 50 -
ACP_ZIP Beliebig varchar 10 -
ACP_CITY Beliebig varchar 50 -
ACP_COUNTRY Beliebig varchar 50 optional

Die Voraussetzungen für den ACPGeoJsonService, sind entsprechend hier zufinden: ACPGeoJsonService

Datenbankanpassungen ohne ACPGeoJsonService

Technischer Name Übersetzung Datenfeldtyp Zusätzliches
ACP_STREET Beliebig varchar 50 -
ACP_ZIP Beliebig varchar 10 -
ACP_CITY Beliebig varchar 50 -
ACP_SYNC_ADDRESS Beliebig varchar 250 -
ACP_LON Beliebig varchar 20 -
ACP_LAT Beliebig varchar 20 -
ACP_COUNTRY Beliebig varchar 50 optional

Datenbankanpassungen ohne ACPGeoJsonService und ohne Adressdaten

Technischer Name Übersetzung Datenfeldtyp Zusätzliches
ACP_LON Beliebig varchar 20 -
ACP_LAT Beliebig varchar 20 -

Installation Widget

Installationsanleitung finden Sie hier

Update Widget

Updateanleitung finden Sie hier

Konfiguration Widget

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\smartdesignapps\{@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.

Konfiguration mit ACPGeoJsonService 

"dataPoint":"SERVICE",
"geoJsonService":{
    "linkAttribute" : "ACP_VC2GEOJSON",
    "ApiKey": "ACP-kFmjvM7YRRKTWy3sNbgy"
    },
"info":{
    "land": "ACP_LAND"}

Konfiguration ohne ACPGeoJsonService 

"info":{
    "land": "ACP_LAND"
    },
"koordinate": {
    "breite": "ACP_LAT",
    "laenge": "ACP_LON"
    },
"syncField": {
    "field": "ACP_SYNC_ADDRESS"
    }

Konfiguration ohne ACPGeoJsonService und ohne Adressdaten 

"koordinate": {
    "breite": "ACP_LAT",
    "laenge": "ACP_LON"
    }

Beschreibung
  • dataPoint:
    • Beschreibung: Angabe ob der ACPGeoJsonService genutzt werden soll
    • Mögliche Werte: SERVICE
  • geoJsonService:
    • linkAttribute:
      • Beschreibung: Name des Verknüpfungsattributes
      • Mögliche Werte: beliebige Verknüpfung
    • ApiKey:
      • Beschreibung: Key aus den appsettings des ACPGeoJsonService
      • Mögliche Werte: ACP-KEY
  • info (optional):
    • land:
      • Beschreibung: Feldname für das Land
      • Mögliche Werte: entsprechendes Feld
  • koordinate:
    • breite:
      • Beschreibung: Feld für den Breitengrad
      • Mögliche Werte: entsprechendes Feld
    • laenge:
      • Beschreibung: Feld für den Längengrad
      • Mögliche Werte: entsprechendes Feld
  • syncField:
    • field:
      • Beschreibung: Variablennamen für die Übersetzung; Rolle des Knotens
      • Mögliche Werte: entsprechendes Feld

App Designer

  1. Loggen Sie sich im genesisWorld SmartDesign ein.
  2. Öffnen Sie die Administrations-App.
  3. Klicken Sie auf den App Designer Abschnitt im linken Teil der Seite.
  4. Klicken Sie im Kästchen Session auf "Aktivieren".
  5. Navigieren Sie im Anschluss in die App wo das Widget eingebunden ist.
  6. Öffnen Sie eine beliebige App und navigieren Sie zu einem beliebigen Datensatz.
  7. Klicken Sie am oberen rechten Rand der Seite auf "Anpassen".
  8. Klicken Sie nun auf das Widget um die Konfiguration zu bearbeiten.

image.png

Parameter Mögliche Werte Beschreibung
URL GeoJsonService http://ServerName/ URL des ACPGeoJsonService, wenn mit Service konfiguriert wird.
Konfigurationsdatei example-config.json Name und Dateiendung der zu verwendenden Konfigurationsdatei.
Strasse Hnr. Datenbankfeld Feld in welches die Straße und Hausnummer gespeichert ist.
Ort Datenbankfeld Feld in welches der Ort gespeichert ist.
PLZ Datenbankfeld Feld in welches die Postleitzahl gespeichert ist.
Anzeigebreite 400px Breite des Widgets
Anzeigehöhe 400px Höhe des Widgets

Übersetzung

Im Standard werden immer Deutsch und Englisch mitgeliefert (de.json; en.json). Anpassungen können in den Dateien vorgenommen werden, jedoch ist zu beachten, dass diese bei einem Update des Widget überschrieben werden.

Pfad zu den Übersetzungsdateien: 

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

Wenn Sie für eine Widget-Integration individuelle Übersetzungen benötigen, erstellen Sie eine Kopie der Standard-Sprachdatei und benennen diese passend zur Konfigurationsdatei des Widgets.

Vorgehen:

  • Konfigurationsdatei: Jedes Widget hat eine eigene Konfigurationsdatei, z.B. example-config.json.
  • Standardsprachdatei: Standardmäßig werden de.json und en.json verwendet.
  • Angepasste Sprachdatei: Erstellen Sie eine Kopie und benennen Sie sie z.B. example-config_de.json für Deutsch.

INFO

Wenn eine angepasste Sprachdatei verwendet wird, müssen die nachfolgenden Parameter in der Konfigurationsdatei des Widget auf true gesetzt werden. Weitere Informationen finden Sie hier.
- useTranslations
- useTranslationsConfiguration

Beispieldatei: 

{
    "NO_ADDRESS": "keine Adresse"
}

Beschreibung

NO_ADDRESS Anzeige wenn keine Adresse hinterlegt oder gefunden wird.

Konfiguration ACPGeoJsonService

Siehe hier: ACPGeoJSONService