ACPRightsFromContract

Beschreibung - Widget

Durch einen Knopfdruck wird es ermöglicht Nutzungsrechte vom Vertrag aus zu erstellen. Die erstellten Nutzungsrechte werden dann mit den ausgewählten Flurstücken und den zum Vertrag gehörigen Projekt verknüpft. Außerdem erlaubt das Widget über die Konfigurationsdatei zu Felder der Nutzungsrechte mit Standardwerten vorzubelegen. Das Widget ist frei konfigurierbar, benötigt aber die aus dem Produkt Skejlo bekannten Datensätze.

Changelog

Changelog hier.

Voraussetzungen

Das Widget basiert auf den Datensätzen "Vertrag", "Projekt" und "Nutzungsrecht". 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\smartdesign-apps\{@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 der Vertrag aktualisiert werden soll.
  • Mögliche Werte: true / false

parcel

"parcel": {
        "objectType": "WI_FLURSTUECKE",
        "keyword": "KEYWORD",
        "description": "WI_EIGENTUEMER",
        "linkToContract": "WI_VRT2FLR_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.
• linkToContract:
  • Beschreibung: Beliebige Verknüpfung vom Flurstück zum Vertrag.
  • Mögliche Werte: Sämtliche Verknüpfungen zwischen Flurstück und Vertrag.
• 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.

contract

"contract": {
        "linkToProject": "ITDVRTPRJ",
        "contractItemField": "WI_VERT_GEGENSTAND"
    },

Beschreibung

• linkToProject:
  • Beschreibung: Beliebige Verknüpfung vom Vertrag zum Projekt.
  • Mögliche Werte: Sämtliche Verknüpfungen zwischen Vertrag und Projekt.
• contractItemField:
  • Beschreibung: Feld für die Vertragsgegenstände.
  • Mögliche Werte: Sämtliche Typen-Felder die auf objectType existieren.

rightOfUse

"rightOfUse": {
        "objectType": "WI_NUTZUNGSRECHT",
        "linkToParcel": "WI_FLR2NRE_01",
        "linkToProject": "WI_PRJ2NRE_01",
        "typeField": "WI_NRE_TYP",
        "fields": [
            {
                "field": "KEYWORD",
                "defaultValue": "Ich bin ein Stichwort"
            },
            {
                "field": "WI_SICHERUNG",
                "defaultValue": "{{ TODAY }} - Nutzungsrecht wurde automatisch angelegt"
            }
        ]
    }

Beschreibung

• objectType:
  • Beschreibung: Datensatztyp für die Nutzungsrechte.
  • Mögliche Werte: Sämtliche Datensätze die einen Nutzungsrechte darstellen können.
• linkToParcel:
  • Beschreibung: Beliebige Verknüpfung vom Nutzungsrecht zum Flurstück.
  • Mögliche Werte: Sämtliche Verknüpfungen zwischen Nutzungsrecht und Flurstück.
• linkToProject:
  • Beschreibung: Beliebige Verknüpfung vom Nutzungsrecht zum Projekt.
  • Mögliche Werte: Sämtliche Verknüpfungen zwischen Nutzungsrecht und Projekt.
• linkToProject:
  • Beschreibung: Sämtliche Felder auf dem Nutzungsrecht, vorzugsweise den Typen des Nutzungsrechts.
  • Mögliche Werte: Sämtliche Typen-Felder die auf dem Nutzungsrecht existieren.
• fields:
  • Beschreibung: Beliebige Anzahl an Feldern die vorbelegt werden sollen.
  • Mögliche Werte: Sämtliche Felder auf dem Nutzungsrecht.
  • 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.

Parameter	Mögliche Werte	Beschreibung
Anzeigehöhe	50px	Höhe des Widgets
Anzeigebreite	200px	Höhe des Widgets
Konfigurationsdatei/ConfigFile	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