Verwenden von Diagrammen mit interaktiver Kommunikation

Mithilfe von Diagrammen in einer interaktiven Kommunikation können Sie große Informationsmengen zu einem einfach zu analysierenden und zu verstehenden visuellen Format zusammenfassen

Ein Diagramm ist eine visuelle Darstellung von Daten. Es verdichtet große Mengen an Informationen in ein leicht verständliches visuelles Format, sodass die Empfänger der interaktiven Kommunikation komplexe Daten besser visualisieren, interpretieren und analysieren können.

Beim Erstellen einer interaktiven Kommunikation können Sie Diagramme hinzufügen, um zweidimensionale Daten vom Formulardatenmodell der Vorlage für die interaktive Kommunikation visuell darzustellen. Mit der Diagrammkomponente können Sie folgende Arten von Diagrammen hinzufügen und konfigurieren:

• Kreisdiagramm
• Spalte
• Donut
• Balken (Nur Webkanal)
• Linie
• Linie und Punkt
• Punkt
• Bereich

Hinzufügen und Konfigurieren von Diagrammen in interaktiver Kommunikation

Führen Sie die folgenden Schritte aus, um ein Diagramm zu einer interaktiven Kommunikation hinzuzufügen:

1. Ziehen Sie die Diagrammkomponente von den Komponenten in der AEM-Seitenleiste in einen der folgenden Druck- oder Webkanäle einer interaktiven Kommunikation:

   • Druckkanal: Zielbereich und Bildfeld
   • Webkanal: Teilfenster und Zielbereich

   Die abgelegte Diagrammkomponente erstellt einen Platzhalter für ein Diagramm.

2. Tippen Sie auf die Diagrammkomponente im Editor für interaktive Kommunikation und wählen Sie in der Komponenten-Symbolleiste Konfigurieren ( ).

   Die Eigenschaften-Seitenleiste wird mit den Grundeigenschaften des Diagramms im Fokus angezeigt.

   
   Abbildung: Grundlegende Eigenschaften eines Liniendiagramms im Druckkanal

   
   Abbildung: Grundlegende Eigenschaften eines Liniendiagramms im Webkanal

3. Konfigurieren Sie die grundlegenden Eigenschaften des Diagramms für Druckkanal und Webkanal. Neben den allgemeinen Eigenschaften gibt es Eigenschaften, die für den Druck- und Webkanal und den Diagrammtyp spezifisch sind.

   • Name: Name des Diagrammobjekts. Der Name des Diagramms, das Sie hier angeben, wird nicht in der Diagrammausgabe angezeigt, wird jedoch in Regeln verwendet, um auf das Diagramm zu verweisen.

   • Diagrammtyp: Geben Sie den Diagrammtyp an: Kreis-, Spalten-, Ring, Linien-, Linien- und Punkt-, Punkt- oder Flächendiagramm.

   • Objekt ausblenden: Wählen Sie diese Option, um das Diagramm in der endgültigen Ausgabe auszublenden.

   • Geben Sie Folgendes für die X-Achse und Y-Achse an:

     • Titel: Geben Sie die Titel für die X- und Y-Achse an, die in der interaktiven Kommunikation angezeigt werden sollen.
     • Datenmodellobjekt*: Klicken Sie auf „Durchsuchen“ und wählen Sie die Datenmodellobjekte für die X- und Y-Achse des Diagramms aus dem Formulardatenmodell, das beim Erstellen der interaktiven Kommunikation angegeben wurden. Wählen Sie zwei Sammlungs-/Array-Typ-Eigenschaften desselben übergeordneten Datenmodellobjekts, die in Bezug zueinander bedeutungsvoll sind, um sie auf der X- und Y-Achse eines Diagramms darzustellen.
     • Funktion: Um die Werte auf der Achse mithilfe statistischer Funktionen zu berechnen, wählen Sie Funktion für die X/Y-Achse. Weitere Informationen zu Funktionen finden Sie unter Funktionen in Diagramm und Beispiel 2: Anwendung der Summen- und Mittelfunktionen in einem Liniendiagramm.
   HINWEIS

   Für den Druckkanal auf der X-Achse muss das Datenmodellobjekt, das Sie binden, den Typ Zahl, Zeichenfolge oder Datum haben. Auf der Y-Achse sollte das Datenmodellobjekt, das Sie binden, vom Typ „Zahl“ sein. Es wird empfohlen, dass Sie die rechte Legende im Druckkanal verwenden.

   Weitere Informationen zu Diagrammeigenschaften finden Sie unter Grundlegende Eigenschaften in Diagrammen.

