Zum Inhalt

ACPMultiLink

Beschreibung - Widget

Dieses Produkt dient dazu mehrere Datensätze in einer Aktion zu verknüpfen. Dabei lassen sich die Datensatztypen, Verknüpfungsarten, etc. konfigurieren.

image.png

Changelog

Changelog hier.

Voraussetzungen

Das Widget besitzt keine expliziten Voraussetzungen. Es sollte jedoch berücksichtigt werden, dass sämtliche Felder, Verknüpfungen usw., die in der Konfigurationsdatei angegeben werden, auch existieren müssen.

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\smartdesign-apps\{@DATENBANKNAME}\smartdesign.base\smartdesign\base\webcontent\{WIDGETNAME}\assets\configs

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

  3. Kopierte Datei bearbeiten.

objects

"objects": {
    "source": "PROJECT",
    "target": "TASK"
}
Beschreibung
  • source:
    • Beschreibung: Gibt den Datensatztypen an, über welchen nach dem gewünschten Datensatztyp gesucht werden soll. HINWEIS: „WHOLEDB“ kann verwendet werden.
    • Mögliche Werte: Beliebiger Datensatztyp
  • target:
    • Beschreibung: Gibt den Datensatztypen an, welcher verknüpft werden soll.
    • Mögliche Werte: Beliebiger Datensatztyp


relations

"relations": {
    "current2source": "ITDPRJADR",
    "source2target": "ITDTSKPRJ",
    "target2current": "TSKADR"
}
Beschreibung
  • current2source:
    • Beschreibung: Gibt das Verknüpfungsattribut an, welches zwischen dem aktuellen und dem „source“-Datensatztyp existieren muss, um ausgewertet zu werden.
    • Mögliche Werte: Beliebige Verknüpfungsart
  • source2target:
    • Beschreibung: Gibt das Verknüpfungsattribut an, welches zwischen dem „source“- und dem „target“-Datensatztyp existieren muss, um ausgewertet zu werden.
    • Mögliche Werte: Beliebige Verknüpfungsart
  • target2current:
    • Beschreibung: Gibt das Verknüpfungsattribut an, welches zwischen dem aktuellen und dem „target“-Datensatztyp existieren muss, um ausgewertet zu werden.
    • Mögliche Werte: Beliebige Verknüpfungsart


fields

"fields": {
    "caption": "KEYWORD",
    "subcaption": "GWSTYPE"
}
Beschreibung
  • caption:
    • Beschreibung: Gibt das Feld an, in welchem sich das anzuzeigende „Stichwort“ befindet.
    • Mögliche Werte: Beliebiges Feld des hinterlegten Datensatztypen in „target“.
  • subcaption:
    • Beschreibung: Gibt das Feld an, in welchem sich die anzuzeigende „Beschreibung“ befindet.
    • Mögliche Werte: Beliebiges Feld des hinterlegten Datensatztypen in „target“.


btnIcon

"btnIcon" : "search-infobox.svg"
Beschreibung
  • btnIcon:
    • Beschreibung: Gibt an welche Bilddatei auf der Schaltfläche angezeigt werden soll.
    • Mögliche Werte: Beliebige Bilddatei


useAlreadyLinked

"useAlreadyLinked" : true
Beschreibung
  • useAlreadyLinked:
    • Beschreibung: Gibt an, ob das extra Areal im Modal „Bereits verknüpft“ angezeigt werden soll.
    • Mögliche Werte: true / false

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
Konfigurationsdatei "example-config.json" Name und Dateiendung der zu verwendenden Konfigurationsdatei.
Zusätzlicher Filter für nicht verknüpfte Objekte "KEYWORD LIKE '%EDV%'" Gibt ein zusätzlichen SQL Filter an, welcher verwendet werden soll.
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: 

{
    "BTN_APPLY": "Übernehmen",
    "BTN_CANCEL": "Abbrechen",
    "BTN_OPEN": "Verknüpfen",
    "title": "Verknüpfen",
    "HEADER_AVAILABLE": "Nicht verknüpft",
    "HEADER_EXISTING": "Bereits verknüpft"
}

Beschreibung

BTN_APPLY Gibt die Zeichenfolge an, die auf der „Übernehmen“-Schaltfläche angezeigt wird.

BTN_CANCEL Gibt die Zeichenfolge an, die auf der „Schließen“-Schaltfläche angezeigt wird.

BTN_OPEN Gibt die Zeichenfolge an, die auf der „Öffnen“-Schaltfläche angezeigt wird.

title Gibt die Zeichenfolge an, die als Titel des Modales angezeigt wird.

HEADER_AVAILABLE Gibt die Zeichenfolge an, die als Titel über den „verfügbaren Objekten“ angezeigt wird.

HEADER_EXISTING Gibt die Zeichenfolge an, die als Titel über den „Bereits verknüpften Objekten“ angezeigt wird.