Grundlagen zu Bewertungen und Abzeichen scoring-and-badges-essentials

Die AEM Communities-Funktion mit Scoring- und Abzeichen identifiziert und belohnt Community-Mitglieder.

Einzelheiten zur Einrichtung der Funktion finden Sie unter

Diese Seite enthält zusätzliche technische Details :

Anzeigen von Abzeichen displaying-badges

Ob ein Badge als Text oder Bild angezeigt wird, wird Client-seitig in der HBS-Vorlage gesteuert.

Suchen Sie beispielsweise nach this.isAssigned in /libs/social/forum/components/hbs/topic/list-item.hbs:

{{#each author.badges}}

  {{#if this.isAssigned}}

    <div class="scf-badge-text">

      {{this.title}}

    </div>

  {{/if}}

{{/each}}

{{#each author.badges}}

  {{#unless this.isAssigned}}

    <img class="scf-badge-image" alt="{{this.title}}" title="{{this.title}}" src="{{this.imageUrl}}" />

  {{/unless}}

{{/each}}

Wenn „true“, zeigt isAssigned an, dass das Abzeichen für eine Rolle zugewiesen wurde und als Text angezeigt werden soll.

Wenn „false“, zeigt isAssigned an, dass das Abzeichen für einen erreichten Wert vergeben wurde und als Bild angezeigt werden sollte.

Alle Änderungen an diesem Verhalten sollten in einem benutzerdefinierten Skript vorgenommen werden (entweder überschreiben oder überlagern). Siehe Client-seitige Anpassung.

Debug-Protokoll für Bewertung und Badging debug-log-for-scoring-and-badging

Um die Fehlerbehebung bei der Bewertung und dem Badging zu erleichtern, kann eine benutzerdefinierte Protokolldatei eingerichtet werden. Der Inhalt dieser Protokolldatei kann dann dem Support bereitgestellt werden, wenn bei der Funktion Probleme auftreten.

Detaillierte Anweisungen finden Sie unter Erstellen einer benutzerdefinierten Protokolldatei.

So richten Sie schnell eine Slinglog-Datei ein:

So zeigen Sie Protokolleinträge an:

UGC für Bewertung und Badging ugc-for-scoring-and-badging

Der UGC für die Bewertung und das Badging kann angezeigt werden, wenn das ausgewählte SRP entweder JSRP oder MSRP, aber nicht ASRP ist. (Wenn Sie mit diesen Begriffen nicht vertraut sind, finden Sie weitere Informationen unter Community- und Speicherressourcenanbieter - Übersicht.)

Die Beschreibungen für den Zugriff auf Scoring- und Badging-Daten verwenden JSRP, da der UGC über CRXDE Lite leicht zugänglich ist.

JSRP auf Author: Experimentieren in der Authoring-Umgebung führt zu UGC, der nur in der Authoring-Umgebung sichtbar ist.

JSRP bei der Veröffentlichung: Entsprechend ist es beim Testen in der Veröffentlichungsumgebung erforderlich, auf CRXDE Lite mit Administratorrechten in einer Veröffentlichungsinstanz zuzugreifen. Wenn die Veröffentlichungsinstanz im Produktionsmodus) ausgeführt wirdAusführungsmodus „nosamplecontent„), müssen Sie CRXDE Lite aktivieren.

Der Basisspeicherort von UGC auf JSRP ist /content/usergenerated/asi/jcr/.

Scoring- und Badging-APIs scoring-and-badging-apis

Die folgenden APIs sind zur Verwendung verfügbar:

Die neuesten Javadocs für das installierte Feature Pack stehen Entwicklern im Adobe-Repository zur Verfügung. Siehe Verwenden von Maven für Communities : Javadocs.

Speicherort und Format des benutzergenerierten Inhalts im Repository können sich ohne Warnung ändern.

Beispiel-Setup example-setup

Die Screenshots von Repository-Daten stammen vom Einrichten einer Bewertung für ein Forum auf zwei verschiedenen AEM-Sites :

Zugriff auf Bewertungsbenutzeroberfläche access-scoring-ugc

Die Verwendung der APIs wird bevorzugt.

Zu Ermittlungszwecken wird im Beispiel mit JSRP der Basisordner mit Scores verwendet

Der untergeordnete Knoten von scoring ist der Name der Bewertungsregel. Daher empfiehlt es sich, die Namen von Bewertungsregeln auf einem Server global eindeutig zu definieren.

Für die Geometrixx Engage-Site befinden sich die Benutzerin bzw. der Benutzer und deren Wert in einem Pfad, der mit dem Namen der Bewertungsregel, der Site-ID der Community-Site (engage-ba81p), einer eindeutigen ID und der Benutzer-ID erstellt wurde:

Auf der Website für das Handbuch der Community-Komponenten befinden sich der Benutzer und sein Score in einem Pfad, der aus dem Namen der Bewertungsregel, einer Standard-ID (default-site), einer eindeutigen ID und der Benutzer-ID besteht:

Der Wert wird in der Eigenschaft scoreValue_tl gespeichert, die nur einen Wert enthalten oder indirekt auf einen atomischen Zähler verweisen kann.

Zugriff auf Badging-UGC access-badging-ugc

Die Verwendung der APIs wird bevorzugt.

Zu Untersuchungszwecken wird beispielsweise JSRP verwendet. Der Basisordner mit Informationen zu zugewiesenen oder zugewiesenen Abzeichen ist

gefolgt vom Pfad zum Profil des Benutzers, der in einem Abzeichenordner endet, z. B.:

Ausgezeichnetes Abzeichen awarded-badge

Zugewiesene Abzeichen assigned-badge

Zusätzliche Informationen additional-information

So zeigen Sie eine sortierte Liste von Elementen basierend auf Punkten an: