评分和徽章要点 scoring-and-badges-essentials

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

主题：
社区

创建对象：

用户

CAUTION

AEM 6.4已结束扩展支持，本文档将不再更新。有关更多详细信息，请参阅技术支助期. 查找支持的版本此处.

AEM Communities评分和徽章功能提供了识别和奖励社区成员的功能。

有关设置该功能的详细信息，请参阅

社区评分和徽章

本页包含其他技术详细信息：

操作方法显示标记图像或文本
如何打开广泛功能调试日志记录
操作方法访问UGC 与评分和徽章有关

CAUTION

CRXDE Lite中可见的实施结构可能会发生更改。

显示徽章 displaying-badges

在HBS模板的客户端上，将控制徽章显示为文本还是图像。

例如，搜索 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}}

如果为true，则isAssigned表示已为角色分配标记，该标记应显示为文本。

如果为false，则为“已分配”表示已为应得分授予徽章，且徽章应显示为图像。

对此行为所做的任何更改都应在自定义脚本中进行（覆盖或叠加）。请参阅客户端自定义.

调试日志以进行评分和标记 debug-log-for-scoring-and-badging

为帮助调试评分和标记，可以设置自定义日志文件。如果该功能遇到问题，可向客户支持提供此日志文件的内容。

有关详细说明，请访问创建自定义日志文件.

要快速设置slinglog文件，请执行以下操作：

访问 Adobe Experience Manager Web控制台日志支持，例如
- http://localhost:4502/system/console/slinglog
选择 添加新日志记录器
1. 选择 DEBUG 表示 日志级别
2. 输入名称 日志文件，例如
  - logs/scoring-debug.log
3. 输入2 记录器 （类）条目(使用 + 图标)
  - com.adobe.cq.social.scoring
  - com.adobe.cq.social.badging
4. 选择保存

chlimage_1-248

要查看日志条目：

从Web控制台
- 在状态菜单
- 选择 日志文件
- 搜索日志文件名，例如 scoring-debug
在服务器的本地磁盘上
- 日志文件为<server-install-dir>/crx-quickstart/logs/<log-file-name>.log
- 例如，.../crx-quickstart/logs/scoring-debug.log

chlimage_1-249

UGC用于评分和标记 ugc-for-scoring-and-badging

当所选SRP是JSRP或MSRP，但不是ASRP时，可以查看与评分和标记相关的UGC。 (如果不熟悉这些术语，请参阅社区内容存储和存储资源提供程序概述.)

访问评分和标记数据的描述使用JSRP，因为UGC可以使用 CRXDE Lite.

作者JSRP:在创作环境中进行实验时，会导致生成的UGC仅在创作环境中可见。

发布时的JSRP:同样，如果在发布环境中进行测试，则需要使用发布实例的管理权限访问CRXDE Lite。如果发布实例在中运行生产模式 (nosamplecontent runmode)，则需要启用CRXDE Lite.

UGC在JSRP上的基本位置是 /content/usergenerated/asi/jcr/.

评分和标记API scoring-and-badging-apis

以下API可供使用：

已安装的最新Javaoc 版本可供开发人员从Adobe存储库中使用。请参阅将Maven用于社区：Javaocs.

UGC在存储库中的位置和格式可能会发生更改，但不会发出警告.

示例设置 example-setup

存储库数据的屏幕截图来自在两个不同的AEM网站上为论坛设置评分和标记：

具有唯一ID的AEM网站（使用向导创建的社区网站）：
- 使用在入门教程
- 找到论坛页面节点
  - /content/sites/engage/en/forum/jcr:content
- 添加评分和标记属性
  - 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]
- 找到论坛组件节点
  - /content/sites/engage/en/forum/jcr:content/content/primary/forum
    
    ( sling:resourceType = social/forum/components/hbs/forum)
- 将资产添加到显示徽章
  - allowBadges = true
- 用户登录，创建论坛主题，并获得铜像徽章

AEM网站无唯一id:

使用社区组件指南
找到论坛页面节点
- /content/community-components/en/forum/jcr:content

添加评分和标记属性

code language-none
`scoringRules = [/etc/community/scoring/rules/comments-scoring, /etc/community/scoring/rules/forums-scoring]`

code language-none
`badgingRules =[/etc/community/badging/rules/comments-scoring, /etc/community/badging/rules/forums-scoring]`

找到论坛组件节点
- /content/community-components/en/forum/jcr:content/content/forum
  
  ( sling:resourceType = social/forum/components/hbs/forum)
将资产添加到显示徽章
- allowBadges = true
用户登录，创建论坛主题，并获得铜像徽章

使用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

由于用户已获得两枚铜牌，并获得了审核者徽章，因此用户在论坛条目中的显示方式如下：

chlimage_1-250

NOTE

此示例未遵循以下最佳实践：

评分规则名称应具有全局唯一性；它们不应以相同的名称结尾。
示例 not 要执行以下操作：
/etc/community/scoring/rules/site1/forums-scoring
/etc/community/scoring/rules/site2/forums-scoring
为不同的AEM站点创建唯一标记图像