4. (Nur Druckkanal) Legen Sie in den Agenteneinstellungen fest, ob der Agent dieses Diagramm verwenden muss. Wenn die Option t ist erforderlich, damit der Agent dieses Diagramm verwenden kann nicht ausgewählt ist, kann der Agent auf das Augensymbol für das Diagramm auf der Registerkarte "Inhalt"der Benutzeroberfläche für Agenten tippen, um das Diagramm ein-/auszublenden.

   

5. Tippen Sie in der Seitenleiste "Eigenschaften"auf .

   Erstellen Sie eine Vorschau, um das Erscheinungsbild und die Daten des Diagramms anzuzeigen. Kehren Sie zurück, um die Eigenschaften des Diagramms bei Bedarf neu zu konfigurieren.

6. Kehren Sie zu anderen Änderungen in der interaktiven Kommunikation zurück.

Beispiel 1: Diagrammausgabe in Druck und Web

Auf der Registerkarte „Grundeinstellungen“ definieren Sie die Art des Diagramms, die Quellformulardatenmodelleigenschaften, die Daten enthalten, die Beschriftungen, die auf der X-Achse und Y-Achse des Diagramms dargestellt werden können, und optional auch die statistische Funktion, um die Werte für die grafische Darstellung auf dem Diagramm zu berechnen.

Im Folgenden werden die Mindestanforderungen für grundlegenden Eigenschaften mit Hilfe einer Kreditkartenabrechnung, die mit einer interaktiven Kommunikation erstellt wurde, detailliert erläutert. Wenn Sie ein Diagramm generieren möchten, um die Höhe der verschiedenen Ausgaben in der Abrechnung darzustellen. Sie können verschiedene Diagrammarten für Druck- und Webausgabe der interaktiven Kommunikation verwenden.

Um dies zu erreichen, müssen Sie Folgendes angeben:

• Diagrammtyp - in diesem Beispiel Spalte für den Druckkanal und Kreis für den Webkanal

• Datenmodellobjekte als Quelle für die X- und Y-Achse des Diagramms - in diesem Beispiel Transaktionsbetrag für X-Achse und Ausgabenname für die Y-Achse

• Titel für die X- und Y-Achse (nur für das Spaltendiagramm im Druckkanal in diesem Beispiel) - in diesem Beispiel Betrag ($) für die X-Achse und Ausgabe für die Y-Achse.

• Beschriftungsrichtung (nur in diesem Beispiel für eine Spaltentypgrafik im Druckkanal) - in diesem Beispiel Tilt Left

• ​​Tooltipto, das beim Bewegen der Maus über eine Ausgabe angezeigt wird (nur Webkanal) - in diesem Beispiel ${x}: $ ${y}wird dies als [Expense Label: $ Amount] (Beispiel: Besuch des Themenparks: $ 315)

KommunikationAbbildung: Spaltendiagramm in der Druckausgabe einer interaktiven Kommunikation

A. Y-Achse - Aus der Eigenschaft des Formulardatenmodells abgerufener Betrag und die Eigenschaft Titel auf Betrag ($) B. Beschriftungsrichtung der X-Achse auf Tilt Left C. X Achse - Ausgabenbeschreibung abgerufen aus der Eigenschaft des Formulardatenmodells und der Eigenschaft Titel auf Spesen

KommunikationAbbildung: Ringdiagramm in der Web-Ausgabe einer interaktiven Kommunikation

