Punteggio e Badge Essentials

La funzione punteggio e distintivi AEM Communities consente di identificare e premiare i membri della community.

I dettagli relativi alla configurazione della funzione sono descritti in

Questa pagina contiene ulteriori dettagli tecnici:

ATTENZIONE

La struttura di implementazione visibile in CRXDE Lite è soggetta a modifiche.

Visualizzazione dei Badge

Se un contrassegno viene visualizzato come testo o immagine viene controllato sul lato client nel modello HBS.

Ad esempio, cercare 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}}

Se true, isAssigned indica che il contrassegno è stato assegnato a un ruolo e che il contrassegno deve essere visualizzato come testo.

Se false, viene assegnato indica che il contrassegno è stato assegnato per un punteggio ottenuto e che il contrassegno deve essere visualizzato come immagine.

Eventuali modifiche a questo comportamento devono essere apportate in uno script personalizzato (override o sovrapposizione). Vedere Personalizzazione lato client.

Registro di debug per il punteggio e il contrassegno

Per facilitare il debug del punteggio e del contrassegno, è possibile configurare un file di registro personalizzato. Il contenuto di questo file di registro può quindi essere fornito all'assistenza clienti in caso di problemi con la funzionalità.

Per istruzioni dettagliate, visitare Crea un file di registro personalizzato.

Per impostare rapidamente un file slinglog:

  1. Accedere al supporto dei registri della console Web Adobe Experience Manager, ad esempio

    • http://localhost:4502/system/console/slinglog
  2. Selezionare Aggiungi nuovo logger

    1. Selezionare DEBUG per Livello di registro

    2. Immettere un nome per File di registro, ad esempio

      • logs/scoring-debug.log
    3. Immettere due voci Logger (classe) (utilizzando l'icona +)

      • com.adobe.cq.social.scoring
      • com.adobe.cq.social.badging
    4. Seleziona Salva

chlimage_1-248

Per visualizzare le voci di registro:

  • Dalla console Web

    • Nel menu Stato
    • Selezionare File di registro
    • Cerca il nome del file di registro, ad esempio scoring-debug
  • Sul disco locale del server

    • Il file di registro si trova in <server-install-dir/crx-quickstart/logs/<log-file-name.log
    • Esempio, .../crx-quickstart/logs/scoring-debug.log

chlimage_1-249

UGC per il punteggio e il contrassegno

È possibile visualizzare l'UGC relativo al punteggio e al contrassegno quando l'SRP scelto è JSRP o MSRP, ma non ASRP. (Se non avete familiarità con questi termini, consultate Community Content Storage e Panoramica del provider di risorse di storage.)

Le descrizioni per accedere ai dati di punteggio e contrassegno utilizzano JSRP, in quanto l'UGC è facilmente accessibile tramite CRXDE Lite.

JSRP sull’autore: la sperimentazione nell’ambiente di authoring produce UGC visibile solo dall’ambiente di authoring.

JSRP al momento della pubblicazione: analogamente, se si eseguono test nell’ambiente di pubblicazione, sarà necessario accedere ai CRXDE Lite con privilegi amministrativi in un’istanza di pubblicazione. Se l'istanza di pubblicazione è in esecuzione in modalità di produzione (modalità di esecuzione nosamplecontent), sarà necessario abilitare CRXDE Lite.

La posizione di base dell'UGC su JSRP è /content/usergenerated/asi/jcr/.

API Punteggio e Badging

Le seguenti API sono disponibili per l'uso:

Gli ultimi Javadocs per le versioni installate sono disponibili per gli sviluppatori dall'archivio del Adobe . Vedere Utilizzo di Maven per Communities: Javadocs.

La posizione e il formato dell’UGC nel repository sono soggetti a modifiche senza preavviso.

Impostazione esempio

Le schermate dei dati del repository derivano dalla configurazione del punteggio e del contrassegno per un forum su due siti AEM diversi:

  1. Un sito AEM con un ID univoco (sito community creato tramite la procedura guidata):

    • Utilizzo del sito relativo all'esercitazione introduttiva (interazione) creato durante l'esercitazione guida introduttiva

    • Individuare il nodo della pagina del forum

      • /content/sites/engage/en/forum/jcr:content
    • Aggiunta di proprietà di punteggio e contrassegno

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

    • Individuare il nodo del componente forum

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

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

    • Aggiungi proprietà a simboli di visualizzazione

      • allowBadges = true
    • Un utente accede, crea un argomento del forum e riceve un contrassegno di bronzo

  2. Un sito AEM senza un ID univoco:

    • Utilizzo della guida Community Components

    • Individuare il nodo della pagina del forum

      • /content/community-components/en/forum/jcr:content
    • Aggiunta di proprietà di punteggio e contrassegno

      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]
      
    • Individuare il nodo del componente forum

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

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

    • Aggiungi proprietà a simboli di visualizzazione

      • allowBadges = true
    • Un utente accede, crea un argomento del forum e riceve un contrassegno di bronzo

  3. A un utente viene assegnato un contrassegno moderatore utilizzando 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

Come un utente ha guadagnato due simboli in bronzo e ha ricevuto un badge moderatore, questo è come appare l'utente con la voce forum:

chlimage_1-250

NOTA

Questo esempio non segue le best practice seguenti:

  • i nomi delle regole di punteggio devono essere univoci a livello globale; non devono terminare con lo stesso nome.
    Esempio di operazione not:
    /etc/community/scoring/rules/site1/forums-scoring
    /etc/community/scoring/rules/site2/forums-scoring

  • creazione di immagini di contrassegno univoche per siti AEM diversi

UGC punteggio di accesso

È preferibile utilizzare le API.

A scopo investigativo, utilizzando JSRP per esempio, la cartella base contenente i punteggi è

  • /content/usergenerated/asi/jcr/scoring

Il nodo secondario di scoringè il nome della regola di punteggio. Di conseguenza, si consiglia di assegnare a un server nomi univoci per le regole di punteggio.

Per il sito di Geometrixx Engage, l'utente e il relativo punteggio si trovano in un percorso conteggiato con il nome della regola di punteggio, l'ID del sito della community ( engage-ba81p), un ID univoco e l'ID dell'utente:

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

Per il sito della guida per i componenti della community, l'utente e il relativo punteggio si trovano in un percorso costruito con il nome della regola di punteggio, un ID predefinito ( default-site), un ID univoco e l'ID dell'utente:

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

Il punteggio è memorizzato nella proprietà scoreValue_tl che può contenere direttamente solo un valore o fare riferimento indirettamente a un atomicCounter.

chlimage_1-251

Accesso UGC Badge

È preferibile utilizzare le API.

A scopo investigativo, utilizzando JSRP per esempio, la cartella di base contenente informazioni sui simboli assegnati o assegnati è

  • /content/usergenerated/asi/jcr

Seguito dal percorso del profilo dell'utente, che termina in una cartella dei simboli, ad esempio

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

Contrassegno assegnato

chlimage_1-252

contrassegno assegnato

chlimage_1-253

Informazioni aggiuntive

Per visualizzare un elenco ordinato di membri in base ai punti:

  • Funzione della classifica per l'inclusione in un sito o modello di gruppo community.
  • Componente Leaderboard, componente della funzione Leaderboard per l’authoring delle pagine.

In questa pagina