Notions fondamentales sur la notation et les badges scoring-and-badges-essentials

La fonction Scores et 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 à la section

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

Affichage des badges displaying-badges

Le fait qu’un badge s’affiche sous forme de texte ou d’image est contrôlé du 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é pour un rôle et que le badge 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 que le badge 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 la notation et le badge debug-log-for-scoring-and-badging

Pour aider à déboguer la notation 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èmes liés à la fonctionnalité.

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

Pour configurer rapidement un fichier sling :

Pour afficher les entrées de journal :

Contenu généré par l’utilisateur pour la notation et l’attribution de badges ugc-for-scoring-and-badging

Il est possible d’afficher le contenu généré par l’utilisateur relatif à la notation et à la mise en badge lorsque la priorité de priorité de performance choisie est JSRP ou MSRP, mais pas ASRP. (Si ces termes ne sont pas familiers, reportez-vous aux sections Stockage de contenu de la communauté et Présentation du fournisseur de ressources de stockage.)

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 CRXDE Lite.

JSRP sur author : l’expérimentation dans l’environnement de création génère un contenu généré par l’utilisateur qui n’est visible que depuis l’environnement de création.

JSRP sur publish : de même, si vous testez sur l’environnement de publication, il est nécessaire d’accéder au CRXDE Lite avec des privilèges d’administrateur sur une instance de publication. Si l’instance de publication s’exécute en mode de production (mode d’exécution nosamplecontent), il est nécessaire d’activer CRXDE Lite.

L’emplacement de base du contenu généré 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 Feature Pack 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 généré 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 de la mise en badge pour un forum sur deux sites AEM différents :

Accès au contenu généré par l’utilisateur de notation access-scoring-ugc

L’utilisation des APIs est préférée.

À des fins d’enquête, à l’aide de JSRP pour l’exemple, le dossier de base contenant les scores est

Le noeud enfant de scoring est le nom de la règle de notation. Par conséquent, il est recommandé que les noms des règles de notation sur un serveur soient uniques globalement.

Pour le site Engage, l’utilisateur et son score se trouvent dans un chemin construit avec le nom de la règle de notation, l’identifiant du site de la communauté ( engage-ba81p), un identifiant unique et l’identifiant de l’utilisateur :

Pour le site du guide des composants de la communauté, l’utilisateur et son score se trouvent dans un chemin construit avec le nom de la règle de notation, 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.

Contrôle d’accès UGC de badge access-badging-ugc

L’utilisation des APIs est préférée.

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

Suivi du chemin d’accès au profil de l’utilisateur, qui se termine 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 des membres en fonction des points :