Scores en Badges Essentials

Met de functie AEM Communities scoring en badges kunnen leden van de gemeenschap worden geïdentificeerd en beloond.

De details van het instellen van de functie worden beschreven op

• Scores en badges van gemeenschappen

Deze pagina bevat aanvullende technische details:

• Procedure een badge weergeven als afbeelding of tekst
• Uitgebreid inschakelen foutopsporing
• Procedure toegang tot UGC met betrekking tot scoring en badging

Badges weergeven

Of een badge als tekst of beeld wordt getoond wordt gecontroleerd op de cliëntkant in het malplaatje van GB.

Zoek bijvoorbeeld naar 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}}

Indien waar (true), geeft isAssigned aan dat de badge voor een rol is toegewezen en dat de badge als tekst moet worden weergegeven.

Indien onwaar (false), wordt bij Toewijzen aangegeven dat de badge is toegekend voor een verdiende score en dat het badge moet worden weergegeven als een afbeelding.

Wijzigingen in dit gedrag moeten worden aangebracht in een aangepast script (overschrijven of bedekken). Zie Aanpassing aan clientzijde.

Foutopsporingslogboek voor score en Badging

Voor foutopsporing in scores en badging kan een aangepast logbestand worden ingesteld. De inhoud van dit logbestand kan dan aan de klantenondersteuning worden verstrekt als er problemen met de functie worden ondervonden.

Ga voor gedetailleerde instructies naar Een aangepast logbestand maken.

U kunt als volgt snel een logbestand instellen:

1. Toegang krijgen tot Adobe Experience Manager Web Console Log Support bijvoorbeeld

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

2. Selecteer Add new logger

   1. Selecteren DEBUG for Log Level

   2. Voer een naam in voor Log File bijvoorbeeld

      • logs/scoring-debug.log

   3. Twee invoeren Logger (klasse) items (gebruiken + pictogram)

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

   4. Selecteer Save

Logboekvermeldingen weergeven:

• Vanuit de webconsole

  • Onder de Status menu
  • Selecteer Log Files
  • Zoek naar uw naam van het Logdossier, zoals scoring-debug

• Op de lokale schijf van de server

  • Het logbestand bevindt zich op <server-install-dir>/crx-quickstart/logs/<log-file-name>.log
  • Bijvoorbeeld, .../crx-quickstart/logs/scoring-debug.log

UGC voor scores en Badging

Het is mogelijk om UGC met betrekking tot het scoring en het aanbrengen van merktekens te bekijken wanneer gekozen SRP of JSRP of MSRP, maar niet ASRP is. (Als u deze termen niet kent, raadpleegt u Opslag van communautaire inhoud en Overzicht opslagbronprovider.)

In de beschrijvingen voor toegang tot scoring- en badinggegevens wordt JSRP gebruikt, omdat de UGC gemakkelijk toegankelijk is via CRXDE Lite.

JSRP bij auteur: experimenteren in de auteursomgeving resulteert in UGC die alleen zichtbaar is vanuit de auteursomgeving.

JSRP bij publicatie: ook als het testen op de publicatieomgeving , is het nodig om toegang te krijgen tot CRXDE Lite met beheerdersrechten voor een publicatie - instantie . Als de publicatie-instantie wordt uitgevoerd in productiemodus (geen samplcontent runmode), is het nodig dat CRXDE Lite inschakelen.

De basislocatie van UGC op JSRP is /content/usergenerated/asi/jcr/.

API's voor scores en Badging

De volgende API's zijn beschikbaar voor gebruik:

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

De nieuwste JavaDocs voor de geïnstalleerde toepassingen lozingen zijn beschikbaar voor ontwikkelaars van de opslagplaats van Adobe. Zie Maven gebruiken voor Gemeenschappen: Javadocs.

De locatie en de indeling van de UGC in de opslagplaats kunnen zonder waarschuwing worden gewijzigd.

Voorbeeld instellen

De schermafbeeldingen van gegevensopslagruimte zijn afkomstig van het instellen van scoring en badging voor een forum op twee verschillende AEM sites:

1. Een AEM site met een unieke id (een communitysite die met een wizard is gemaakt):

   • Met behulp van de site Aan de slag met zelfstudies (engineers) die tijdens de aan de slag - zelfstudie

   • Zoek het knooppunt voor forumpagina

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

   • Eigenschappen voor scoring en badges toevoegen

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

   • Zoek het knooppunt voor de forumcomponent

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

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

   • Eigenschap toevoegen aan weergaveknoppen

     • allowBadges = true

   • Een gebruiker ondertekent in, maakt een forumonderwerp en krijgt een bronzen badge toegewezen

2. Een AEM zonder een unieke id:

   • Met de Community Components Guide

   • Zoek het knooppunt voor forumpagina

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

   • Eigenschappen voor scoring en badges toevoegen

     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]
     

   • Zoek het knooppunt voor de forumcomponent

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

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

   • Eigenschap toevoegen aan weergaveknoppen

     • allowBadges = true

   • Een gebruiker ondertekent in, maakt een forumonderwerp en krijgt een bronzen badge toegewezen

3. Aan een gebruiker wordt een moderatorbadge toegewezen via 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

Aangezien een gebruiker twee bronzen badges heeft verdiend en een moderatorbadge heeft gekregen, is dit hoe de gebruiker met hun forumingang verschijnt:

Toegang tot UGC-score

Gebruik van de API's heeft de voorkeur.

Voor onderzoeksdoeleinden, gebruikend JSRP bijvoorbeeld, is de basisomslag die scores bevat

• /content/usergenerated/asi/jcr/scoring

De onderliggende node van scoringis de naam van de scoreregel. Daarom is het verstandig om regelnamen op een server globaal uniek te scoren.

Voor de plaats van de Ingenieur van de Geometrixx, zijn de gebruiker en hun score in een weg geconstrueerd met de het schrapen regelnaam, plaatsidentiteitskaart van de gemeenschap ( engage-ba81p), een unieke id en de id van de gebruiker:

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

Voor de Community Components Guide-site bevinden de gebruiker en hun score zich in een pad dat is opgebouwd met de naam van de scoreregel, een standaard-id ( default-site), een unieke id en de id van de gebruiker:

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

De score wordt opgeslagen in de eigenschap scoreValue_tl die direct alleen een waarde kunnen bevatten of indirect naar een atomicCounter kunnen verwijzen.

Access Badging UGC

Gebruik van de API's heeft de voorkeur.

Voor onderzoeksdoeleinden, gebruikend JSRP bijvoorbeeld, is de basisomslag die informatie over toegewezen of toegekende badges bevat

• /content/usergenerated/asi/jcr

Wordt gevolgd door het pad naar het gebruikersprofiel en eindigt in een map met badges, zoals

• /home/users/community/w271OOup2Z4DjnOQrviv/profile/badges

Toegewezen badge

toegewezen badge

Aanvullende informatie

Een gesorteerde lijst met leden weergeven op basis van punten:

• Leaderboard, functie voor opname in een community- of groepssjabloon.
• Leaderboard-component, de aanbevolen component van de Leaderboard-functie, voor het ontwerpen van pagina's.

Business.Adobe.com-bronnen

Ecommerce Integrations Asset Collections Mobile Forms Document Generation Managed Cloud Customer Experience Management