Punteggio e distintivi delle community

Panoramica

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

I principali aspetti del punteggio e dei simboli sono:

• Assegnare i badge per identificare il ruolo di un membro nella community

• Attribuzione di base di badgesto ai membri per incoraggiarne la partecipazione (quantità di contenuto creato)

• Assegnazione avanzata di badgesto per identificare i membri come esperti (qualità del contenuto creato)

​​Tenere presente che l'assegnazione dei simboli non è abilitata per impostazione predefinita.

Badge

I distintivi sono posti sotto il nome di un membro per indicare il suo ruolo o la sua posizione nella comunità. I simboli possono essere visualizzati come immagine o come nome. Quando viene visualizzata come immagine, il nome viene incluso come testo alternativo per l'accessibilità.

Per impostazione predefinita, i simboli si trovano nella directory archivio in

• /etc/community/badging/immagini

Se memorizzati in un percorso diverso, tutti dovrebbero essere accessibili in lettura.

I distintivi sono differenziati in UGC se sono stati assegnati o sono stati guadagnati in base alle regole. Al momento, i simboli assegnati vengono visualizzati come testo e i simboli acquisiti vengono visualizzati come immagine.

Interfaccia utente di gestione dei badge

La console Community Badges offre la possibilità di aggiungere distintivi personalizzati che possono essere visualizzati per un membro al momento della ricezione (assegnazione) o quando assumono un ruolo specifico nella comunità (assegnazione).

Badge assegnati

I simboli basati sul ruolo vengono assegnati da un amministratore ai membri della community in base al loro ruolo nella comunità.

I simboli assegnati (e avvertiti) sono memorizzati nell' SRP selezionato e non sono direttamente accessibili. Fino a quando non sarà disponibile un'interfaccia utente grafica, l'unico modo per assegnare i simboli basati sui ruoli è farlo con codice o cURL. Per le istruzioni cURL, vedere la sezione intitolata Assegna e revoca distintivi.

Nella versione sono inclusi tre simboli basati sui ruoli:

• Moderatore

  /etc/community/badging/images/moderator/jcr:content/moderator.png

• Manager gruppo

  /etc/community/badging/images/group-manager/jcr:content/group-manager.png

• Membro privilegiato

  /etc/community/badging/images/privileged-member/jcr:content/privileged-member.png

Badge aggiudicati

Il servizio di assegnazione dei punteggi viene assegnato ai membri della comunità in base alle regole applicate alla loro attività nella comunità.

Affinché i simboli possano essere visualizzati come una ricompensa per l'attività, devono accadere due cose:

• Il contrassegno deve essere abilitato per il componente feature
• Le regole di punteggio e contrassegno devono essere applicate alla pagina (o antenato) in cui è collocato il componente

Nel rilascio sono inclusi tre simboli basati sulla ricompensa:

• Oro

  /etc/community/badging/images/gold-badge/jcr:content/gold.png

• Argento

  /etc/community/badging/images/silver-badge/jcr:content/silver.png

• Bronzo

  /etc/community/badging/images/bronze-badge/jcr:content/bronze.png

Badge personalizzati

I simboli personalizzati possono essere installati utilizzando la console Badges e possono essere assegnati o specificati nelle regole di contrassegno.

Se installati dalla console Badge, i simboli personalizzati vengono replicati automaticamente nell’ambiente di pubblicazione.

Abilita punteggio

Il punteggio non è abilitato per impostazione predefinita. I passaggi di base per l’impostazione e l’abilitazione del punteggio e dell’assegnazione dei simboli sono:

• Identificare le regole per i punti di guadagno (regole di punteggio)

• Per i punti accumulati per le regole di punteggio, assegnare simboli (regole di contrassegno)

• Applicazione delle regole di punteggio e contrassegno a un sito community

• Abilitare i simboli per le funzioni per community

Consultate la sezione Test rapido per abilitare il punteggio per un sito community utilizzando le regole di punteggio e contrassegno predefinite per forum e commenti.

Applica regole al contenuto

Per abilitare il punteggio e i simboli, aggiungi le proprietà scoringRules e badgingRulesa qualsiasi nodo della struttura del contenuto del sito.

Se il sito è già pubblicato, dopo aver applicato tutte le regole e attivato i componenti, ripubblicate il sito.

Le regole applicabili a un componente abilitato per il contrassegno sono quelle relative al nodo corrente o al suo predecessore.

Se il nodo è di tipo cq:Page (consigliato), aggiungere le proprietà al nodo jcr:contentutilizzando CRXDE|Lite.

