Grundlagen zu Scoring und Kennzeichen

Die AEM Communities-Funktion für Scoring und Abzeichen bietet die Möglichkeit, Community-Mitglieder zu identifizieren und zu belohnen.

Die Details zur Einrichtung der Funktion finden Sie unter

Diese Seite enthält weitere technische Details:

  • Anzeigen eines Kennzeichens](#displaying-badges) als Bild oder Text[
  • So aktivieren Sie die umfassende Debugging-Protokollierung
  • Wie greifen Sie auf UGC](#ugc-for-scoring-and-badging) im Zusammenhang mit Scoring und Abzeichen zu?[
VORSICHT

Die in der CRXDE Lite sichtbare Implementierungsstruktur kann sich ändern.

Anzeigen von Kennzeichen

Ob ein Zeichen als Text oder Bild angezeigt wird, wird auf der Clientseite 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 Zeichen für eine Rolle zugewiesen wurde und das Zeichen als Text angezeigt werden sollte.

Wenn "false"festgelegt ist, zeigt Zugewiesen an, dass das Abzeichen für eine Ergebnisbewertung vergeben wurde und das Abzeichen als Bild angezeigt werden sollte.

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

Debug-Protokoll für Bewertung und Abzeichen

Um das Debugging von Scoring und Abzeichen zu unterstützen, kann eine benutzerdefinierte Protokolldatei eingerichtet werden. Der Inhalt dieser Protokolldatei kann dann dem Kundensupport zur Verfügung gestellt werden, wenn Probleme mit der Funktion auftreten.

Ausführliche Anweisungen finden Sie unter Benutzerspezifische Protokolldatei erstellen.

So richten Sie eine Slinglog-Datei schnell ein:

  1. Zugriff auf die Adobe Experience Manager Web Console Log Support, z. B.

    • http://localhost:4502/system/console/slinglog
  2. Wählen Sie Hinzufügen neue Protokollfunktion

    1. Wählen Sie DEBUG für Protokollebene

    2. Geben Sie einen Namen für Protokolldatei ein, z. B.

      • logs/scoring-debug.log
    3. Geben Sie zwei Logger (class)-Einträge ein (mit dem +-Symbol)

      • com.adobe.cq.social.scoring
      • com.adobe.cq.social.badging
    4. Wählen Sie Speichern aus

chlimage_1-248

So zeigen Sie Protokolleinträge an:

  • Über die Web-Konsole

    • Im Menü Status
    • Wählen Sie Protokolldateien
    • Suchen Sie nach dem Namen Ihrer Protokolldatei, z. B. scoring-debug
  • Auf dem lokalen Datenträger des Servers

    • Die Protokolldatei befindet sich unter <server-install-dir/crx-quickstart/logs/<log-file-name.log
    • Beispiel: .../crx-quickstart/logs/scoring-debug.log

chlimage_1-249

UGC für Scoring und Bading

Es ist möglich, die UGC in Bezug auf die Bewertung und Abzeichen zu Ansichten, wenn die gewählte SRP entweder JSRP oder MSRP, aber nicht ASRP ist. (Wenn Sie mit diesen Begriffen nicht vertraut sind, lesen Sie Community Content Datenspeicherung und Übersicht über den Datenspeicherung Resource Provider.)

Die Beschreibungen für den Zugriff auf Scoring- und Abzeichen-Daten verwenden JSRP, da der Zugriff auf die UGC mit CRXDE Lite einfach ist.

JSRP für Autor: Das Experimentieren in der Autorendatei führt zu einer UGC, die nur in der Autorenversion der Umgebung sichtbar ist.

JSRP bei Veröffentlichung: Ebenso ist es bei Tests auf der Umgebung "Veröffentlichen"erforderlich, auf die CRXDE Lite mit Administratorrechten auf einer Instanz im Veröffentlichungsmodus zuzugreifen. Wenn die Instanz im Veröffentlichungsmodus im Produktionsmodus ausgeführt wird (nicht im Ausführungsmodus zum Abrufen von Inhalten), muss die CRXDE Lite aktiviert werden.

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

Scoring- und Badging-APIs

Die folgenden APIs stehen zur Verwendung zur Verfügung:

Die neuesten JavaScript-Dateien für die installierten Releases stehen Entwicklern aus dem Adoben-Repository zur Verfügung. Siehe Maven für Communities verwenden: Javadocs.

Speicherort und Format des UGC im Repository können ohne Warnung geändert werden.

Beispiel-Setup

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

  1. Eine AEM mit einer eindeutigen ID (Community-Site, die mithilfe des Assistenten erstellt wurde):

    • Verwenden der Website "Erste Schritte"-Lernprogramm (Interaktion), die während des Lernprogramms "Erste Schritte" erstellt wurde

    • Suchen Sie den Knoten der Forumseite

      • /content/sites/engage/en/forum/jcr:content
    • hinzufügen und Abzeichen

      • scoringRules = [/etc/community/scoring/rules/comments-scoring,

        /etc/community/scoring/rules/forums-scoring]

      • badgingRules =[/etc/community/badging/rules/comments-scoring,

        /etc/community/badging/rules/forums-scoring]

    • Suchen Sie den Knoten der Forumkomponente

      • /content/sites/engage/en/forum/jcr:content/content/primary/forum

        ( sling:resourceType = social/forum/components/hbs/forum)

    • hinzufügen Eigenschaft zum Anzeigen von Abzeichen

      • allowBadges = true
    • Ein Benutzer meldet sich an, erstellt ein Forenthema und erhält eine Bronze-Abzeichen

  2. Eine AEM-Site ohne eine eindeutige ID:

    • Verwenden des Handbuchs Community-Komponenten

    • Suchen Sie den Knoten der Forumseite

      • /content/community-components/en/forum/jcr:content
    • hinzufügen und Abzeichen

      scoringRules = [/etc/community/scoring/rules/comments-scoring,
      /etc/community/scoring/rules/forums-scoring]
      
      badgingRules =[/etc/community/badging/rules/comments-scoring,
      /etc/community/badging/rules/forums-scoring]
      
    • Suchen Sie den Knoten der Forumkomponente

      • /content/community-components/en/forum/jcr:content/content/forum

        ( sling:resourceType = social/forum/components/hbs/forum)

    • hinzufügen Eigenschaft zum Anzeigen von Abzeichen

      • allowBadges = true
    • Ein Benutzer meldet sich an, erstellt ein Forenthema und erhält eine Bronze-Abzeichen

  3. Dem Benutzer wird mithilfe von cURL ein Moderator-Abzeichen zugewiesen:

curl -i -X POST -H "Accept:application/json" -u admin:admin -F ":operation=social:assignBadge" -F "badgeContentPath=/etc/community/badging/images/moderator/jcr:content/moderator.png" http://localhost:4503/home/users/community/w271OOup2Z4DjnOQrviv/profile.social.json

Da ein Benutzer zwei Bronze-Abzeichen erhalten hat und ein Moderator-Abzeichen erhalten hat, wird der Benutzer mit seinem Foreneintrag wie folgt angezeigt:

chlimage_1-250

HINWEIS

Dieses Beispiel folgt nicht den folgenden bewährten Verfahren:

  • Die Namen von Bewertungsregeln sollten global eindeutig sein. sie sollten nicht mit demselben Namen enden.
    Beispiel für die folgenden Aufgaben:**
    /etc/community/scoring/rules/site1/forums-scoring
    /etc/community/scoring/rules/site2/forums-scoring

  • Erstellen von eindeutigen Abzeichen-Bildern für verschiedene AEM Sites

Zugriff auf Scoring-UGC

Die Verwendung der APIs wird empfohlen.

Zu Ermittlungszwecken ist der Basisordner, der Ergebnisse enthält, z. B. mithilfe von JSRP

  • /content/usergenerated/asi/jcr/scoring

Der untergeordnete Knoten von scoringist der Name der Bewertungsregel. Eine Best Practice ist daher, dass die Namen von Bewertungsregeln 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 Bewertungsregel, der Site-ID der Community ( engage-ba81p), einer eindeutigen ID und der ID des Benutzers verknüpft ist:

  • .../scoring/forums-scoring/engage-ba81p/6d179715c0e93cb2b20886aa0434ca9b5a540401/riley

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

  • .../scoring/forums-scoring/default-site/b27a17cb4910a9b69fe81fb1b492ba672d2c086e/riley

Das Ergebnis wird in der Eigenschaft scoreValue_tl gespeichert, die direkt nur einen Wert enthält oder indirekt auf einen atomicCounter verweist.

chlimage_1-251

Zugriffskennzeichen-UGC

Die Verwendung der APIs wird empfohlen.

Zu Ermittlungszwecken wird beispielsweise mithilfe von JSRP der Basisordner mit Informationen über zugewiesene oder zugewiesene Kennzeichen wie folgt angezeigt:

  • /content/usergenerated/asi/jcr

Nach dem Pfad zum Profil des Benutzers, der in einem Ablagenordner endet, z. B.

  • /home/users/community/w271OOup2Z4DjnOQrviv/Profil/badges

Ausgezeichnetes Zeichen

chlimage_1-252

zugewiesenes Zeichen

chlimage_1-253

Zusätzliche Informationen

So zeigen Sie eine sortierte Liste der Mitglieder basierend auf Punkten an:

  • Leaderboard- Funktion zur Einbeziehung in eine Community-Site- oder Gruppenvorlage.
  • Komponente "Leaderboard", die spezielle Komponente der Funktion "Leaderboard", zum Erstellen von Seiten.

Auf dieser Seite

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free