Widget

Allgemein

Updates erfolgen pro Datenbank

Lieferumfang des Installationspaketes

Ordner/Datei	Beschreibung
documentation	Dokumentation der Komponente
l10n	Übersetzungsdateien (DE/EN) für die Konfiguration
webcontent/smartdesign.base.%WidgetName%/assets/config	Widget-Konfigurationsdateien
webcontent/smartdesign.base.%WidgetName%/assets/images	Symboldateien
webcontent/smartdesign.base.%WidgetName%/assets/lang	Widget-Übersetzungsdateien
webcontent/smartdesign.base.%WidgetName%/assets/acp-config.json	ACP Konfigurationsdatei
widgets	Vorkonfiguration des Widgets

Datenbankanpassungen

Mögliche Änderungen an der Datenbank sind in der entsprechenden Komponenten-Dokumentation beschrieben. Diese könnten neue Datensatz-Typen mit entsprechenden Feldern oder zusätzliche Felder für vorhandene Datensatz-Typen umfassen.

ACHTUNG

Bitte beachten Sie beim Update darauf, ob es sich um ein Major oder Minor / Patch Update handelt.

Major 1.1.1
Minor / Patch 2.2.2

Wo wird das Widget verwendet?

Um herauszufinden, in welchen Apps ein Widget verwendet wird, kann eine Dateisuche durchgeführt werden, bei der der Inhalt der Dateien durchsucht wird.
Es bietet aber keine 100% Genauigkeit und dient als Unterstützung. Suchen Sie hierzu innerhalb des nachfolgenden Ordner nach dem Widget-Namen:

C:\Program Files (x86)\Common Files\CAS-Software\Server\JavaServices\smartdesign-apps\@%DATENBANKNAME%

Der Ordner "smartdesign.base" sollte dabei ausgeschlossen werden, da dort sich das Widget befindet. Sollte das Widget gefunden werden, werden Dateien mit der Endung .form angezeigt. Der Name des Hauptordners in dem sich die Datei befindet, sagt Ihnen in welcher App das Widget verwendet wurde.

Major Update

Widget-Konfiguration- und Sprachdateien sichern
- Temporären Ordner zur Zwischenablage erstellen.
- Im Datei-Explorer den folgenden Ordner öffnen:
```
C:\Program Files (x86)\Common Files\CAS-Software\Server\JavaServices\smartdesign-apps\@%DATENBANKNAME%\smartdesign.base\smartdesign\base\webcontent\smartdesign.base.%WidgetName%\assets\
```
- Ordner "config" und "lang" in das temporäre Verzeichnis kopieren.
Widget-Konfiguration im SmartDesign pro Verwendung sichern
- SmartDesign im Browser öffnen und mit einem administrativen Benutzer anmelden.
- App "Administration" öffnen.
- App Designer aktivieren.
- App öffnen, in der das Widget verwendet wird.
- Über "Anpassen" in die Editierfunktion wechseln.
- Widget selektieren.
- Screenshot der Konfiguration erstellen und speichern.
- Sofern vorhanden, Skripte kopieren und in eine temporäre Datei abspeichern.
Deinstallation des Widget im SmartDesign
- SmartDesign im Browser öffnen und mit einem administrativen Benutzer anmelden.
- App "Administration" öffnen.
- App Designer aktivieren.
- App öffnen, in der das Widget verwendet wird.
- Über "Anpassen" in die Editierfunktion wechseln.
- Widget selektieren.
- Widget löschen (Papierkorb).
- Änderungen mittels "Übernehmen" speichern.
- Änderungen "Veröffentlichen".
- Abmelden
  
  ACHTUNG
  
  Widget muss in allen Apps einzeln gelöscht werden!
Widget vom Dateisystem löschen
- Im Datei-Explorer den folgenden Ordner öffnen:
```
C:\Program Files (x86)\Common Files\CAS-Software\Server\JavaServices\smartdesign-apps\@%DATENBANKNAME%\smartdesign.base\smartdesign\base
```
- Ordner "l10n" öffnen und die nachfolgenden Dateien löschen:
  - %WidgetName%_de.properties
  - %WidgetName%_en.properties