Proprietà	Tipo	Descrizione
badgingRules	Stringa[]	un elenco di array di regole di contrassegno
scoringRules	Stringa[]	un elenco di array di regole di punteggio

Abilita i distintivi per il componente

Le regole di punteggio e di binding sono valide solo per le istanze di componenti che hanno attivato il contrassegno modificando la configurazione del componente in modalità di authoring.

Una proprietà booleana, allowBadges, attiva/disattiva la visualizzazione dei simboli per un’istanza di componente. È configurabile nella finestra di dialogo di modifica dei componenti per i componenti forum, QnA e commento tramite una casella di controllo con l'etichetta Display Badges.

Esempio: allowBadges per l’istanza del componente Forum

Regole di punteggio

Le regole di punteggio sono alla base del punteggio ai fini dell'assegnazione dei distintivi.

Molto semplicemente, ogni regola di punteggio è un elenco di una o più regole secondarie. Le regole di punteggio vengono applicate al contenuto del sito della community per identificare le regole da applicare quando i simboli sono abilitati.

Le regole di punteggio vengono ereditate ma non aggiunte. Esempio:

• Se la pagina2 contiene la regola di punteggio2 e la pagina precedente contiene la regola di punteggio1

• Un'azione su un componente pagina2 richiamerà sia regola1 che regola2

• Se entrambe le regole contengono sub-regole applicabili per lo stesso topic/verb:

  • Solo la regola secondaria di rule2 influirà sul punteggio
  • I punteggi di entrambe le regole secondarie non vengono sommati

Se è presente più di una regola di punteggio, i punteggi vengono mantenuti separatamente per ogni regola.

Le regole di punteggio sono nodi di tipo cq:Page con proprietà nel nodo jcr:contentche specificano l'elenco di regole secondarie che lo definiscono.

I punteggi sono memorizzati in SRP.

Regole secondarie punteggio

Le regole secondarie del punteggio contengono le proprietà che descrivono i valori per la partecipazione alla comunità.

Ogni regola secondaria di punteggio identifica

• Quali attività vengono tracciate?
• Quale funzione comunitaria specifica è coinvolta?
• Quanti punti vengono assegnati?

Per impostazione predefinita, i punti vengono assegnati al membro che esegue l'azione, a meno che la regola secondaria non specifichi che il proprietario del contenuto riceve i punti ( forOwner).

Ciascuna regola secondaria può essere inclusa in una o più regole di punteggio.

Il nome della regola secondaria segue in genere il pattern di utilizzo di un oggetto oggetto, oggetto e verb. Esempio:

• membro-commento-create
• membro-ricevente

Le regole secondarie sono nodi di tipo cq:Page con proprietà sul nodo jcr:contentche specificano i verbi e i topic e .

Proprietà	Tipo	Valore Descrizione
VERB	Lungo	obbligatorio; il verbo corrisponde a un'azione di evento deve essere presente almeno una proprietà verbo il verbo deve essere inserito in tutto MAIUSCOLO possono essere presenti più proprietà verbo, ma non sono presenti duplicati il valore è il punteggio da applicare per l'evento il valore può essere positivo o negativo un elenco di verbi supportati nella release è nella sezione Topics and Verbs
topics	Stringa[]	optional; limita la regola secondaria ai componenti della community identificati dagli argomenti dell'evento se specificato: value è una stringa multivalore di argomenti evento un elenco di argomenti nella release si trova nella sezione Argomenti e verbi l'impostazione predefinita è applicabile a tutti gli argomenti associati al verbo o ai verbi
forOwner	Booleano	optional; non pertinente quando un membro agisce in base al contenuto di cui è proprietario se true, applica la valutazione al proprietario del contenuto su cui viene eseguita la azione se false, applica il punteggio all'azione del membro il valore predefinito è false
scoringType	Stringa	optional; identifica il motore di valutazione se "basic", specifica il motore di punteggio in base alla quantità incluso nel rilascio se "advanced", specifica il motore di punteggio in base alla qualità e alla quantità richiede un pacchetto aggiuntivo il valore predefinito è "basic"

Regole di punteggio e regole secondarie incluse

Nella release sono incluse due regole di punteggio per la funzione Forum (una per ciascuna delle componenti Forum e Commenti della funzione Forum):

