得分和徽章基本工具

AEM Communities評分和標章功能提供識別和獎勵社群成員的能力。

如需設定功能的詳細資訊，請參閱

社群評分和標章

本頁包含其他技術詳細資訊：

如何將徽章顯示為影像或文字
如何開啟廣泛的除錯記錄
如何存取與計分和標籤相關的UGC

注意

在CRXDE Lite中可見的實作結構可能會有所變更。

顯示標章

徽章是顯示為文字或影像，會在HBS範本的用戶端進行控制。

例如，在/libs/social/forum/components/hbs/topic/list-item.hbs中搜索this.isAssigned,:

{{#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，則「已指派」表示已授與贏取分數的徽章，且徽章應顯示為影像。

對此行為所做的任何變更都應在自訂指令碼中進行（覆寫或覆蓋）。請參閱用戶端自訂。

計分和標籤的調試日誌

若要協助除錯計分和標籤，可設定自訂記錄檔。如果功能出現問題，則可將此日誌檔案的內容提供給客戶支援。

如需詳細指示，請造訪建立自訂記錄檔。

要快速設定slinglog檔案，請執行以下操作：

存取Adobe Experience Manager Web Console記錄檔支援，例如
- http://localhost:4502/system/console/slinglog
選擇添加新記錄程式
1. 為日誌級別選擇DEBUG
2. 輸入日誌檔案的名稱，例如
  - logs/scoring-debug.log
3. 輸入兩個Logger(class)條目（使用+表徵圖）
  - com.adobe.cq.social.scoring
  - com.adobe.cq.social.badging
4. 選擇保存

chlimage_1-247

要查看日誌條目：

從Web Console
- 在狀態菜單下
- 選擇日誌檔案
- 搜索日誌檔案名，如scoring-debug
在伺服器的本地磁碟上
- 日誌檔案位於<server-install-dir>/crx-quickstart/logs/<log-file-name>.log
- 例如， .../crx-quickstart/logs/scoring-debug.log

chlimage_1-249

評分和標籤UGC

當選擇的SRP是JSRP或MSRP，但不是ASRP時，可以查看與計分和標籤相關的UGC。（如果不熟悉這些術語，請參閱社區內容儲存和儲存資源提供商概述。）

存取計分和標籤資料的說明使用JSRP，因為UGC可使用CRXDE Lite輕鬆存取。

作者JSRP:在作者環境中進行實驗會產生只有作者環境才能看到的UGC。

發佈時的JSRP:同樣地，如果在發佈環境上進行測試，則必須以發佈實例的管理權限訪問CRXDE Lite。如果發佈實例在生產模式(nosamplecontent runmode)中運行，則需要啟用CRXDE Lite。

JSRP上UGC的基本位置為/content/usergenerated/asi/jcr/。

計分和標籤API

下列API可供使用：

已安裝版本的最新Javadoc可供Adobe資料庫的開發人員使用。請參閱使用Maven for Communities:Javadocs。

UGC在儲存庫中的位置和格式可能會變更，但不會發出警告。

安裝示例

儲存庫資料的螢幕擷取畫面來自於在兩個不同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
- 新增計分和標籤屬性
```
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/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