DocumentationAEM 6.5Guide de Communities

Notation et badges avancés advanced-scoring-and-badges

Last update: Sun Jul 14 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Créé pour :

  • Administration

Vue d’ensemble overview

La notation avancée permet l’attribution de badges afin d’identifier les membres en tant qu’experts. La notation avancée attribue des points en fonction de la qualité de contenu et créée par un membre, tandis que la notation de base affecte des points en fonction de la quantité de contenu créée.

Cette différence est due au moteur de notation utilisé pour calculer les scores. Le moteur de notation de base applique des maths simples. Le moteur de notation avancé est un algorithme adaptatif qui récompense les membres actifs qui apportent du contenu utile et pertinent, déduit par le traitement du langage naturel (NLP) d’un sujet.

Outre la pertinence du contenu, les algorithmes de notation tiennent compte des activités des membres, telles que le vote et le pourcentage de réponses. Bien que la notation de base les inclut quantitativement, la notation avancée les utilise de manière algorithmique.

Par conséquent, le moteur de notation avancé nécessite suffisamment de données pour que l’analyse ait du sens. Le seuil de réussite pour devenir un expert est constamment réévalué à mesure que l’algorithme s’ajuste continuellement au volume et à la qualité du contenu créé. Il existe également un concept de décomposition des anciennes publications d’un membre. Si un membre expert cesse de participer au sujet sur lequel il a acquis un statut d’expert, à un moment prédéterminé (voir configuration du moteur de notation), il risque de perdre son statut d’expert.

La configuration d’une notation avancée est pratiquement identique à la notation de base :

Les différences de configuration des règles de notation et de badge sont les suivantes :

  • Moteur de notation avancé configurable

  • Règles de notation avancées :

    • scoringType défini sur advanced
    • Requiert stopwords

  • Règles de badge avancées :

    • badgingType défini sur advanced
    • badgingLevels défini sur nombre de niveaux d'experts à attribuer
    • Nécessite badgingPaths tableau de badges au lieu de seuils tableau-mapping points vers badges.
NOTE
Pour utiliser les fonctionnalités avancées de notation et de badge, installez le package d’identification d’experts.

Moteur de notation configurable configurable-scoring-engine

Le moteur de notation avancé fournit une configuration OSGi avec des paramètres qui affectent l’algorithme de notation avancé.

advanced-scoring-engine

  • Poids de notation

    Pour une rubrique, spécifiez le verbe qui doit avoir la priorité la plus élevée lors du calcul du score. Une ou plusieurs rubriques peuvent être entrées, mais limitées à un verbe par rubrique. Voir Rubriques et verbes.
    Saisissez comme topic,verb avec la virgule échappée. Par exemple :
    /social/forum/hbs/social/forum\,ADD
    La valeur par défaut est définie sur le verbe AJOUTER pour les composants Q&R et de forum.

  • Plage de notation

    La plage des scores avancés est définie par cette valeur (note maximale) et 0 (note la plus basse possible).

    La valeur par défaut est 100, de sorte que la plage de notation est comprise entre 0 et 100.

  • Intervalle de délai de décomposition d’entité

    Ce paramètre représente le nombre d’heures après lesquelles tous les scores de l’entité sont décalés. Cela est nécessaire pour ne plus inclure d’anciens contenus dans les scores d’un site de communauté.

    La valeur par défaut est de 216000 heures (~24 ans).

  • Taux de croissance du score
    Cela permet d’indiquer un score compris entre 0 et 0, au-delà duquel la croissance ralentit pour limiter le nombre d’experts.

    La valeur par défaut est 50.

Règles de notation avancées advanced-scoring-rules

Dans la notation de base, la quantité nécessaire pour gagner un badge est connue.

Dans la notation avancée, la quantité nécessaire est constamment ajustée en fonction de la quantité de données de qualité dans le système. La notation est calculée en permanence d’une manière semblable à une courbe en cloche.

Si un membre a obtenu un badge d'expert sur un sujet qui n'est plus actif, il est possible qu'il perde son badge à cause d'une dégradation au fil du temps.