A. Die Eigenschaft "Innerer Radius"des Donuts ist auf B eingestellt. Die Eigenschaft "Legende anzeigen"ist ausgewählt und die Eigenschaft "Legendenposition"auf "Rechts"festgelegt C. QuickInfo zeigt die Details des Elements beim Bewegen der Maus an - Tooltip ist auf ${x} eingestellt: $ $

Beispiel 2: Anwendung von Summen- und Häufigkeitsfunktionen in einem Liniendiagramm

Durch Anwenden von Funktionen in einem Diagramm können Sie Daten darstellen, die nicht direkt vom Formulardatenmodell bereitgestellt werden. In diesem Beispiel verwenden wir ein Beispiel für einen Kreditkartenauszug, um zu verstehen, wie Summen- und Häufigkeitsfunktionen auf das Diagramm angewendet werden können.

TransaktionenAbbildung: Liniendiagramm ohne Funktion mit drei "Bed and Breakfast"-Transaktionen

Summenfunktion

Sie können die Summenfunktion anwenden, um Werte mehrerer Instanzen derselben Dateneigenschaft zusammenzufassen, und sie nur einmal anzeigen. Im folgenden Diagramm wird die Summenfunktion beispielsweise auf die Y-Achse angewendet, um die Summe der drei „Bed and Breakfast“-Transaktionen ($ 99,45, $ 78 und $ 12) zu addieren und nur eine Transaktion ($ 189,45) anzuzeigen.

Die Summenfunktion kann Diagramme nützlicher machen, wenn Sie die Summe für viele Instanzen derselben Dateneigenschaft sortieren und anzeigen möchten.

Häufigkeitsfunktion

Gibt die Anzahl der Werte auf der X- oder Y-Achse für einen bestimmten Wert auf der anderen Achse an. Bei Anwendung der Häufigkeitsfunktion auf der Y-Achse (Amount/TransAmount) zeigt das Diagramm an, dass drei „Bed & Breakfast“-Transaktionen und ein Rest der Transaktionsarten dreimal aufgetreten sind.

Grundlegende Eigenschaften in Diagrammen

Auf der Registerkarte „Standard“ können Sie die folgenden Eigenschaften konfigurieren:

​​NameEine Kennung für das Diagrammelement. Der Name ist im Diagramm nicht sichtbar, jedoch nützlich, wenn von anderen Komponenten, Skripts und SOM-Ausdrücken auf das Element verwiesen wird.

Titel (nur Druckkanal) Gibt den Titel des Diagramms an.

Diagrammtyp Gibt den Typ des Diagramms an, das Sie generieren möchten. Die verfügbaren Optionen sind Torten-, Spalten-, Ring-, Linien-, Linien- und Punktdiagramme, Punkt- und Bereichsdiagramme und Balkendiagramme (Webkanal). Weitere Informationen finden Sie unter Beispiel 1: Diagrammausgabe in Druck und Web.

X-Achse > TitelGibt den Titel für die X-Achse an.

X-Achse > Datenmodellobjekt * Geben Sie den Namen des Formulardatenmodellsammlungselements an, das auf der X-Achse dargestellt werden soll.

X-Achse > FunktionGibt die statistische/benutzerdefinierte Funktion an, die für die Berechnung der Werte auf der X-Achse verwendet werden soll. Weitere Informationen zu Funktionen finden Sie unter Verwenden von Funktionen in Grafik und Beispiel 2: Anwendung der Summen- und Mittelfunktionen in einem Liniendiagramm.

X-Achse > Beschriftungsrichtung Richtung des Titels auf dem Diagramm im Druckkanal. Wenn Sie die Richtung der Beschriftung als "Benutzerdefinierte Drehung"wählen, wird das Feld "Benutzerdefinierter Drehwinkel (Grad)"angezeigt. Im Feld „Benutzerdefinierter Drehwinkel (Grad)“ können Sie den Drehwinkel in Schritten von 15 Grad wählen.

Y-Achse > TitelGibt den Titel für die Y-Achse an.

