Zum Inhalt

ACPCreateContract

Beschreibung - Widget

Durch einen Knopfdruck können Flurstücke zu Verträgen zusammengefasst werden. Dabei werden übereinstimmende Eigentümer als Gruppierungswert genutzt. Das Widget bietet außerdem die Möglichkeit, die Werte der erstellten Verträge anzupassen und einen Meilenstein zu verbinden. Es ist frei konfigurierbar, benötigt jedoch die aus dem Produkt Skejlo bekannten Datensätze.

image.png

Changelog

Changelog hier.

Voraussetzungen

Das Widget basiert auf den Datensätzen "Flurstücke", "Meilensteine", "Projekt" und "Verträge". Diese sind im Produkt Skejlo enthalten und werden hierfür benötigt.

Installation Widget

Installationsanleitung finden Sie hier

Update Widget

Updateanleitung finden Sie hier

Konfiguration Widget

Beim Mapping der Felder ist zu berücksichtigen, dass sowohl das Ausgangsfeld als auch das Zielfeld kompatibel sein müssen. Eine Konvertierung, beispielsweise von einem varchar in ein DateTime oder int, ist nicht möglich.

Beim Mapping der Verknüpfungen ist zu beachten, dass bei der Zielverknüpfungsart mindestens ein Datensatztyp mit der Ausgangsverknüpfungsart übereinstimmen muss. Das bedeutet, wenn die Ausgangsverknüpfungsart zwischen einer Adresse und einer Verkaufschance liegt, muss bei der Zielverknüpfungsart mindestens ein Datensatztyp definiert sein, der entweder eine Adresse oder eine Verkaufschance ist.

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\config

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

  3. Kopierte Datei bearbeiten.

Grundeinstellung 

{
    "shouldRefresh": true,
}

Beschreibung
  • shouldRefresh:
    • Beschreibung: Gibt an, ob nach der Erstellung der Datensätze das Projekt aktualisiert werden soll.
    • Mögliche Werte: true / false


parcel 

"parcel": {
        "objectType": "WI_FLURSTUECKE",
        "keyword": "KEYWORD",
        "description": "WI_EIGENTUEMER",
        "linkToProject": "WI_PRJ2FLR_01",
        "orderBy": "DO.Keyword ASC"
    },

Beschreibung
  • objectType:
    • Beschreibung: Datensatztyp für die Flurstücke.
    • Mögliche Werte: Sämtliche Datensätze die ein Flurstück darstellen können.
  • keyword:
    • Beschreibung: Beliebiges Feld aus dem Flurstück-Datensatztypen.
    • Mögliche Werte: Sämtliche Zeichenfolgen-Felder die auf objectType existieren.
  • description:
    • Beschreibung: Beliebiges Feld aus dem Flurstück-Datensatztypen.
    • Mögliche Werte: Sämtliche Zeichenfolgen-Felder die auf objectType existieren.
  • linkToProject:
    • Beschreibung: Beliebige Verknüpfung vom Flurstück zum Projekt.
    • Mögliche Werte: Sämtliche Verknüpfungen zwischen Flurstück und Projekt.
  • orderBy:
    • Beschreibung: Erlaubt es durch eine Abfrage zu bestimmen, auf welcher Art die Flurstücke, welche in der Liste angezeigt werden, sortiert werden.
    • Mögliche Werte: "DO" => Der Datensatz für die Flurstücke; "SO" => Der Datensatz auf welchem das Widget eingebunden ist.


owner 

"owner": {
        "objectType": "ADDRESS",
        "linkToParcel": "WI_FLR2ADR_07"
    },

Beschreibung
  • objectType:
    • Beschreibung: Datensatztyp für die Eigentümer.
    • Mögliche Werte: Sämtliche Datensätze die einen Eigentümer darstellen können.
  • linkToParcel:
    • Beschreibung: Beliebige Verknüpfung von der Adresse zum Flurstück.
    • Mögliche Werte: Sämtliche Verknüpfungen zwischen Adresse und Flurstück.


milestone 

