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

Mit der AEM Communities-Scoring- und Badges-Funktion werden Community-Mitglieder identifiziert und belohnt.

Die Details 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 auf der Clientseite in der HBS-Vorlage gesteuert.

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

{{#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 Zeichen für eine Rolle zugewiesen wurde und das Zeichen als Text angezeigt werden sollte.

Wenn "false", zeigt isAssigned an, dass der Badge für einen Gewinn zuerkannt wurde und der Badge als Bild angezeigt werden sollte.

Alle Änderungen an diesem Verhalten sollten in einem benutzerdefinierten Skript vorgenommen werden (entweder Überschreiben oder Überlagerung). Siehe Clientseitige Anpassung.

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

Um Scoring und Badging zu debuggen, kann eine benutzerdefinierte Protokolldatei eingerichtet werden. Der Inhalt dieser Protokolldatei kann dann dem Support zur Verfügung gestellt werden, wenn Probleme mit der Funktion auftreten.

Detaillierte Anweisungen finden Sie unter Benutzerdefinierte Protokolldatei erstellen.

So richten Sie schnell eine Slinglog-Datei ein:

So zeigen Sie Protokolleinträge an:

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

Es ist möglich, die UGC im Zusammenhang mit Scoring und Badging anzuzeigen, wenn das ausgewählte SRP entweder JSRP oder MSRP, aber nicht ASRP ist. (Wenn Sie diese Begriffe nicht kennen, finden Sie weitere Informationen unter Community-Inhaltsspeicherung und Übersicht über den Speicher-Ressourcenanbieter.)

Die Beschreibungen für den Zugriff auf Scoring- und Badging-Daten verwenden JSRP, da der Zugriff auf die UGC über CRXDE Lite leicht möglich ist.

JSRP für Autor: Beim Experimentieren in der Autorenumgebung wird UGC angezeigt, der nur in der Autorenumgebung sichtbar ist.

JSRP bei Veröffentlichung: Ebenso ist es beim Testen in der Veröffentlichungsumgebung erforderlich, auf CRXDE Lite mit Administratorrechten auf einer Veröffentlichungsinstanz zuzugreifen. Wenn die Veröffentlichungsinstanz im Produktionsmodus ausgeführt wird (Ausführungsmodus nosamplecontent), muss CRXDE Lite🔗 aktiviert werden.

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

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

Die folgenden APIs stehen zur Verwendung bereit:

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

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

Beispieleinrichtung example-setup

Die Screenshots von Repository-Daten stammen aus der Einrichtung von Scoring und Badging für ein Forum auf zwei verschiedenen AEM Sites :

Auf Scoring-UGC zugreifen access-scoring-ugc

Die Verwendung der APIs wird empfohlen.

Zu Ermittlungszwecken wird mithilfe von JSRP zum Beispiel der Basisordner mit Bewertungen

Der untergeordnete Knoten von scoring ist der Name der Scoring-Regel. Daher empfiehlt es sich, dass die Namen von Scoring-Regeln auf einem Server global eindeutig sind.

Für die Geometrixx Engage-Site befinden sich der Benutzer und sein Ergebnis in einem Pfad, der mit dem Namen der Scoring-Regel, der Site-ID der Community-Site ( engage-ba81p), einer eindeutigen ID und der ID des Benutzers konstruiert wurde:

Auf der Guide-Site "Community-Komponenten"befinden sich der Benutzer und sein Ergebnis in einem Pfad, der mit dem Namen der Scoring-Regel, einer Standard-ID ( default-site), einer eindeutigen ID und der ID des Benutzers konstruiert wurde:

Die Punktzahl wird in der Eigenschaft scoreValue_tl gespeichert, die nur einen Wert enthalten oder indirekt auf einen atomicCounter verweisen kann.

Zugriffsabzeichen-UGC access-badging-ugc

Die Verwendung der APIs wird empfohlen.

Zu Untersuchungszwecken wird mithilfe von JSRP beispielsweise der Basisordner mit Informationen zu zugewiesenen oder vergebenen Abzeichen wie folgt angezeigt:

gefolgt von dem Pfad zum Profil des Benutzers, der in einen Badges-Ordner endet, z. B.:

Ausgezeichnetes Zeichen awarded-badge

Zugewiesenes Zeichen assigned-badge

Zusätzliche Informationen additional-information

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