Y-Achse > Datenmodellobjekt * Gibt das Formulardatenmodellsammlungselement an, das auf der y-Achse dargestellt werden soll. Im Druckkanal sollte das Datenmodellobjekt für die Y-Achse vom Typ Zahl sein.

Y-Achse > FunktionGibt die statistische/benutzerdefinierte Funktion an, die für die Berechnung der Werte auf der Y-Achse verwendet werden soll. Weitere Informationen zu Funktionen finden Sie unter Verwenden von Funktionen in Grafik und Beispiel 2: Anwendung der Summen- und Mittelfunktionen in einem Liniendiagramm.

Legende anzeigenZeigt eine Legende für das Torten- oder Ringdiagramm an, wenn diese aktiviert ist.

Legende positionGibt die Position der Legende in Bezug auf das Diagramm an. Die verfügbaren Optionen sind rechts, links, oben und unten.

Höhe (nur Druckkanal) Höhe des Diagramms in Pixel.

Breite (nur Druckkanal) Breite des Diagramms in Pixel.

QuickInfo (nur Webkanal) Gibt das Format an, in dem die QuickInfo beim Bewegen des Mauszeigers über einen Datenpunkt in der Grafik im Webkanal angezeigt wird. Der Standardwert ist ${x}(${y}). Je nach Diagrammtyp werden die Variablen ${x} und ${y} dynamisch durch die entsprechenden Werte auf der X-Achse und Y-Achse ersetzt und in der QuickInfo angezeigt, wenn Sie den Mauszeiger auf einen Punkt, ein Balken oder einen Ausschnitt im Diagramm bewegen.

Wenn Sie QuickInfos deaktivieren möchten, lassen Sie das Feld „Quickinfo“ leer. Diese Option ist nicht auf Linien- und Bereichsdiagramme anwendbar. Siehe beispielsweise Beispiel 1: Diagrammausgabe in Druck und Web.

CSS-Klasse (nur Webkanal) Geben Sie den Namen einer CSS-Klasse im CSS-Klassenfeld an, um benutzerdefinierte Stile auf das Diagramm anzuwenden.

Obligatorischer Seitenumbruch vor (nur Druckkanal) Wählen Sie diese Option aus, um einen obligatorischen Seitenumbruch vor dem Diagramm hinzuzufügen und das Diagramm auf eine neue Seite zu setzen.

Obligatorischer Seitenumbruch nach (nur Druckkanal) Wählen Sie diese Option aus, um einen obligatorischen Seitenumbruch nach dem Diagramm hinzuzufügen und den Inhalt nach dem Diagramm auf eine neue Seite zu setzen.

Einzug (nur Druckkanal) Geben Sie den Einzug des Diagramms links auf der Seite an.

Diagrammspezifische KonfigurationenZusätzlich zu allgemeinen Konfigurationen ist die folgende Diagrammkonfiguration verfügbar:

• Innerer Radius: Für Ringdiagramme verfügbar, um den Radius (in Pixeln) für den inneren Kreis des Diagramms anzugeben.

• Linienfarbe: Verfügbar für Linien-, Linien- und Punkt- sowie Bereichsdiagramme, um den hexadezimalen Farbwert für die Linie im Diagramm anzugeben.

• Punktfarbe: für Punkt- und Linien- und Punktdiagramme verfügbar sind, um den hexadezimalen Farbwert für die Punkte im Diagramm anzugeben.

• Bereichsfarbe: für Bereichsdiagramme verfügbar sind, um den hexadezimalen Farbwert für den Bereich unter der Linie im Diagramm anzugeben.

Funktionen im Diagramm verwenden

Sie können das Diagramm so konfigurieren, dass Sie mit statistischen Funktionen Werte aus Quelldaten zur grafischen Darstellung im Diagramm berechnen können. Durch Anwenden von Funktionen in einem Diagramm können Sie Daten darstellen, die nicht direkt vom Formulardatenmodell bereitgestellt werden.

