DocumentationAEM 6.5Guide de Communities

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

Last update: Wed Nov 15 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Créé pour :

  • Admin

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 quantité et qualité du contenu créé par un membre, tandis que la notation de base attribue des points en fonction de la quantité de contenu créé.

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 : atténuation des anciennes publications d’un membre. Si un membre d’un expert cesse de participer à un domaine dans lequel il a acquis un statut d’expert, à un moment déterminé (voir configuration du moteur de notation) ils pourraient perdre leur 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 postes d'experts à attribuer
    • Nécessite badgingPaths tableau de badges au lieu de seuils table-mapping points vers badges.
NOTE
Pour utiliser les fonctionnalités avancées de notation et de badge, installez le Package d’identification expert.

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 saisies, mais limitées à un verbe par rubrique. Voir Rubriques et verbes.
    Entré comme topic,verb avec la virgule placée dans une séquence d’échappement. 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 des entités

    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 la variable scoringType.

Pour appeler le moteur de notation avancé, la méthode scoringTypedoit ê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 de la règle de badge diffèrent de celles de propriétés de règle de badge de base.

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, si une variable expert et un almost expert (deux badges), alors 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 est sans 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

badge dexpert

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

  • Badges sont activés pour la fonctionnalité, comme 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 variable fonction de forum (un pour les composants forum et commentaires de la fonction 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 deux rules et sub-rules les noeuds sont de type cq:Page.
  • subRules est un attribut de type String[] sur la règle jcr:content noeud .
  • sub-rules peut être partagée 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ées qui correspondent au forums avancés et règles de notation des commentaires.

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

Remarques:

  • rules Les 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