Notions fondamentales relatives à la notation et aux badges scoring-and-badges-essentials

La fonctionnalité de notation et de badges d’AEM Communities identifie et récompense les membres de la communauté.

Les détails de la configuration de la fonctionnalité sont décrits à l’adresse

Cette page contient des détails techniques supplémentaires :

Affichage des badges displaying-badges

Le fait qu’un badge s’affiche ou non en tant que texte ou image est contrôlé côté client dans le modèle HBS.

Par exemple, recherchez this.isAssigned dans /libs/social/forum/components/hbs/topic/list-item.hbs :

{{#each author.badges}}

  {{#if this.isAssigned}}

    <div class="scf-badge-text">

      {{this.title}}

    </div>

  {{/if}}

{{/each}}

{{#each author.badges}}

  {{#unless this.isAssigned}}

    <img class="scf-badge-image" alt="{{this.title}}" title="{{this.title}}" src="{{this.imageUrl}}" />

  {{/unless}}

{{/each}}

Si la valeur est true, isAssigned indique que le badge a été attribué à un rôle et qu’il doit s’afficher sous forme de texte.

Si la valeur est false, isAssigned indique que le badge a été attribué pour un score gagné et qu’il doit s’afficher sous forme d’image.

Toute modification de ce comportement doit être effectuée dans un script personnalisé (remplacement ou recouvrement). Voir Personnalisation côté client.

Journal de débogage pour le score et le badge debug-log-for-scoring-and-badging

Pour aider à déboguer le score et le badge, un fichier journal personnalisé peut être configuré. Le contenu de ce fichier journal peut ensuite être fourni au service clientèle en cas de problème avec la fonctionnalité.

Pour obtenir des instructions détaillées, consultez Créer un fichier journal personnalisé.

Pour configurer rapidement un fichier slinglog :

Pour afficher les entrées de journal :

Contenu créé par l’utilisateur pour la notation et le badge ugc-for-scoring-and-badging

Il est possible d’afficher le contenu créé par l’utilisateur associé à la notation et à la création de badges lorsque le SRP choisi est JSRP ou MSRP, mais pas ASRP. (Si vous ne connaissez pas ces termes, consultez Community Content Storage et Storage Resource Provider Overview.)

Les descriptions d’accès aux données de notation et de badge utilisent JSRP, car le contenu créé par l’utilisateur est facilement accessible à l’aide de 🔗.

JSRP sur l’environnement de création : l’expérimentation dans l’environnement de création aboutit à un contenu créé par l’utilisateur uniquement visible depuis l’environnement de création.

JSRP en mode de publication : de même, en cas de test dans l’environnement de publication, il est nécessaire d’accéder à CRXDE Lite avec les privilèges d’administration sur une instance de publication. Si l’instance de publication est en cours d’exécution en mode de production (mode d’exécution nosamplecontent), il est nécessaire d’activer CRXDE Lite.

L’emplacement de base du contenu créé par l’utilisateur sur JSRP est /content/usergenerated/asi/jcr/.

API de notation et de badge scoring-and-badging-apis

Les API suivantes sont disponibles :

Les derniers Javadocs pour le pack de fonctionnalités installé sont disponibles pour les développeurs à partir du référentiel Adobe. Voir Utilisation de Maven pour Communities : Javadocs.

L’emplacement et le format du contenu créé par l’utilisateur dans le référentiel peuvent être modifiés sans avertissement.

Exemple de configuration example-setup

Les captures d’écran des données du référentiel proviennent de la configuration de la notation et du badge pour un forum sur deux sites AEM différents :

Accéder au contenu créé par l’utilisateur pour la notation access-scoring-ugc

Il est préférable d’utiliser les API.

À des fins d’enquête, en utilisant JSRP par exemple, le dossier de base contenant les notes est

Le nœud enfant de scoring est le nom de la règle de notation. Il est donc recommandé que les noms des règles de score sur un serveur soient uniques dans le monde.

Pour le site Geometrixx Engage, l’utilisateur et sa note se trouvent dans un chemin d’accès construit avec le nom de la règle de note, l’identifiant du site de la communauté ( engage-ba81p), un identifiant unique et l’identifiant de l’utilisateur :

Pour le site du guide Composants de la communauté , l’utilisateur et sa note se trouvent dans un chemin construit avec le nom de la règle de note, un identifiant par défaut ( default-site), un identifiant unique et l’identifiant de l’utilisateur :

Le score est stocké dans la propriété scoreValue_tl qui ne peut contenir qu’une valeur ou faire indirectement référence à un atomicCounter.

Badge d’accès au contenu créé par l’utilisateur access-badging-ugc

Il est préférable d’utiliser les API.

À des fins d’enquête, en utilisant JSRP par exemple, le dossier de base contenant des informations sur les badges attribués est .

Suivi du chemin d’accès au profil de l’utilisateur, se terminant par un dossier de badges, tel que :

Badge attribué awarded-badge

Badge attribué assigned-badge

Informations supplémentaires additional-information

Pour afficher une liste triée de membres en fonction de points :