Die Diagrammkomponente verfügt bereits über einige integrierte Funktionen, allerdings können Sie auch eigene Funktionen erstellen und für die Verwendung in der Diagrammkonfiguration freigeben.

Standardfunktionen

Die folgenden Funktionen sind standardmäßig in der Diagrammkomponente verfügbar:

Mittelwert (Durchschnitt) Gibt den Durchschnittswert der Werte auf der X- oder Y-Achse für einen bestimmten Wert auf der anderen Achse an.

​​SumGibt die Summe aller Werte auf der X- oder Y-Achse für einen bestimmten Wert auf der anderen Achse an.

​​MaximumGibt das Maximum der Werte auf der X- oder Y-Achse für einen bestimmten Wert auf der anderen Achse an.

​​FrequencyGibt die Anzahl der Werte auf der X- oder Y-Achse für einen bestimmten Wert auf der anderen Achse an.

​​RangeGibt die Differenz zwischen dem Maximum und Minimum der Werte auf der X- oder Y-Achse für einen bestimmten Wert auf der anderen Achse an.

​​MedianGibt den Wert zurück, der auf der X- oder Y-Achse für einen bestimmten Wert auf der anderen Achse die höheren und niedrigeren Werte in der Hälfte trennt.

​​MinimumGibt das Minimum der Werte auf der X- oder Y-Achse für einen bestimmten Wert auf der anderen Achse an.

​​ModeGibt den Wert mit den meisten Vorkommen auf der X- oder Y-Achse für einen bestimmten Wert auf der anderen Achse zurück

Benutzerdefinierte Funktionen im Webkanal

Neben der Verwendung der Standardfunktionen in Diagrammen können Sie benutzerdefinierte Funktionen in JavaScript™ schreiben und in der Liste der Funktionen in der Diagrammkomponente freigeben.

Eine Funktion akzeptiert ein Array oder Werte und einen Kategorienamen als Eingabe und gibt einen Wert zurück. Beispiel:

Multiply(valueArray, category) {
 var val = 1;
 _.each(valueArray, function(value) {
 val = val * value;
 });
 return val;
}

Wenn Sie eine benutzerdefinierte Funktion geschrieben haben, können Sie die folgenden Schritte ausführen, um sie für die Verwendung in der Diagrammkonfiguration freizugeben:

1. Fügen Sie die benutzerdefinierte Funktion in der Client-Bibliothek hinzu, die mit der entsprechenden interaktiven Kommunikation verknüpft ist. Weitere Informationen finden Sie unter Konfigurieren der Sendeaktion und Verwenden Client-seitiger Bibliotheken.

2. Um die benutzerdefinierte Funktion in der Dropdown-Liste "Funktion"anzuzeigen, erstellen Sie in CRXDe Lite einen Knoten nt:unstructured im Ordner "apps"mit den folgenden Eigenschaften:

   • Fügen Sie die Eigenschaft guideComponentType mit dem Wert fd/af/reducer hinzu. (mandatory)
   • Fügen Sie die Eigenschaft value zu einem vollständig qualifizierten Namen der benutzerdefinierten JavaScript™-Funktion hinzu. (obligatorisch) und setzen Sie den Wert auf den Namen der benutzerdefinierten Funktion, z. B. Multiplizieren, fest.
   • Fügen Sie die Eigenschaft jcr:description mit dem Wert hinzu, der als Name der benutzerdefinierten Funktion angezeigt werden soll, der in der Dropdown-Liste Funktion angezeigt wird. Beispiel:Multiplizieren.
   • Fügen Sie die Eigenschaft qtip mit dem Wert hinzu, der eine kurze Beschreibung der benutzerdefinierten Funktion darstellt. Es wird als QuickInfo angezeigt, wenn der Mauszeiger über den Funktionsnamen in der Dropdown-Liste Funktion bewegt wird.

3. Klicken Sie auf Alle speichern, um die Konfiguration zu speichern.

Die Funktion steht nun zur Verwendung im Diagramm zur Verfügung.