Notions fondamentales sur la notation et les badges

La fonction Scores et badges d’AEM Communities permet d’identifier et de récompenser 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 :

ATTENTION

La structure d’implémentation visible dans CRXDE Lite peut faire l’objet de modifications.

Affichage des 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 in /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, l’attribut est attribué pour un score gagné et 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

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 Création d’un fichier journal personnalisé.

Pour configurer rapidement un fichier sling :

  1. Accédez au Prise en charge des journaux de la console web Adobe Experience Manager, par exemple

    • http://localhost:4502/system/console/slinglog
  2. Sélectionner Ajouter un nouvel enregistreur

    1. Sélectionner DEBUG pour Niveau de journal

    2. Saisissez un nom pour Fichier journal, par exemple

      • logs/scoring-debug.log
    3. Saisissez deux Enregistreur entrées (classe) (à l’aide de + icon)

      • com.adobe.cq.social.scoring
      • com.adobe.cq.social.badging
    4. Sélectionnez Enregistrer

chlimage_1-248

Pour afficher les entrées de journal :

  • À partir de la console Web

    • Sous , État menu
    • Sélectionner Fichiers journaux
    • Recherchez votre nom de fichier journal, par exemple scoring-debug
  • Sur le disque local du serveur

    • Le fichier journal se trouve à l’emplacement <server-install-dir>/crx-quickstart/logs/<log-file-name>.log
    • Par exemple, .../crx-quickstart/logs/scoring-debug.log

chlimage_1-249

Contenu généré par l’utilisateur pour la notation et l’attribution de badges

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 vous ne connaissez pas ces termes, reportez-vous à la section Stockage de contenu communautaire 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 l’auteur: l’expérimentation dans l’environnement de création génère un contenu créé par l’utilisateur qui n’est visible que depuis l’environnement de création.

JSRP sur publication: de même, si vous effectuez un test sur l’environnement de publication, il sera nécessaire d’accéder à CRXDE Lite avec des privilèges d’administrateur sur une instance de publication. Si l’instance de publication est en cours d’exécution dans mode de production (mode d’exécution nosamplecontent), il est nécessaire de activer le 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

Les API suivantes sont disponibles :

Les derniers JavaDocs pour le versions 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

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

  1. Un site AEM avec un identifiant unique (site de la communauté créé à l’aide de l’assistant) :

    • Utilisation du site de tutoriel de prise en main créé lors de la tutoriel de prise en main

    • Localisez le noeud de page du forum

      • /content/sites/engage/en/forum/jcr:content
    • Ajout de propriétés de notation et de badge

      • scoringRules = [/etc/community/scoring/rules/comments-scoring,

        /etc/community/scoring/rules/forums-scoring]

      • badgingRules =[/etc/community/badging/rules/comments-scoring,

        /etc/community/badging/rules/forums-scoring]

    • Localisez le noeud du composant de forum

      • /content/sites/engage/en/forum/jcr:content/content/primary/forum

        ( sling:resourceType = social/forum/components/hbs/forum)

    • Ajouter une propriété pour afficher les badges

      • allowBadges = true
    • Un utilisateur se connecte, crée un sujet de forum et se voit attribuer un badge bronze

  2. Un site AEM without un identifiant unique :

    • En utilisant la variable Guide des composants de communauté

    • Localisez le noeud de page du forum

      • /content/community-components/en/forum/jcr:content
    • Ajout de propriétés de notation et de badge

      scoringRules = [/etc/community/scoring/rules/comments-scoring,
      /etc/community/scoring/rules/forums-scoring]
      
      badgingRules =[/etc/community/badging/rules/comments-scoring,
      /etc/community/badging/rules/forums-scoring]
      
    • Localisez le noeud du composant de forum

      • /content/community-components/en/forum/jcr:content/content/forum

        ( sling:resourceType = social/forum/components/hbs/forum)

    • Ajouter une propriété pour afficher les badges

      • allowBadges = true
    • Un utilisateur se connecte, crée un sujet de forum et se voit attribuer un badge bronze

  3. Un badge de modérateur est attribué à un utilisateur à l’aide de cURL :

curl -i -X POST -H "Accept:application/json" -u admin:admin -F ":operation=social:assignBadge" -F "badgeContentPath=/etc/community/badging/images/moderator/jcr:content/moderator.png" http://localhost:4503/home/users/community/w271OOup2Z4DjnOQrviv/profile.social.json

Un utilisateur ayant obtenu deux badges en bronze et se voyant attribuer un badge de modérateur, voici comment il apparaît avec son entrée de forum :

chlimage_1-250

REMARQUE

Cet exemple ne suit pas les bonnes pratiques suivantes :

  • les noms des règles de notation doivent être uniques au niveau global ; ils ne doivent pas se terminer par le même nom.
    Exemple de ce qui suit : not pour effectuer :
    /etc/community/scoring/rules/site1/forums-scoring
    /etc/community/scoring/rules/site2/forums-scoring

  • création d’images de badge uniques pour différents sites AEM

Accès au contenu généré par l’utilisateur de notation

Utilisation de la variable API est préférable.

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

  • /content/usergenerated/asi/jcr/scoring

Noeud enfant de scoringest 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 Geometrixx 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 :

  • .../scoring/forums-scoring/engage-ba81p/6d179715c0e93cb2b20886aa0434ca9b5a540401/riley

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 id par défaut ( default-site), un identifiant unique et l’identifiant de l’utilisateur :

  • .../scoring/forums-scoring/default-site/b27a17cb4910a9b69fe81fb1b492ba672d2c086e/riley

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

chlimage_1-251

Contrôle d’accès UGC

Utilisation de la variable API est préférable.

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

  • /content/usergenerated/asi/jcr

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

  • /home/users/community/w271OOup2Z4DjnOQrviv/profile/badges

Badge attribué

chlimage_1-252

badge attribué

chlimage_1-253

Informations supplémentaires

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

Sur cette page