DokumentationAEM 6.4Användarhandbok om Communities

Grundläggande om poäng och emblem scoring-and-badges-essentials

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Skapat för:

  • User
CAUTION
AEM 6.4 har nått slutet på den utökade supporten och denna dokumentation är inte längre uppdaterad. Mer information finns i teknisk supportperiod. Hitta de versioner som stöds här.

AEM Communities poäng och badges ger möjlighet att identifiera och belöna communitymedlemmar.

Information om hur du konfigurerar funktionen finns i

Den här sidan innehåller ytterligare teknisk information:

CAUTION
Den implementeringsstruktur som visas i CRXDE Lite kan komma att ändras.

Visar emblem displaying-badges

Om ett märke visas som text eller bild styrs på klientsidan i HBS-mallen.

Sök till exempel efter 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}}

Om värdet är true anger isAssigned att märket har tilldelats en roll och att märket ska visas som text.

Om värdet är false anges märket Tilldelad att märket tilldelats för ett upparbetat resultat och att märket ska visas som en bild.

Alla ändringar av detta beteende bör göras i ett anpassat skript (antingen åsidosätt eller övertäckning). Se Anpassning på klientsidan.

Felsökningslogg för poängsättning och märkning debug-log-for-scoring-and-badging

En anpassad loggfil kan konfigureras för felsökning av poängsättning och badging. Innehållet i loggfilen kan sedan tillhandahållas kundsupporten om problem uppstår med funktionen.

Detaljerade instruktioner finns på Skapa en anpassad loggfil.

Så här konfigurerar du snabbt en slinglog-fil:

  1. Öppna Adobe Experience Manager Web Console Log Support, till exempel

    • http://localhost:4502/system/console/slinglog

  2. Välj Add new logger

    1. Välj DEBUG for Log Level

    2. Ange ett namn för Log File, till exempel

      • logs/scoring-debug.log

    3. Ange två Logger (class)-poster (använda + ikon)

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

    4. Välj Save

chlimage_1-248

Så här visar du loggposter:

  • Från webbkonsolen

    • Under Status meny
    • Välj Log Files
    • Sök efter loggfilens namn, till exempel scoring-debug

  • På serverns lokala disk

    • Loggfilen är på <server-install-dir>/crx-quickstart/logs/<log-file-name>.log
    • Till exempel, .../crx-quickstart/logs/scoring-debug.log

chlimage_1-249

UGC för poängsättning och märkning ugc-for-scoring-and-badging

Det går att visa användargenererat innehåll som är relaterat till poängsättning och märkning när den valda SRP är antingen JSRP eller MSRP, men inte ASRP. (Om du inte känner till dessa termer kan du läsa Community-innehåll och Översikt över lagringsresursprovider.)

Beskrivningarna för att komma åt betygs- och badging-data använder JSRP, eftersom användargenererat innehåll är lätt att komma åt med CRXDE Lite.

JSRP on author: när du experimenterar i redigeringsmiljön resulterar det i användargenererat innehåll som bara är synligt från författarmiljön.

JSRP vid publicering: På samma sätt måste du, om du testar i publiceringsmiljön, ha administratörsbehörighet för en publiceringsinstans i CRXDE Lite. Om publiceringsinstansen körs i produktionsläge (nosampling content runmode), måste du enable CRXDE Lite.

Basplatsen för UGC på JSRP är /content/usergenerated/asi/jcr/.

API:er för klassificering och märkning scoring-and-badging-apis

Följande API:er kan användas:

De senaste Javadocs-filerna för den installerade releaser är tillgängliga för utvecklare från Adobe-databasen. Se Använda Maven for Communities: Javadocs.

Platsen och formatet för användargenererat innehåll i databasen kan ändras utan förvarning.

Exempelinställningar example-setup

Skärmbilderna av databasdata kommer från hur du ställer in poängsättning och märkning för ett forum på två olika AEM:

  1. En AEM webbplats med ett unikt ID (communitywebbplats skapad med guide):

    • Använda självstudiekursen Komma igång (engagera) som skapats under komma igång, självstudiekurs

    • Hitta forumsidnoden

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

    • Lägga till egenskaper för poängsättning och märkning

      • 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]

    • Hitta forumkomponentnoden

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

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

    • Lägg till egenskap för att visa emblem

      • allowBadges = true

    • En användare loggar in, skapar ett forumämne och tilldelas ett bronze-märke

  2. En AEM utan ett unikt ID:

    • Använda Community Components Guide

    • Hitta forumsidnoden

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

    • Lägga till egenskaper för poängsättning och märkning

      code language-none 
      scoringRules = [/etc/community/scoring/rules/comments-scoring,
/etc/community/scoring/rules/forums-scoring]
      code language-none 
      badgingRules =[/etc/community/badging/rules/comments-scoring,
/etc/community/badging/rules/forums-scoring]

    • Hitta forumkomponentnoden

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

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

    • Lägg till egenskap för att visa emblem

      • allowBadges = true

    • En användare loggar in, skapar ett forumämne och tilldelas ett bronze-märke

  3. En användare tilldelas ett moderatormärke med cURL:

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

När en användare har fått två bronze-märken och tilldelats ett moderatormärke visas detta på det sätt som användaren använder sin forumpost:

chlimage_1-250

NOTE
Det här exemplet följer inte följande metodtips:

  • Poängregelnamnen ska vara globalt unika. de ska inte sluta med samma namn.
    Ett exempel på vad not att göra:
    /etc/community/scoring/rules/site1/forums-scoring
    /etc/community/scoring/rules/site2/forums-scoring

  • skapa unika märkesbilder för olika AEM

UGC för åtkomstbedömning access-scoring-ugc

Användning av API:er är att föredra.

I undersökningssyfte, till exempel med JSRP, är baskamappen som innehåller poäng

  • /content/usergenerated/asi/jcr/scoring

Den underordnade noden för scoringär resultatregelns namn. Det bästa sättet är alltså att betygsregelnamn på en server är globalt unika.

För webbplatsen Geometrixx Engage finns användaren och poängen i en sökväg som är konstruerad med namnet på bedömningsregeln, webbplatsens webbplats-ID ( engage-ba81p), ett unikt id och användarens id:

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

För stödwebbplatsen för Community Components finns användaren och poängen i en sökväg som konstruerats med namnet på bedömningsregeln, ett standard-ID ( default-site), ett unikt id och användarens id:

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

Ljudspåret lagras i egenskapen scoreValue_tl som bara kan innehålla ett värde eller indirekt referera till en atomicCounter.

chlimage_1-251

Access Badging UGC access-badging-ugc

Användning av API:er är att föredra.

I undersökningssyfte, till exempel med JSRP, är baskappen som innehåller information om tilldelade eller tilldelade märken

  • /content/usergenerated/asi/jcr

Följs av sökvägen till användarens profil och avslutas i en badges-mapp, till exempel

  • /home/users/community/w271Oup2Z4DjnOQrviv/profile/badges

Tilldelad bricka awarded-badge

chlimage_1-252

tilldelat märke assigned-badge

chlimage_1-253

Ytterligare information additional-information

Så här visar du en sorterad lista med medlemmar baserat på punkter:

recommendation-more-help
5d37d7b0-a330-461b-814d-068612705ff6