1. /etc/community/scoring/rules/comments-scoring

   • subRules[] =

     /etc/community/scoring/rules/sub-rules/membro-comment-create

     /etc/community/scoring/rules/sub-rules/Member-receive-vote

     /etc/community/scoring/rules/sub-rules/membro-dare-voto

     /etc/community/scoring/rules/sub-rules/membro-is-moderated

2. /etc/community/scoring/rules/forums-scoring

   • subRules[] =

     /etc/community/scoring/rules/sub-rules/membro-forum-create

     /etc/community/scoring/rules/sub-rules/Member-receive-vote

     /etc/community/scoring/rules/sub-rules/membro-dare-voto

     /etc/community/scoring/rules/sub-rules/membro-is-moderated

Note:

• I nodi rulese sub-rules sono entrambi di tipo cq:Page

• subRulesè un attributo di tipo Stringon [] sul jcr:content nodo della regola

• sub-rules può essere condiviso tra diverse regole di punteggio

• rulesdevono trovarsi in una posizione di repository con l'autorizzazione di lettura per tutti

  • I nomi delle regole devono essere univoci, indipendentemente dalla posizione

Attivazione delle regole di punteggio personalizzate

Eventuali modifiche o aggiunte apportate alle regole di punteggio o alle regole secondarie nell’ambiente di authoring devono essere installate al momento della pubblicazione.

Regole di Badking

Le regole di assegnazione del tag collegano le regole di punteggio ai simboli specificando:

• Regola di punteggio
• Il punteggio necessario per ottenere un contrassegno specifico

Le regole di contrassegno sono nodi di tipo cq:Page con proprietà sul nodo jcr:contentche collegano le regole di punteggio a valutazioni e simboli.

Le regole per il contrassegno consistono in una proprietà obbligatoria thresholdsche è un elenco ordinato di punteggi mappati a simboli. I punteggi devono essere ordinati in valore crescente. Esempio:

• 1|/etc/community/badging/images/bronze-badge/jcr:content/bronze.png

  • Un distintivo di bronzo è stato avvertito per guadagnare 1 punto

• 60|/etc/community/badging/images/silver-badge/jcr:content/silver.png

  • Un distintivo d'argento è assegnato quando 60 punti sono stati accumulati

• 80|/etc/community/badging/images/gold-badge/jcr:content/gold.png

  • Un distintivo d'oro è avvertita quando sono stati accumulati 80 punti

Le regole di Badging sono associate a regole di punteggio, che determinano come si accumulano i punti. Vedere la sezione intitolata Applica regole a contenuto.

La proprietà scoringRulesdi una regola di contrassegno limita semplicemente le regole di punteggio che possono essere associate a quella regola di contrassegno specifica.

Proprietà	Tipo	Valore Descrizione
threshold	Stringa[]	(obbligatorio) Stringa con più valori del formato 'numero|percorso' number = score | = il carattere della linea verticale (U+007C) percorso = percorso completo della risorsa immagine del contrassegno Le stringhe devono essere ordinate in modo che i numeri aumentino in valore e che tra il numero e il percorso non appaia alcuno spazio vuoto. Voce di esempio: 80|/etc/community/badging/images/gold-badge/jcr:content/gold.png
badgingType	Stringa	(facoltativo) Identifica il motore di valutazione come "base" o "avanzato". Se si desidera utilizzare il motore di valutazione avanzato, vedere Advanced Scoring and Badges. Il valore predefinito è "basic".
scoringRules	Stringa[]	(facoltativo) Una stringa multivalore per limitare la regola di contrassegno agli eventi di punteggio identificati dalle regole di punteggio

Regole di Badging incluse

Nella release sono incluse due regole di badging corrispondenti alle regole di punteggio per forum e commenti.

• /etc/community/badging/rules/comments-badging
• /etc/community/badging/rules/forums-badging

Note:

• rules i nodi sono di tipo cq:Page

• rulesdevono trovarsi in una posizione di repository con l'autorizzazione di lettura per tutti

  • I nomi delle regole devono essere univoci, indipendentemente dalla posizione

Attivazione delle regole di badging personalizzate

Eventuali modifiche o aggiunte apportate alle regole di contrassegno o alle immagini nell’ambiente di authoring devono essere installate al momento della pubblicazione.

Assegnazione e revoca dei simboli

I distintivi possono essere assegnati ai membri utilizzando la console dei membri o a livello di programmazione utilizzando i comandi cURL.

I seguenti comandi cURL mostrano quanto è necessario per una richiesta HTTP di assegnazione e revoca dei simboli. Il formato di base è:

cURL -i -X POST -H header -u *signin * -F *operation * -F *badge * membro-profile-url