scoringType scoringtype

Une règle de notation est un ensemble de sous-règles de notation, dont chacune déclare le scoringType.

Pour appeler le moteur de notation avancé, scoringType doit être défini sur advanced.

Voir Sous-règles de notation.

advanced-scoring-type

Stopwords stopwords

Le module de notation avancée installe un dossier de configuration contenant un fichier de mots-clés :

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

L’algorithme de notation avancée utilise la liste des mots contenus dans le fichier stopwords pour identifier les mots anglais courants qui sont ignorés pendant le traitement du contenu.

Il n’est pas prévu que ce fichier soit modifié.

Si le fichier des mots-clés est manquant, le moteur de notation avancé renvoie une erreur.

Règles de badge avancées advanced-badging-rules

Les propriétés avancées des règles de badge diffèrent des propriétés de base des règles de badge.

Au lieu d'associer des points à une image de badge, il suffit d'identifier le nombre d'experts autorisés et l'image de badge à attribuer.

advanced-badging-rules

Propriété
Type
Valeur Description
badgingPath
Chaîne[]
(Obligatoire) Chaîne à plusieurs valeurs d’images de badge jusqu’au nombre de badgingLelevels. Les chemins des images du badge doivent être triés afin que le premier soit attribué au plus haut expert. S’il y a moins de badges qu’indiqué par badgingLelevels, le dernier badge du tableau remplit le reste du tableau. Exemple d’entrée :
/libs/settings/community/badging/images/expert-badge/jcr:content/expert.png
badgingLelevels
Long
(Facultatif) Indique les niveaux d’expertise à attribuer. Par exemple, s’il doit y avoir un expert et un almost expert (deux badges), la valeur doit être définie sur 2. Le badgingLevel doit correspondre au nombre d’images de badge associées à un expert répertoriées pour la propriété badgingPath. La valeur par défaut est 1.
badgingType
Chaîne
(Obligatoire) Identifie le moteur de notation comme "de base" ou "avancé". Défini sur "advanced" sinon la valeur par défaut est "basic".
scoringRules
Chaîne[]
(Facultatif) Chaîne à plusieurs valeurs permettant de limiter la règle de badge aux événements de notation identifiés par une ou plusieurs règles de notation répertoriées.
Exemple d’entrée :
/libs/settings/community/scoring/rules/adv-comments-scoring
La valeur par défaut n’est pas une restriction.

Règles et badge inclus included-rules-and-badge

Badge inclus included-badge

Dans cette version bêta, un badge d’expert basé sur les récompenses est inclus :

  • expert

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

expert-badge

Pour que le badge d'expert apparaisse comme une récompense pour l'activité, veillez à :

  • Badges sont activés pour la fonctionnalité, par exemple un forum ou un composant Q&R.

  • Les règles de notation et de badge avancées sont appliquées à la page (ou ancêtre) sur laquelle le composant est placé.

Consultez les informations de base pour :

Règles de notation et sous-règles incluses included-scoring-rules-and-sub-rules

La version bêta comprend deux règles de notation avancées pour la fonction de forum (une pour les composants forum et commentaires de la fonctionnalité de forum) :

  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

Remarques:

  • Les noeuds rules et sub-rules sont de type cq:Page.
  • subRules est un attribut de type String[] sur le noeud jcr:content de la règle.
  • sub-rules peut être partagé entre différentes règles de notation.
  • rules doit se trouver dans un emplacement de référentiel avec une autorisation de lecture pour tout le monde.
  • Les noms des règles doivent être uniques, quel que soit leur emplacement.

Règles de badge incluses included-badging-rules

Cette version comprend deux règles de badge avancé qui correspondent aux forums avancés et auxrègles de notation des commentaires.

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

Remarques:

  • rules noeuds sont de type cq:Page.
  • rules doit se trouver dans un emplacement de référentiel avec une autorisation de lecture pour tout le monde.
  • Les noms des règles doivent être uniques, quel que soit leur emplacement.
recommendation-more-help
81e2cd9d-0789-409d-b87c-2a8ce4f28791