Show Menu
THEMEN×

Grundlagen zu Scoring und Abzeichen

Die Funktion für die Bewertung und Kennzeichnung von AEM Communities 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:
Die in CRXDE Lite sichtbare Implementierungsstruktur kann geändert werden.

Anzeigen von Abzeichen

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 Erstellen einer benutzerdefinierten Protokolldatei .
So richten Sie schnell eine Slinglog-Datei ein:
  1. Greifen Sie beispielsweise auf die Web-Konsolenprotokoll-Unterstützung des Adobe Experience Managers zu
    • https://localhost:4502/system/console/slinglog
  2. Neue Hinzufügen auswählen
    1. Wählen Sie DEBUG für Protokollebene
    2. Geben Sie beispielsweise einen Namen für die Protokolldatei ein.
      • logs/scoring-debug.log
    3. Geben Sie zwei Protokolleinträge (Klasseneinträge) ein (mit + dem Symbol)
      • com.adobe.cq.social.scoring
      • com.adobe.cq.social.badging
    4. Wählen Sie Speichern aus
So zeigen Sie Protokolleinträge an:
  • Über die Web-Konsole
    • Im Menü " Status "
    • Protokolldateien auswählen
    • Suchen Sie nach dem Namen Ihrer Protokolldatei, z. B. scoring-debug
  • Auf dem lokalen Datenträger des Servers
    • Die Protokolldatei befindet sich unter < Server-Installationsdir >/crx-quickstart/logs/< log-file-name >.log
    • Beispiel: .../crx-quickstart/logs/scoring-debug.log

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, finden Sie weitere Informationen unter Community Content Datenspeicherung und Übersicht über Datenspeicherung Resource Provider .)
Die Beschreibungen für den Zugriff auf Scoring- und Abzeichen-Daten verwenden JSRP, da die UGC mit CRXDE Lite leicht zugänglich 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 : Ähnlich ist es bei Tests auf der Veröffentlichungsinstanz erforderlich, auf CRXDE Lite mit Administratorrechten auf einer Veröffentlichungsinstanz zuzugreifen. Wenn die Instanz im Veröffentlichungsmodus im Produktionsmodus ausgeführt wird (nicht im Ausführungsmodus zum Abrufen von Inhalten), muss CRXDE Lite aktiviert werden .
Der Basisort von UGC auf JSRP ist /content/usergenerated/asi/jcr/ .

Scoring- und Badging-APIs

Die folgenden APIs stehen zur Verwendung zur Verfügung:
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 ohne Warnung geändert werden.

Beispieleinrichtung

Die Screenshots der Repository-Daten stammen aus der Einrichtung von Scoring und Abzeichen für ein Forum auf zwei verschiedenen AEM-Sites:
  1. Eine AEM-Site mit einer eindeutigen ID (Community-Site, die mithilfe des Assistenten erstellt wurde):
    scoringRules = [/libs/settings/community/scoring/rules/comments-scoring,
    /libs/settings/community/scoring/rules/forums-scoring]
    
    
    badgingRules =[/libs/settings/community/badging/rules/comments-scoring,
    /libs/settings/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 = [/libs/settings/community/scoring/rules/comments-scoring,
    /libs/settings/community/scoring/rules/forums-scoring]
    
    
    badgingRules =[/libs/settings/community/badging/rules/comments-badging,
    /libs/settings/community/badging/rules/forums-badging]
    
    
    • 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 mit cURL ein Moderator-Abzeichen zugewiesen:
    curl -i -X POST -H "Accept:application/json" -u admin:admin -F ":operation=social:assignBadge" -F "badgeContentPath=/libs/settings/community/badging/images/moderator/jcr:content/moderator.png" https://localhost:4503/home/users/community/w271OOup2Z4DjnOQrviv/profile.social.json
    
    
    Da ein Benutzer zwei Bronze-Abzeichen erhalten hat und ein Moderator-Abzeichen erhalten hat, erscheint der Benutzer mit seinem Forumseintrag so.
Dieses Beispiel folgt nicht den folgenden bewährten Verfahren:
  • Die Namen von Bewertungsregeln sollten global eindeutig sein. sie sollten nicht mit demselben Namen enden. Ein Beispiel dafür, was nicht zu tun ist: /libs/settings/community/scoring/rules/site1/forums-scoring /libs/settings/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 bevorzugt.
Zu Ermittlungszwecken ist der Basisordner, der Ergebnisse enthält, z. B. mithilfe von JSRP
  • /content/usergenerated/asi/jcr/scoring
Der untergeordnete Knoten von scoring ist 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 Community-Site-ID ( engage-ba81p ), einer eindeutigen ID und der Benutzer-ID 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 wird:
  • .../scoring/forums-scoring/default-site/b27a17cb4910a9b69fe81fb1b492ba672d2c086e/riley
Das Ergebnis wird in der Eigenschaft gespeichert, scoreValue_tl die direkt einen Wert enthält oder indirekt auf einen atomicCounter verweist.

UGC für Zugriffsabzeichen

Die Verwendung der APIs wird bevorzugt.
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/profile/badges

Ausgezeichnetes Zeichen

Zugewiesenes Zeichen

Zusätzliche Informationen

So zeigen Sie eine sortierte Liste der Mitglieder basierend auf Punkten an:
  • Leaderboard-Funktion zur Einbindung in eine Community-Site- oder Gruppenvorlage.
  • Komponente "Leaderboard", die spezielle Komponente der Funktion "Leaderboard", zum Erstellen von Seiten.