header = "Accept:application/json"
intestazione personalizzata da trasmettere al server (richiesta)

signin = administrator-id:password
ad esempio: admin:admin

operation = ":operation=social:assignBadge" OPPURE ":operation=social:deleteBadge"

badge = "badgeContentPath=badge-image-file"

badge-image-file = posizione del file di immagine del contrassegno nell’archivio
ad esempio: /etc/community/badging/images/moderator/jcr:content/moderator.png

Member-profile-url = l’endpoint per il profilo del membro al momento della pubblicazione
ad esempio: https://<server>:<porta>/home/users/community/riley/profile.social.json

Esempi:

Assegnazione di un contrassegno moderatore

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" /home/users/community/updcs9DndLEI74DB9zsB/profile.social.json

Revoca un contrassegno argento assegnato

curl -i -X POST -H "Accept:application/json" -u admin:admin -F ":operation=social:deleteBadge" -F "badgeContentPath=/etc/community/badging/images/silver/jcr:content/silver.png" /home/users/community/updcs9DndLEI74DB9zsB/profile.social.json

Punteggio e Badge per componenti personalizzati

Le regole di punteggio e contrassegno possono essere create per i componenti personalizzati associando gli argomenti evento creati per il componente ai verbi.

Argomenti e verbi

Quando i membri interagiscono con le funzionalità delle community, vengono inviati eventi che possono attivare listener asincroni, come notifiche e punteggio.

L'istanza SocialEvent di un componente registra gli eventi come actionsche si verificano per un topic. SocialEvent include un metodo per restituire un elemento verbassociato all'azione. Esiste una relazione n-1 tra actionse verbs.

Per i componenti forniti dalle comunità, le tabelle seguenti descrivono la verbsdefinita per ogni topicdisponibile per l'uso in sub-regole di punteggio.

Calendar
ComponentSocialEvent topic= com/adobe/cq/social/Calendar

Verbo	Descrizione
POST	membro crea un evento del calendario
AGGIUNGI	commenti dei membri su un evento del calendario
AGGIORNA	evento del calendario del membro o commento modificato
ELIMINA	l'evento o il commento del calendario del membro viene eliminato

Commenti
ComponentSocialEvent topic= com/adobe/cq/social/comment

Verbo	Descrizione
POST	crea un commento
AGGIUNGI	risposta del membro al commento
AGGIORNA	commento del membro è stato modificato
ELIMINA	commento del membro è eliminato

Libreria file
ComponentSocialEvent topic= com/adobe/cq/social/fileLibrary

Verbo	Descrizione
POST	create una cartella
ATTACCO	il membro carica un file
AGGIORNA	il membro aggiorna una cartella o un file
ELIMINA	il membro elimina una cartella o un file

Forum
ComponentSocialEvent topic= com/adobe/cq/social/forum

Verbo	Descrizione
POST	membro crea argomento del forum
AGGIUNGI	risposte dei membri all'argomento del forum
AGGIORNA	argomento forum o risposta del membro è modificato
ELIMINA	l'argomento o la risposta del forum del membro viene eliminata

Journal
ComponentSocialEvent topic= com/adobe/cq/social/journal

Verbo	Descrizione
POST	un membro crea un articolo di blog
AGGIUNGI	commenti dei membri su un articolo di blog
AGGIORNA	articolo o commento del blog del membro è stato modificato
ELIMINA	l'articolo o il commento del blog del membro viene eliminato

QnA
ComponentSocialEvent topic = com/adobe/cq/social/qna

Verbo	Descrizione
POST	un membro crea una domanda QnA
AGGIUNGI	un membro crea una risposta QnA
AGGIORNA	la domanda o la risposta QnA del membro viene modificata
SELECT	la risposta del membro è selezionata
ANNULLA	la risposta del membro è deselezionata
ELIMINA	la domanda o la risposta QnA del membro viene eliminata

Recensioni
ComponentSocialEvent topic= com/adobe/cq/social/review

Verbo	Descrizione
POST	il membro crea una revisione
AGGIORNA	revisione membro
ELIMINA	la revisione del membro viene eliminata

Valutazione
ComponentSocialEvent topic= com/adobe/cq/social/tally/rating

Verbo	Descrizione
AGGIUNGI VALUTAZIONE	il contenuto del membro è stato valutato
RIMUOVI VALUTAZIONE	il contenuto del membro non è stato valutato

Voto
ComponentSocialEvent topic= com/adobe/cq/social/tally/Votazione

