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 till exempel efter this.isAssigned i /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 anger isAssigned att märket har tilldelats för ett upparbetat poäng 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. Få åtkomst till loggstödet för Adobe Experience Manager Web Console, till exempel

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

    1. Välj DEBUG för Loggnivå

    2. Ange ett namn för loggfilen, till exempel

      • logs/scoring-debug.log
    3. Ange två Logger-poster (klass) (med ikonen + )

      • 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 menyn Status
    • Välj Loggfiler
    • Sök efter loggfilens namn, till exempel scoring-debug
  • På serverns lokala disk

    • Loggfilen finns på <server-install-dir>/crx-quickstart/logs/<log-file-name>.log

    • 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 läser du Community Content Storage och Storage Resource Provider Overview.)

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

JSRP på författare: Om du experimenterar i författarmiljön resulterar det i UGC som bara är synligt från författarmiljön.

JSRP vid publicering: Om du testar i publiceringsmiljön måste du även ha administratörsbehörighet för en publiceringsinstans i CRXDE Lite. Om publiceringsinstansen körs i produktionsläge (noSampleContent Run Mode) måste du aktivera 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 Använda Maven för Communities: Javadocs.

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

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 (communitywebbplatsen har skapats med guiden):

    • Använda självstudiekursen Komma igång (engagerande) som skapades under självstudiekursen Komma igång

    • 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 guiden Community Components

    • 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 inte ska 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

Du bör använda API:erna.

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, i en sökväg som konstruerats med resultatregelnamnet, 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 för den, i en sökväg som konstruerats med bedömningsregelnamnet, ett standard-ID ( default-site), ett unikt ID och användarens ID:

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

Poängen 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

Du bör använda API:erna.

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