- Zurück und Ordner "webcontent" öffnen und den gesamten Ordner "smartdesign.base.%WidgetName%" löschen
- Zurück und Ordner "widgets" öffnen und die Datei "%WidgetName%.widget" löschen
Widget installieren / updaten
- Navigieren Sie zu dem SmartDesign-Apps Ordner auf dem Zielsystem.
```
C:\Program Files (x86)\Common Files\CAS-Software\Server\JavaServices\smartdesign-apps
```
- Navigieren Sie in den entsprechenden Unterordner, welcher im Namen Ihre aktuell in genesisWorld verwendete Datenbank hat.
  Datenbankname
  Falls Sie nicht wissen, welche Datenbank derzeit in Ihrem genesisWorld verwendet wird, können Sie dies im genesisWorld Datenbankassistenten prüfen.
  Es ist wichtig zu beachten, dass wenn kein Ordner mit dem Namen existiert, können Sie diesen auch selbst erstellen. Bitte beachten Sie dabei dieses Benennungsschema:
  „@{DATENBANKNAME}“
- Navigieren Sie in die Unterordner „smartdesign.base“ -> „smartdesign“ -> „base“.
- Kopieren und überschreiben Sie die Ordner „l10n“, „webcontent“ und „widgets“ aus dem Installationspaket.
- Installation ist abgeschlossen.
Widget im SmartDesign einbinden
- SmartDesign im Browser öffnen und mit einem administrativen Benutzer anmelden.
- App "Administration" öffnen.
- App Designer aktivieren.
- App öffnen, in der das Widget wieder eingebunden werden soll.
- Über "Anpassen" in die Editierfunktion wechseln.
- Fügen Sie das Widget wieder ein.
- Konfiguration wiederherstellen.
- Änderungen mittels "Übernehmen" speichern.
- Änderungen "Veröffentlichen".
Widget Konfiguration wiederherstellen
- Im Datei-Explorer den folgenden Ordner öffnen:
```
C:\Program Files (x86)\Common Files\CAS-Software\Server\JavaServices\smartdesign-apps\@%DATENBANKNAME%\smartdesign.base\smartdesign\base\webcontent\smartdesign.base.%WidgetName%\assets\
```
- ChangeLog des Widgets prüfen, ob es Konfigurationsänderungen gibt.
  - Keine Änderungen: Ordner "config" und "lang" aus dem temp. Verzeichnis kopieren und ersetzen.
  - Änderungen vorhanden: Konfiguration aus den Ordnern "config" und "lang" übertragen.

Minor / Patch Update

Widget-Konfiguration- und Sprachdateien sichern
- Temporären Ordner zur Zwischenablage erstellen.
- Im Datei-Explorer den folgenden Ordner öffnen:
```
C:\Program Files (x86)\Common Files\CAS-Software\Server\JavaServices\smartdesign-apps\@%DATENBANKNAME%\smartdesign.base\smartdesign\base\webcontent\smartdesign.base.%WidgetName%\assets\
```
- Ordner "config" und "lang" in das temporäre Verzeichnis kopieren.
Widget installieren / updaten
- Navigieren Sie zu dem SmartDesign-Apps Ordner auf dem Zielsystem.
```
C:\Program Files (x86)\Common Files\CAS-Software\Server\JavaServices\smartdesign-apps
```
- Navigieren Sie in den entsprechenden Unterordner, welcher im Namen Ihre aktuell in genesisWorld verwendete Datenbank hat.
  Datenbankname
  Falls Sie nicht wissen, welche Datenbank derzeit in Ihrem genesisWorld verwendet wird, können Sie dies im genesisWorld Datenbankassistenten prüfen.
  Es ist wichtig zu beachten, dass wenn kein Ordner mit dem Namen existiert, können Sie diesen auch selbst erstellen. Bitte beachten Sie dabei dieses Benennungsschema:
  „@{DATENBANKNAME}“
- Navigieren Sie in die Unterordner „smartdesign.base“ -> „smartdesign“ -> „base“.
- Kopieren und überschreiben Sie die Ordner „l10n“, „webcontent“ und „widgets“ aus dem Installationspaket.
- Installation ist abgeschlossen.

Widget Konfiguration wiederherstellen

Im Datei-Explorer den folgenden Ordner öffnen:

C:\Program Files (x86)\Common Files\CAS-Software\Server\JavaServices\smartdesign-apps\@%DATENBANKNAME%\smartdesign.base\smartdesign\base\webcontent\smartdesign.base.%WidgetName%\assets\

Ordner "config" und "lang" aus dem temporäre Verzeichnis kopieren und ersetzen.