DocumentazioneAEM 6.4Guida di Communities

Punteggio e badge avanzati advanced-scoring-and-badges

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • Admin
CAUTION
AEM 6.4 ha raggiunto la fine del supporto esteso e questa documentazione non viene più aggiornata. Per maggiori dettagli, consulta la nostra periodi di assistenza tecnica. Trova le versioni supportate qui.

Panoramica overview

Il punteggio avanzato consente di assegnare i badge per identificare i membri come esperti. Il punteggio avanzato assegna punti in base alla quantità e la qualità del contenuto creato da un membro, mentre il punteggio di base assegna i punti semplicemente in base alla quantità di contenuto creata.

Questa differenza è dovuta al motore di valutazione utilizzato per calcolare i punteggi. Il motore di punteggio di base applica una matematica semplice. Il motore di valutazione avanzato è un algoritmo adattivo che premia i membri attivi che contribuiscono a contenuti importanti e valutati, detratti attraverso l’elaborazione delle lingue naturali (NLP) di un argomento.

Oltre alla rilevanza del contenuto, gli algoritmi di punteggio tengono conto delle attività dei membri, come il voto e la percentuale di risposte. Il punteggio di base li include in termini quantitativi, mentre il punteggio avanzato li utilizza in modo algoritmico.

Pertanto, il motore di valutazione avanzato richiede dati sufficienti per rendere significativa l’analisi. La soglia di successo per diventare un esperto viene costantemente rivalutata in quanto l'algoritmo si regola continuamente sul volume e la qualità dei contenuti creati. Esiste anche un concetto di decadimento dei posti più vecchi di un membro. Se un membro esperto smette di partecipare all'oggetto in cui ha ottenuto lo status di esperto, ad un certo punto predeterminato (vedi configurazione del motore di punteggiopotrebbero perdere il loro status di esperto.

L’impostazione del punteggio avanzato è praticamente identica al punteggio di base:

Le differenze nella configurazione delle regole di valutazione e di badging sono le seguenti:

  • Motore di valutazione avanzato configurabile

  • Regole di valutazione avanzate:

    • scoringType impostato su avanzato
    • Richiede parole di arresto

  • Regole di contrassegno avanzate:

    • badgingType impostato su avanzato
    • badgingLevels numero di livelli di esperti da assegnare
    • Richiede badgingPaths array di badge invece delle soglie dei punti di mappatura degli array su badge
NOTE
Per utilizzare le funzionalità avanzate di valutazione e contrassegno, installa la Pacchetto di identificazione degli esperti.

Motore di valutazione configurabile configurable-scoring-engine

Il motore di punteggio avanzato fornisce una configurazione OSGi con parametri che influiscono sull’algoritmo di punteggio avanzato.

chlimage_1-260

  • Pesi del punteggio
    Per un argomento, specifica il verbo a cui deve essere data la priorità più alta durante il calcolo del punteggio. È possibile inserire uno o più argomenti, ma è limitato a un verbo per argomento. Vedi Argomenti e verbi.

    Inserito come topic,verb con la virgola escape. Ad esempio:

    /social/forum/hbs/social/forum\,ADD

    L’impostazione predefinita è impostata sul verbo ADD per i componenti QnA e forum.

  • Intervallo di valutazione

    L’intervallo per i punteggi avanzati è definito da questo valore (punteggio massimo possibile) e da 0 (punteggio più basso possibile.

    Il valore predefinito è 100, quindi l’intervallo di punteggio è compreso tra 0 e 100.

  • Intervallo di tempo decadimento entità

    Questo parametro rappresenta il numero di ore in cui tutti i punteggi dell’entità sono decaduti. Questo è necessario per non includere più i vecchi contenuti nei punteggi di un sito community.

    Il valore predefinito è 216000 ore (~24 anni).

  • Tasso di crescita del punteggio

    Specifica il punteggio. tra 0 e il punteggio, oltre il quale la crescita rallenta per limitare il numero di esperti.

    Il valore predefinito è 50.

Regole di valutazione avanzate advanced-scoring-rules

Nel punteggio di base, è nota la quantità necessaria per ottenere un badge.

Nel punteggio avanzato, la quantità necessaria viene costantemente adattata in base alla quantità di dati di qualità all'interno del sistema. Il punteggio viene continuamente calcolato in modo simile a una curva a campana.

Se un membro ha guadagnato un badge esperto su un argomento che non è più attivo, c'è la possibilità che perderà il loro badge a causa di decadimento nel tempo.

ScoringType scoringtype

Una regola di punteggio è un insieme di regole secondarie di punteggio, ciascuna delle quali dichiara il scoringType.

Per richiamare il motore di punteggio avanzato, il scoringTypedeve essere impostato su advanced.

Vedi Regole di valutazione secondarie.

chlimage_1-261

Punte stopwords

Il pacchetto di valutazione avanzato installa una cartella di configurazione contenente un file di parole chiave:

  • /etc/community/scoring/configuration/stopwords

L’algoritmo di valutazione avanzato utilizza l’elenco di parole contenute nel file stopwords per identificare le parole inglesi comuni che vengono ignorate durante l’elaborazione del contenuto.

Non è previsto che il file venga modificato.

Se il file delle parole chiave è mancante, il motore di punteggio avanzato genererà un errore.

Regole di accesso avanzate advanced-badging-rules

Le proprietà della regola di badging avanzate sono diverse dalle proprietà della regola proprietà della regola di badge di base.

Invece di associare i punti a un’immagine del badge, è necessario solo identificare il numero di esperti consentiti e l’immagine del badge da assegnare.

chlimage_1-262

Proprietà
Tipo
Descrizione valore
badgingPath
Stringa[]
(Obbligatorio) Una stringa con più valori di immagini di badge fino al numero di badgingLevels. I percorsi immagine del badge devono essere ordinati in modo che il primo venga assegnato all’esperto più alto. Se sono presenti meno badge rispetto a quelli indicati da badgingLevels, l’ultimo badge nell’array riempie il resto dell’array. Esempio di voce:/etc/community/badging/images/Expert-badge/jcr:content/expert.png
badgingLevels
Lungo
(Facoltativo) Specifica i livelli di esperienza da assegnare. Ad esempio, se ci devono essere un esperto e un esperto quasi (due badge), il valore deve essere impostato su 2. Il badgingLevel deve corrispondere al numero di immagini del badge relative agli esperti elencate per la proprietà badgingPath . Il valore predefinito è 1.
badgingType
Stringa
(Obbligatorio) Identifica il motore di punteggio come "base" o "avanzato". Imposta su "advanced" altrimenti il valore predefinito è "basic".
scoringRules
Stringa[]
(Facoltativo) Una stringa con più valori per limitare la regola di contrassegno agli eventi di punteggio identificati dalle regole di punteggio elencate.Voce di esempio:/etc/community/scoring/rules/adv-comments-scoringDefault non è una restrizione.

Regole incluse e badge included-rules-and-badge

Badge incluso included-badge

In questa versione beta è incluso un badge di esperti basato su premi:

  • esperto

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

chlimage_1-263

Affinché il badge dell’esperto possa apparire come una ricompensa per l’attività, devono verificarsi due eventi:

  • badges deve essere abilitata per la funzione , ad esempio un forum o un componente QnA
  • le regole avanzate di punteggio e contrassegno devono essere applicate alla pagina (o all’predecessore) in cui è posizionato il componente.

Vedi le informazioni di base per:

Regole di valutazione e sottoregole incluse included-scoring-rules-and-sub-rules

Nella versione beta sono incluse due regole di valutazione avanzate per funzione forum (uno per ciascuno dei componenti forum e commenti della funzione forum):

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

    • subRules[] =

      /etc/community/scoring/rules/sub-rules/adv-comments-rule

      /etc/community/scoring/rules/sub-rules/adv-vote-rule-owner

      /etc/community/scoring/rules/sub-rules/adv-vote rule

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

    • subRules[] =

      /etc/community/scoring/rules/sub-rules/adv-forums-rule

      /etc/community/scoring/rules/sub-rules/adv-comments-rule

      /etc/community/scoring/rules/sub-rules/adv-vote-rule-owner

Note:

  • Entrambi rulese sub-rules nodi di tipo cq:Page
  • subRules è un attributo di tipo String[] sulla regola jcr:content nodo
  • sub-rules può essere condiviso tra diverse regole di punteggio
  • rules devono trovarsi in una posizione archivio con autorizzazione di lettura per tutti
    • i nomi delle regole devono essere univoci indipendentemente dalla posizione

Regole di contrassegno incluse included-badging-rules

Nella versione sono incluse due regole di badging avanzate che corrispondono al regole di valutazione avanzate per forum e commenti.

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

Note:

  • rules nodi di tipo cq:Page
  • rulesdevono trovarsi in una posizione archivio con autorizzazione di lettura per tutti
    • i nomi delle regole devono essere univoci indipendentemente dalla posizione
recommendation-more-help
5d37d7b0-a330-461b-814d-068612705ff6