Verbo	Descrizione
AGGIUNGI VOTO	il contenuto del membro è stato votato
RIMUOVI VOTO	il contenuto del membro è stato respinto

Moderation enabled
ComponentsSocialEvent topic= com/adobe/cq/social/moderation

Verbo	Descrizione
NEGA	contenuto del membro negato
FLAG-AS-INAPPROPRIATE	il contenuto del membro è contrassegnato
INAPPROPRIATO	contenuto del membro non contrassegnato
ACCETTARE	il contenuto del membro è approvato dal moderatore
CHIUDI	il membro chiude il commento alle modifiche e alle risposte
APRI	riapre commento membro

Eventi componenti personalizzati

Per un componente personalizzato, viene creata un'istanza di SocialEvent per registrare gli eventi del componente come actionsche si verificano per un topic.

Per supportare il punteggio, SocialEvent deve sostituire il metodo getVerb() in modo che venga restituito un verbappropriato per ogni action. La verb restituita per un'azione può essere utilizzata comunemente (come POST) o una specifica per il componente (come ADD RATING). Esiste una relazione n-1 tra actionse verbs.

Risoluzione dei problemi

I simboli non vengono visualizzati

Se al contenuto del sito Web sono state applicate regole di punteggio e contrassegno, ma i simboli non vengono avvertiti per alcuna attività, accertatevi che i simboli siano stati abilitati per l'istanza del componente in questione.

Vedere Abilitare i simboli per il componente.

La regola di punteggio non ha alcun effetto

Se al contenuto del sito Web sono state applicate regole di punteggio e contrassegno e i simboli vengono assegnati per alcune azioni, ma non per altre, verificate che la regola di contrassegno non abbia limitato le regole di punteggio a cui si applica.

Vedere la proprietà scoringRulesdi Regole di Badging.

Carattere maiuscolo/minuscolo

La maggior parte delle proprietà e dei valori, in particolare i verbi, sono sensibili alle maiuscole/minuscole. I verbi devono essere tutti UPPERCASE se utilizzati in una regola secondaria di punteggio.

Se la funzione non funziona come previsto, verificare che i dati siano stati immessi correttamente.

Test rapido

È possibile provare rapidamente il punteggio e il contrassegno utilizzando il sito Esercitazione iniziale (interazione):

• Accesso CRXDE Lite all'autore

• Passa alla pagina di base:

  • /content/sites/interazione/it/jcr:content

• Aggiungere la proprietà badgingRules:

  • Nome: badgingRules
  • Tipo: String
  • Selezionare Multi
  • Selezionare Aggiungi
  • Invio /etc/community/badging/rules/forums-badging
  • Seleziona +
  • Invio /etc/community/badging/rules/comments-badging
  • Selezionare OK

• Aggiungere la proprietà scoringRules:

  • Nome: scoringRules
  • Tipo: String
  • Selezionare Multi
  • Selezionare Aggiungi
  • Invio /etc/community/scoring/rules/forums-scoring
  • Seleziona +
  • Invio /etc/community/scoring/rules/comments-scoring
  • Selezionare OK

• Selezionare Salva tutto

Assicuratevi quindi che i componenti forum e commenti consentano la visualizzazione dei simboli:

• Nuovo utilizzo di CRXDE Lite

• Passare al componente forum

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

• Aggiungi la proprietà booleana allowBadges, se necessario, e accertati che sia vera

  • Nome: allowBadges
  • Tipo: Boolean
  • Valore: true

Quindi, ripubblicare il sito della community.

Infine,

• Individuare il componente nell’istanza di pubblicazione

• Accedi come membro della community (ad esempio: weston.mccall@dodgit.com / password)

• Pubblicare un nuovo argomento del forum

• Per visualizzare il contrassegno, è necessario aggiornare la pagina

  • Disconnessione e login come membro della community diverso (ad esempio: aaron.mcdonald@mailinator.com / password)

• Selezionate il forum

Questo dovrebbe far sì che il membro della comunità un distintivo di bronzo visibile con il post del forum a causa della prima soglia della regola di tessitura del forum è un punteggio di 1.

Informazioni aggiuntive

Ulteriori informazioni sono disponibili nella pagina Scoring and Badges Essentials per gli sviluppatori.

Per informazioni sul motore di valutazione avanzato, vedere Advanced Scoring and Badges (Punteggio avanzato e Badge).

La componente e la funzione configurabili semplifica la visualizzazione dei membri e dei loro punteggi su un sito community.