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

AEM Communities poäng och brickor identifierar och belönar 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 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 true, isAssigned anger att märket har tilldelats en roll och att det ska visas som text.

Om false isAssigned visar att märket tilldelats för en poäng som har erhållits 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 Stöd för Adobe Experience Manager Web Console-loggen, till exempel

    • https://localhost:4502/system/console/slinglog
  2. Välj Lägg till ny loggare

    1. Välj DEBUG for Loggnivå

    2. Ange ett namn för Loggfil, 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 Spara

debug-scoring-log

Så här visar du loggposter:

  • Från webbkonsolen

    • Under Status meny
    • Välj Loggfiler
    • 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

poänglogg

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: Om 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, få åtkomst till CRXDE Lite med administratörsbehörighet för en publiceringsinstans. Om publiceringsinstansen körs i produktionsläge (ingen innehållets körningsläge) 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 det installerade funktionspaketet är tillgängliga för utvecklare från Adobe-databasen. Se Using 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ärmbilder av databasdata kommer från konfiguration av poängsättning och märkning för ett forum på två olika AEM:

  1. En AEM 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

    code language-none
    scoringRules = [/libs/settings/community/scoring/rules/comments-scoring,
    /libs/settings/community/scoring/rules/forums-scoring]
    
    code language-none
    badgingRules =[/libs/settings/community/badging/rules/comments-scoring,
    /libs/settings/community/badging/rules/forums-scoring]
    
    • Leta reda på 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 = [/libs/settings/community/scoring/rules/comments-scoring,
    /libs/settings/community/scoring/rules/forums-scoring]
    
    code language-none
    badgingRules =[/libs/settings/community/badging/rules/comments-badging,
    /libs/settings/community/badging/rules/forums-badging]
    
    • Leta reda på 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:

    code language-shell
    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
    

    När en användare har fått två bronze-märken och tilldelats ett moderatormärke visas användaren med sitt foruminlägg på följande sätt:

    moderator

NOTE
Det här exemplet följer inte följande metodtips:
  • Poängregelnamn ska vara globalt unika. De får inte sluta med samma namn.

    Ett exempel på vad not att göra:

    /libs/settings/community/scoring/rules/site1/forums-scoring
    /libs/settings/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 bäst.

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 Geometrixx Engage-webbplatsen är användaren och poängen för den en sökväg som konstruerats med resultatregelnamnet, communityplatsens 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 för den, 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.

access-scoring-ugc

Access Badging UGC access-badging-ugc

Användning av API:er är bäst.

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

Tilldelad bricka awarded-badge

tilldelad-badging-ugc

Tilldelat märke assigned-badge

tilldelad-badge

Ytterligare information additional-information

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

recommendation-more-help
81e2cd9d-0789-409d-b87c-2a8ce4f28791