Show Menu
ARGOMENTI×

Punteggio e Badge Essentials

La funzione punteggio e badge di 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:
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, cercate 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). Consultate 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, vedere Creazione di un file di registro personalizzato.
Per impostare rapidamente un file slinglog:
  1. Accedere al supporto dei registri della console Web di Adobe Experience Manager, ad esempio
    • http://localhost:4502/system/console/slinglog
  2. Seleziona Aggiungi nuovo logger
    1. Seleziona DEBUG per il livello di registro
    2. Immettere un nome per il file di registro, ad esempio
      • logs/scoring-debug.log
    3. Inserite due voci Logger (classe) (utilizzando l' + icona)
      • com.adobe.cq.social.scoring
      • com.adobe.cq.social.badging
    4. Seleziona Salva
Per visualizzare le voci di registro:
  • Dalla console Web
    • Nel menu Stato
    • Seleziona file di registro
    • Cercare 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

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 and Storage Resource Provider Overview (Panoramica sui provider di risorse di archiviazione e archiviazione).
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 a 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 di UGC su JSRP è /content/usergenerated/asi/jcr/ .

API Punteggio e Badging

Le seguenti API sono disponibili per l'uso:
Gli aggiornamenti Javadocs più recenti per le versioni installate sono disponibili per gli sviluppatori dall'archivio di Adobe. Vedere Utilizzo di Paradiso per le community: Javadocs .
La posizione e il formato dell’UGC nel repository sono soggetti a modifiche senza preavviso .

Esempio di configurazione

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 Esercitazione introduttiva (interazione) creato durante l’esercitazione 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:
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. Un esempio di cosa non fare: /etc/community/scoring/rules/site1/forums-scoring /etc/community/scoring/rules/site2/forums-scoring
  • creazione di immagini di badge univoche per diversi siti AEM

UGC per 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 figlio 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 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 solo un valore o fare riferimento indirettamente a un atomicCounter.

Accesso UGC

È 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

Badge aggiudicato

badge assegnato

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.