Zum Inhalt

ACPPDFPreview

Beschreibung - Widget

Dieses Widget bietet die Möglichkeit, PDF-Dateien, die in genesisWorld an den aktuellen Datensatz angehängt sind, in einer Fotogalerie darzustellen. Diese können angeklickt werden, um sie in einem Modal anzuzeigen. In diesem Modal lässt sich über die Pfeiltasten zwischen den PDFs hin- und her navigieren. Außerdem ist der Titel des Modals anklickbar, um zum Datensatz des PDFs zu springen.

image.png

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.

Grundeinstellung 

"keywordField": "KEYWORD",
"linkAttribute": [],
"additionalSqlFilter": "",
"initialLoadAmount": 999,
"refreshBtn": {
    "btnIcon": "assets/images/refresh.svg",
    "btnUsed": true
  }

Beschreibung
  • keywordField:
    • Beschreibung: Gibt an, aus welchem Feld das "Stichwort" stammen soll.
    • Mögliche Werte: Beliebiges Feld des Datensatz-Typs "Dokument".
  • linkAttribute:
    • Beschreibung: Gibt eine Auflistung von Verknüpfungsarten an, welche vom Widget ausgewertet werden sollen.
    • Mögliche Werte: Beliebige Verknüpfungsarten
  • additionalSqlFilter:
    • Beschreibung: Gibt ein Sql-Statement an, welches durch das Widget an die „where“-Bedingung gehangen wird.
    • Mögliche Werte: Beliebiger SQL-Query
  • initialLoadAmount:
    • Beschreibung: Gibt an, wie viele Dokumente initial geladen werden.
    • Mögliche Werte: Beliebiger integer Wert
  • refreshBtn:
    • btnIcon:
      • Beschreibung: Gibt an, welche Bilddatei auf der „Neuladen“-Schaltfläche angezeigt werden soll.
      • Mögliche Werte: Beliebige Bilddatei
    • btnUsed:
      • Beschreibung: Gibt an, ob die „Neuladen“-Schaltfläche genutzt wird.
      • Mögliche Werte: true / false


gallerySettings 

"gallerySettings": {
    "galleryHeight": "500px",
    "galleryWidth": "500px",
    "galleryItemHeight": "120px",
    "galleryItemWidth": "100px"
  }

Beschreibung
  • galleryHeight:
    • Beschreibung: Gibt an, wie hoch die gesamte Galerie sein soll.
    • Mögliche Werte: 400px; 100%; 1.5em; etc.
  • galleryWidth:
    • Beschreibung: Gibt an, wie breit die gesamte Galerie sein soll.
    • Mögliche Werte: 400px; 100%; 1.5em; etc.
  • galleryItemHeight:
    • Beschreibung: Gibt an, wie hoch ein Bild in der Galerie sein soll.
    • Mögliche Werte: 400px; 100%; 1.5em; etc.
  • galleryItemWidth:
    • Beschreibung: Gibt an, wie breit ein Bild in der Galerie sein soll.
    • Mögliche Werte: 400px; 100%; 1.5em; etc.

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 400px Höhe des Widgets
Anzeigebreite 400px Breite 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

Beispieldatei "de.json": 

{
    "NO_PICTURES": "Es konnten keine Dokumente zum Anzeigen gefunden werden!",
    "BTN_CANCEL": "Abbrechen",
    "BTN_REFRESH": "Neuladen",
    "WIDGET_CAPTION": "ACPPDFPreview",
    "NO_RESULT" : "Keine Ergebnisse"
}

Beschreibung

NO_PICTURES Gibt die Zeichenfolge an, die angezeigt wird, wenn keine Dokumente gefunden wurden.

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

BTN_REFRESH Gibt die Zeichenfolge an, die auf der „Neuladen“-Schaltfläche angezeigt wird.

WIDGET_CAPTION Gibt die Zeichenfolge an, die als Titel über dem Widget angezeigt wird.

NO_RESULT