"milestone": {
        "objectType": "WI_MEILENSTEIN",
        "milestoneField": "GWSTYPE",
        "keyword": "KEYWORD",
        "description": "GWSSTATUS",
        "linkToProject": "WI_MST2PRJ_01"
    },

Beschreibung
  • objectType:
    • Beschreibung: Datensatztyp für die Meilensteine.
    • Mögliche Werte: Sämtliche Datensätze die ein Meilenstein darstellen können.
  • milestoneField:
    • Beschreibung: Feld für den Typen des Meilensteins..
    • Mögliche Werte: Sämtliche Typen-Felder die auf objectType existieren.
  • keyword:
    • Beschreibung: Beliebiges Feld aus dem Meilenstein-Datensatztypen.
    • Mögliche Werte: Sämtliche Zeichenfolgen-Felder die auf objectType existieren.
  • description:
    • Beschreibung: Beliebiges Feld aus dem Meilenstein-Datensatztypen.
    • Mögliche Werte: Sämtliche Zeichenfolgen-Felder die auf objectType existieren.
  • linkToProject:
    • Beschreibung: Beliebige Verknüpfung vom Meilenstein zum Projekt.
    • Mögliche Werte: Sämtliche Verknüpfungen zwischen Flurstück und Projekt.


contract 

"contract": {
        "allPublic": false,
        "objectType": "WI_VERTRAG",
        "milestoneField": "WI_BEGINN_MS",
        "linkToOwner": "WI_VRT2ADR_01",
        "linkToParcel": "WI_VRT2FLR_01",
        "linkToMilestone": "WI_MST2VRT_01",
        "linkToProject": "ITDVRTPRJ",
        "fields": [
            {
                "field": "NOTES2",
                "defaultValue": "{{ TODAY }} - Vertrag wurde automatisch angelegt"
            },
            {
                "field": "WI_VERLAENGERUNG_EIN",
                "defaultValue": "Jahre"
            },
            {
                "field": "WI_BEGINN_MS_ZEIT",
                "defaultValue": 30
            },
            {
                "field": "WI_VERT_GEGENSTAND",
                "defaultValue": [
                    "Abstandsfläche",
                    "Rotorfläche",
                    "Standort",
                    "Weg"
                ]
            }
        ]
    }

Beschreibung
  • allPublic:
    • Beschreibung: Gibt an ob die Verträge als "Alle Öffentlich" erstellt werden sollen.
    • Mögliche Werte: true, false
  • objectType:
    • Beschreibung: Datensatztyp für die Verträge.
    • Mögliche Werte: Sämtliche Datensätze die einen Vertrag darstellen können.
  • milestoneField:
    • Beschreibung: Feld für den Typen des Meilensteins.
    • Mögliche Werte: Sämtliche Typen-Felder die auf objectType existieren.
  • linkToOwner:
    • Beschreibung: Beliebige Verknüpfung vom Vertrag zum Eigentümer.
    • Mögliche Werte: Sämtliche Verknüpfungen zwischen Vertrag und Eigentümer.
  • linkToParcel:
    • Beschreibung: Beliebige Verknüpfung vom Vertrag zum Flurstück.
    • Mögliche Werte: Sämtliche Verknüpfungen zwischen Vertrag und Flurstück.
  • linkToMilestone:
    • Beschreibung: Beliebige Verknüpfung vom Vertrag zum Meilenstein.
    • Mögliche Werte: Sämtliche Verknüpfungen zwischen Vertrag und Meilenstein.
  • linkToProject:
    • Beschreibung: Beliebige Verknüpfung vom Vertrag zum Projekt.
    • Mögliche Werte: Sämtliche Verknüpfungen zwischen Vertrag und Projekt.
  • fields:
    • Beschreibung: Beliebige Anzahl an Feldern die angezeigt werden sollen.
    • Mögliche Werte: Sämtliche Felder auf dem Vertrag.
    • Hinweis: Hier kann "{{ TODAY }}" als Platzhalter genutzt werden. Zudem müssen die Default-Values dem Typ des gW-Feldes entsprechen.


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
Anzeigehöhe 50px Höhe des Widgets
Konfigurationsdatei example-config.json Name und Dateiendung der zu verwendenden Konfigurationsdatei.

Ü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