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:
Die in der CRXDE Lite sichtbare Implementierungsstruktur kann sich ändern.
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.
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:
Zugriff auf die Adobe Experience Manager Web Console Log Support, z. B.
Wählen Sie Hinzufügen neue Protokollfunktion
Wählen Sie DEBUG
für Protokollebene
Geben Sie einen Namen für Protokolldatei ein, z. B.
Geben Sie zwei Logger (class)-Einträge ein (mit dem +
-Symbol)
com.adobe.cq.social.scoring
com.adobe.cq.social.badging
Wählen Sie Speichern aus
So zeigen Sie Protokolleinträge an:
Über die Web-Konsole
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
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/
.
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.
Die Screenshots der Repository-Daten stammen aus der Einrichtung von Scoring und Abzeichen für ein Forum auf zwei verschiedenen AEM Websites:
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
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
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:
Beispiel für die folgenden Schritte:**
/libs/settings/community/scoring/rules/site1/forums-scoring
/libs/settings/community/scoring/rules/site2/forums-scoring
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.
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
So zeigen Sie eine sortierte Liste der Mitglieder basierend auf Punkten an: