DokumentationAEM 6.5Communities-Anleitung

Erweiterte Scoring- und Badges advanced-scoring-and-badges

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Erstellt für:

  • Admin

Überblick overview

Die erweiterte Bewertung ermöglicht die Vergabe von Abzeichen, um Mitglieder als Experten zu identifizieren. Bei der erweiterten Bewertung werden Punkte basierend auf der von einem Mitglied erstellten Menge und der Qualität des Inhalts zugewiesen, während bei der einfachen Auswertung Punkte basierend auf der erstellten Inhaltsmenge zugewiesen werden.

Dieser Unterschied beruht auf der Scoring-Engine, die zur Berechnung der Werte verwendet wird. Die grundlegende Scoring-Engine wendet einfache Mathematik an. Die erweiterte Scoring-Engine ist ein adaptiver Algorithmus, der aktive Mitglieder belohnt, die wertvolle und relevante Inhalte beisteuern, die durch die natürliche Sprachverarbeitung (NLP) eines Themas abgeleitet werden.

Zusätzlich zur Inhaltsrelevanz berücksichtigen die Scoring-Algorithmen Mitgliederaktivitäten, wie z. B. Stimmabgabe und Prozentsatz der Antworten. Während die grundlegende Bewertung sie quantitativ beinhaltet, verwendet die erweiterte Auswertung sie algorithmisch.

Daher benötigt die erweiterte Scoring-Engine genügend Daten, um die Analyse sinnvoll zu gestalten. Die Erfolgsschwelle für die Expertenaktivität wird ständig neu bewertet, da sich der Algorithmus kontinuierlich an die Menge und Qualität der erstellten Inhalte anpasst. Es gibt auch ein Konzept für den Verfall älterer Beiträge eines Mitglieds. Wenn ein Expertenmitglied nicht mehr an der Materie teilnimmt, in der er einen Expertenstatus erlangt hat, könnte es an einem bestimmten Punkt (siehe Konfiguration der Scoring-Engine 🔗) seinen Status als Experte verlieren.

Die Einrichtung der erweiterten Auswertung ist praktisch identisch mit der grundlegenden Auswertung:

Bei der Einrichtung der Scoring- und Badging-Regeln gibt es folgende Unterschiede:

  • Konfigurierbare erweiterte Scoring-Engine

  • Erweiterte Scoring-Regeln:

    • scoringType ist auf advanced festgelegt
    • Erfordert stopwords

  • Erweiterte Badging-Regeln:

    • badgingType ist auf advanced festgelegt
    • badgingLevels auf Anzahl der zu vergebenden Expertenebenen gesetzt
    • Erfordert ein badgingPaths-Array von Badges anstelle von Schwellenwerten für die Array-Zuordnung zu Badges.
NOTE
Um erweiterte Scoring- und Badging-Funktionen zu verwenden, installieren Sie das Paket Expertenerkennung.

Konfigurierbare Scoring-Engine configurable-scoring-engine

Die erweiterte Scoring-Engine bietet eine OSGi-Konfiguration mit Parametern, die sich auf den erweiterten Scoring-Algorithmus auswirken.

advanced-scoring-engine

  • Scoring-Gewichtungen

    Geben Sie für ein Thema das Verb an, dem bei der Berechnung des Ergebnisses die höchste Priorität eingeräumt werden soll. Es können ein oder mehrere Themen eingegeben werden, jedoch auf ein Verb pro Thema beschränkt. Siehe Themen und Verben.
    Wird als topic,verb eingegeben, wobei das Komma maskiert ist. Zum Beispiel:
    /social/forum/hbs/social/forum\,ADD
    Standardmäßig ist das ADD-Verb für QnA- und Forenkomponenten festgelegt.

  • Scoring-Bereich

    Der Bereich für erweiterte Bewertungen wird durch diesen Wert (Höchstwert) und 0 (kleinstmögliche Punktzahl) definiert.

    Der Standardwert ist 100, sodass der Scoring-Bereich zwischen 0 und 100 liegt.

  • Zeitintervall des Entitätsverfalls

    Dieser Parameter stellt die Anzahl der Stunden dar, nach denen alle Entitätsbewertungen veraltet sind. Dies ist erforderlich, um alte Inhalte nicht mehr in Bewertungen für eine Community-Site aufzunehmen.

    Der Standardwert ist 216000 Stunden (~24 Jahre).

  • Scoring-Wachstumsrate
    Dies gibt den Wert zwischen dem 0-Scoring-Bereich an, über den das Wachstum hinausgeht und die Anzahl der Experten begrenzt.

    Der Standardwert ist 50.

Erweiterte Scoring-Regeln advanced-scoring-rules

Bei der grundlegenden Bewertung ist die zum Verdienen eines Abzeichens erforderliche Menge bekannt.

Bei der erweiterten Auswertung wird die benötigte Menge ständig angepasst, basierend auf der Menge an Qualitätsdaten innerhalb des Systems. Die Auswertung wird kontinuierlich so berechnet, dass sie einer Glockenkurve ähnelt.

Wenn ein Mitglied ein Expertenabzeichen für ein Thema erhält, das nicht mehr aktiv ist, besteht die Möglichkeit, dass es aufgrund des Verfalls im Laufe der Zeit sein Abzeichen verliert.

scoringType scoringtype

Eine Scoring-Regel ist ein Satz von Scoring-Unterregeln, von denen jede die scoringType deklariert.

Um die erweiterte Scoring-Engine aufzurufen, sollte scoringTypeauf advanced gesetzt werden.

Siehe Scoring-Unterregeln.

