ACPMailChat

Beschreibung - Widget

Dieses Widget ermöglicht es, E-Mails, die mit dem Ausgangsdatensatz verknüpft sind, in beliebiger chronologischer Reihenfolge anzuzeigen. Zudem lassen sich die angezeigten E-Mails mithilfe einer sogenannten „SQLQuery“ einschränken. Des Weiteren gibt es eine Einzelansicht, um die E-Mails darzustellen.

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.

Grundeinstellung

"shownAmount": 10,
"linkAttributes": [],
"startInSingleView": false

Beschreibung

• shownAmount:
  • Beschreibung: Gibt an, wie viele E-Mails angezeigt werden sollen.
  • Mögliche Werte: Beliebiger integer Wert
• linkAttributes:
  • Beschreibung: Gibt eine Auflistung von Verknüpfungsarten an, welche vom Widget ausgewertet werden sollen.
  • Mögliche Werte: Beliebige Verknüpfungsarten
• startInSingleView:
  • Beschreibung: Gibt an, ob das Widget in der „Einzelansicht“ starten soll.
  • Mögliche Werte: true / false

headlineDateTimeFormat (optional)

"headlineDateTimeFormat": {
        "locale": "de-DE",
        "options": {
            "day": "2-digit",
            "month": "2-digit",
            "year": "numeric",
            "hour": "2-digit",
            "minute": "2-digit"
        }
    }

Beschreibung

• locale:
  • Beschreibung: Gibt an, nach welchem Sprachformat das Datum formatiert werden soll.
  • Mögliche Werte: de-DE, en-EN, etc.

    ℹ HINWEIS

    Hier muss ein Windows LCID eingetragen werden.
    Weitere Informationen finden Sie hier: Lokalisierung

• options:
  • day / month / year / hour / minute
    • Beschreibung: Ermöglicht die sprachabhängige Formatierung von Datum und Uhrzeit.
    • Mögliche Werte: 2-digit; numeric; long; etc.

      INFO

      Weitere Informationen finden Sie hier: DateTimeFormat

headlineDateTimeFormat (optional)

"queries": {
        "headline": "'Archiviert am ' + CAST(DO.INSERTTIMESTAMP AS string) + ' von ' + CAST(DO.INSERTUSER AS string)",
        "filter": "",
        "order": "ORDER BY DO.INSERTTIMESTAMP DESC"
    }

Beschreibung

• queries:
  • headline:
    • Beschreibung: Gibt eine CASOpenSQL-Query an, aus der die Kopfzeile befüllt wird.
    • Mögliche Werte: siehe Query-Übersicht Bsp.: "'Erzeugt am ' + CAST(DO.INSERTTIMESTAMP AS string) + ' von ' + CAST(DO.INSERTUSER AS string)"
  • filter:
    • Beschreibung: Gibt eine CASOpenSQL-Query an, um die angezeigten E-Mails zu filtern.
    • Mögliche Werte: siehe Query-Übersicht Bsp.: "DO.INSERTTIMESTAMP > '01.03.2023' AND DO.INSERTUSER LIKE 'Peter%'"
  • order:
    • Beschreibung: Gibt eine CASOpenSQL-Query an, welche die Sortierung der E-Mails definiert.
    • Mögliche Werte: siehe Query-Übersicht Bsp.: "ORDER BY DO.INSERTTIMESTAMP DESC"

Query-Übersicht

Eigenheit	Anwendung
Datum als Zeichenfolge	"CAST( AS string)"
Daten vom E-Mail-Objekt	"DO."
Daten vom jetzigen Objekt	"SO."
Verbindung von Zeichenfolgen	"'Zeichenfolge 1' + 'Zeichenfolge2'"
Sortierung	"ORDER BY <ASC

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
Konfigurationsdatei	example-config.json	Name und Dateiendung der zu verwendenden Konfigurationsdatei.
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 "de.json":

{
    "CHRONOLOGICAL_VIEW": "Chronologische Ansicht",
    "SINGLE_VIEW": "Einzelansicht",
    "X_FROM_Z": "E-Mail {0} von {1}",
    "NO_EMAILS": "Keine Emails gefunden."
}

Beschreibung

CHRONOLOGICAL_VIEW Gibt die Übersetzung an, welche links vom Regler angezeigt wird.

SINGLE_VIEW Gibt die Übersetzung an, welche rechts vom Regler angezeigt wird.

X_FROM_Z Gibt die Übersetzung an, die angibt auf welcher E-Mail man sich von „Z“-E-Mails befindet. In der Zeichenfolge können die Platzhalter „{0}“ und „{1}“ verwendet werden. Der erste wird dabei mit der aktuellen Nummer der E-Mail ersetzt und der zweite mit der Gesamtzahl an E-Mails.

NO_EMAILS Gibt die Übersetzung an, welche angezeigt wird, wenn keine E-Mails geladen wurden.