Show Menu
SUJETS×

Scores et insignes essentiels

La fonction de notation et de badges des communautés AEM permet d’identifier et de récompenser les membres de la communauté.
Les détails de la configuration de la fonctionnalité sont décrits dans la section
Cette page contient des détails techniques supplémentaires :
La structure d’implémentation visible dans CRXDE Lite peut être modifiée.

Affichage des badges

Le contrôle d’un badge affiché sous forme de texte ou d’image côté client dans le modèle HBS est activé.
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é affecté à un rôle et que le badge doit être affiché sous forme de texte.
Si la valeur est false, est Attribué indique que le badge a été attribué pour un score gagné et que le badge doit être affiché sous forme d’image.
Toute modification de ce comportement doit être apportée dans un script personnalisé (remplacement ou recouvrement). Voir Personnalisation côté client.

Journal de débogage pour le score et le badge

Pour faciliter le débogage du score et du badge, il est possible de configurer un fichier journal personnalisé. Le contenu de ce fichier journal peut alors être fourni au service clientèle en cas de problème avec la fonctionnalité.
Pour obtenir des instructions détaillées, consultez Création d’un fichier journal personnalisé.
Pour configurer rapidement un fichier slinglog :
  1. Accédez à la prise en charge du journal de la console Web Adobe Experience Manager, par exemple
    • https://localhost:4502/system/console/slinglog
  2. Sélectionner Ajouter nouvelle journalisation
    1. Sélectionner DEBUG pour le niveau journal
    2. Entrez un nom pour le fichier ​journal, par exemple
      • logs/scoring-debug.log
    3. Entrez deux entrées de journal (classe) (à l’aide de l’ + icône)
      • com.adobe.cq.social.scoring
      • com.adobe.cq.social.badging
    4. Sélectionnez Enregistrer
Pour afficher les entrées de journal :
  • Depuis la console Web
    • Sous le menu État
    • Sélectionner les fichiers journaux
    • Recherchez le nom du fichier journal, tel que scoring-debug
  • Sur le disque local du serveur
    • Le fichier journal se trouve sous < server-install-dir >/crx-quickstart/logs/< log-file-name >.log
    • Par exemple, .../crx-quickstart/logs/scoring-debug.log

UGC pour le score et le badge

Il est possible de de l'UGC en ce qui concerne la notation et la notation lorsque le SRP choisi est soit JSRP, soit MSRP, mais pas ASRP. (Si vous ne connaissez pas ces termes, reportez-vous à la section Présentation du fournisseur de ressources de de la de la de la Communauté et.)
Les descriptions d’accès aux données de score et de badge utilisent JSRP, car l’UGC est facilement accessible à l’aide de CRXDE Lite .
JSRP sur l'auteur : expérimenter dans l'auteur le donne un UGC qui n'est visible que de l'auteur le.
JSRP lors de la publication : de même, si vous testez sur le de publication , il sera nécessaire d’accéder à CRXDE Lite avec des droits 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 sera nécessaire d’ activer CRXDE Lite .
L’emplacement de base de l’UGC sur JSRP est /content/usergenerated/asi/jcr/ .

API de score et de badge

Les API suivantes peuvent être utilisées :
Les derniers Javadocs pour le Feature Pack installé sont accessibles aux développeurs à partir du référentiel Adobe. Voir Utilisation de Maven pour les communautés : Javadocs .
L’emplacement et le format de l’UGC 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 du score et du badge pour 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 Didacticiel de prise en main (engager) créé pendant le didacticiel de prise en main
    • Localisation du noeud de la page du forum
      /content/sites/engage/en/forum/jcr:content
    • Ajouter des propriétés d’évaluation et de mise en 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]
    
    
    • Localisation du noeud du composant de forum
      /content/sites/engage/en/forum/jcr:content/content/primary/forum ( sling:resourceType = social/forum/components/hbs/forum )
    • Ajouter propriété d’affichage des badges
      allowBadges = true
    • Un utilisateur se connecte, crée un sujet de forum et reçoit un badge de bronze
  2. Un site AEM sans ID unique :
    • Utilisation du guide des composants de la communauté
    • Localisation du noeud de la page du forum
      /content/community-components/en/forum/jcr:content
    • Ajouter des propriétés d’évaluation et de mise en 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]
    
    
    • Localisation du noeud du composant de forum
      /content/community-components/en/forum/jcr:content/content/forum ( sling:resourceType = social/forum/components/hbs/forum )
    • Ajouter propriété d’affichage des badges
      allowBadges = true
    • Un utilisateur se connecte, crée un sujet de forum et reçoit un badge de 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" https://localhost:4503/home/users/community/w271OOup2Z4DjnOQrviv/profile.social.json
    
    
    Comme un utilisateur a obtenu deux badges en bronze et qu’il a reçu un badge de modérateur, c’est ainsi que l’utilisateur apparaît avec son entrée sur le forum.
Cet exemple ne suit pas les bonnes pratiques suivantes :
  • Les noms des règles de score doivent être uniques au niveau mondial ; ils ne doivent pas se terminer par le même nom. Voici un exemple de ce que ne pas faire : /etc/community/score/rule/site1/forums-score /etc/community/score/rule/site2/forums-score
  • Création d’images de badge uniques pour différents sites AEM

Accès au score UGC

Il est préférable d’utiliser les API .
À 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
Le noeud enfant de scoring est le nom de la règle de notation. Il est donc recommandé que les noms des règles de notation sur un serveur soient globalement uniques.
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 de guide 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 ID unique et l’ID de l’utilisateur :
  • .../scoring/forums-scoring/default-site/b27a17cb4910a9b69fe81fb1b492ba672d2c086e/riley
Le score est stocké dans la propriété scoreValue_tl qui peut directement contenir uniquement une valeur ou indirectement faire référence à un atomicCounter.

Insigne d'accès UGC

Il est préférable d’utiliser les API .
À des fins d’enquête, à l’aide de JSRP, par 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 du de l’utilisateur, qui se termine par un dossier de badges, tel que
  • /home/users/community/w271OOup2Z4DjnOQrviv/profile/badges

Badge décerné

Badge attribué

Informations supplémentaires

Pour afficher un trié de membres en fonction des points :
  • Fonction du tableau de bord pour l’inclusion dans un site communautaire ou un modèle de groupe.
  • Composant de classement, composant incitatif de la fonction de classement, pour la création de pages.