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

• Communities - Bewertung und Abzeichen

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?[

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 schnell eine Slinglog-Datei ein:

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

   • https://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

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

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:

• com.adobe.cq.social.scoring.api
• com.adobe.cq.social.badging.api

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.

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 Site 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 = [/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.

   

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 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 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.

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/profile/badges

Ausgezeichnetes Zeichen

Zugewiesenes Zeichen

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.