advanced-scoring-type

Stoppwörter stopwords

Das erweiterte Scoring-Paket installiert einen Konfigurationsordner, der eine stopwords -Datei enthält:

  • /libs/settings/community/scoring/configuration/stopwords

Der erweiterte Scoring-Algorithmus verwendet die Liste der in der Stoppwörter-Datei enthaltenen Wörter, um häufig verwendete englische Wörter zu identifizieren, die bei der Inhaltsverarbeitung ignoriert werden.

Es ist nicht zu erwarten, dass diese Datei geändert wird.

Wenn die Stoppwortdatei fehlt, erzeugt die erweiterte Scoring-Engine einen Fehler.

Erweiterte Badging-Regeln advanced-badging-rules

Die Eigenschaften der erweiterten Badging-Regel unterscheiden sich von den Eigenschaften der einfachen Badging-Regel.

Anstatt Punkte mit einem Badge-Bild zu verknüpfen, ist es nur erforderlich, die Anzahl der zulässigen Experten und das zu vergebende Badge-Bild zu identifizieren.

advanced-badging-rules

Eigenschaft
Typ
Wertbeschreibung
badgingPath
Zeichenfolge[]
(Erforderlich) Eine mehrwertige Zeichenfolge von Badge-Bildern bis zur Anzahl der badgingLevels. Die Badge-Bildpfade müssen so angeordnet sein, dass der erste an den höchsten Fachmann vergeben wird. Wenn weniger Abzeichen vorhanden sind, als durch badgingLevels angegeben, füllt das letzte Abzeichen im Array den Rest des Arrays aus. Beispieleintrag:
/libs/settings/community/badging/images/expert-badge/jcr:content/expert.png
badgingLevels
Long
(Optional) Gibt den Umfang des zu vergebenden Fachwissens an. Wenn beispielsweise expert und almost expert (zwei Abzeichen) vorhanden sein sollen, sollte der Wert auf 2 gesetzt werden. BadgingLevel sollte mit der Anzahl der von Experten verwendeten Badge-Bilder übereinstimmen, die für die badgingPath -Eigenschaft aufgelistet sind. Der Standardwert ist 1.
badgingType
Zeichenfolge
(Erforderlich) Identifiziert die Scoring-Engine entweder als "Standard"oder als "erweitert". Auf "Erweitert"gesetzt, andernfalls ist der Standardwert "Einfach".
scoringRules
Zeichenfolge[]
(Optional) Eine mehrwertige Zeichenfolge, die die Badging-Regel auf die Auswertung von Ereignissen beschränkt, die durch eine oder mehrere aufgelistete Scoring-Regeln identifiziert wurden.
Beispieleintrag:
/libs/settings/community/scoring/rules/adv-comments-scoring
Der Standardwert ist keine Einschränkung.

Einbezogene Regeln und Zeichen included-rules-and-badge

Include Badge included-badge

Diese Beta-Version beinhaltet ein belohnungsbasiertes Expertenabzeichen:

  • expert

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

experte-badge

Damit das Expertenabzeichen als Belohnung für Aktivitäten angezeigt wird, stellen Sie Folgendes sicher:

  • Badges sind für die Funktion aktiviert, z. B. für ein Forum oder eine QnA-Komponente.

  • Erweiterte Scoring- und Badging-Regeln werden auf die Seite (oder den Vorgänger) angewendet, auf der die Komponente platziert wird

Siehe Grundlegende Informationen für:

Einbezogene Scoring-Regeln und Unterregeln included-scoring-rules-and-sub-rules

In der Beta-Version sind zwei erweiterte Scoring-Regeln für die Forumsfunktion enthalten (jeweils eine für die Foren- und Kommentarkomponenten der Forumsfunktion):

  1. /libs/settings/community/scoring/rules/adv-comments-scoring

    code language-none 
    subRules[] =
/libs/settings/community/scoring/rules/sub-rules/adv-comments-rule
/libs/settings/community/scoring/rules/sub-rules/adv-voting-rule-owner
/libs/settings/community/scoring/rules/sub-rules/adv-voting-rule

  2. /libs/settings/community/scoring/rules/adv-forums-scoring

    code language-none 
    subRules[] =
/libs/settings/community/scoring/rules/sub-rules/adv-forums-rule
/libs/settings/community/scoring/rules/sub-rules/adv-comments-rule
/libs/settings/community/scoring/rules/sub-rules/adv-voting-rule-owner

Anmerkungen:

  • Die Knoten rules und sub-rules weisen den Typ cq:Page auf.
  • subRules ist ein Attribut vom Typ String[] im Knoten jcr:content der Regel.
  • sub-rules kann von verschiedenen Scoring-Regeln gemeinsam genutzt werden.
  • rules sollte sich an einem Repository-Speicherort befinden, der für alle Leserechte besitzt.
  • Regelnamen müssen unabhängig vom Speicherort eindeutig sein.

Einbezogene Badging-Regeln included-badging-rules

In der Version sind zwei erweiterte Badging-Regeln enthalten, die den erweiterten Foren und Kommentar-Scoring-Regeln entsprechen.

  • /libs/settings/community/badging/rules/adv-comments-badging
  • /libs/settings/community/badging/rules/adv-forums-badging

Anmerkungen:

  • rules -Knoten weisen den Typ cq:Page auf.
  • rules sollte sich an einem Repository-Speicherort befinden, der für alle Leserechte besitzt.
  • Regelnamen müssen unabhängig vom Speicherort eindeutig sein.
recommendation-more-help
81e2cd9d-0789-409d-b87c-2a8ce4f28791