計分和徽章要點

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

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

• 社群計分和徽章

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

• 如何 顯示徽章 為影像或文字
• 如何開啟廣泛 偵錯記錄
• 如何 訪問UGC 與打分和徽章有關

顯示徽章

徽章是否顯示為文字或影像，在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，則為「已分配」表示已為已獲得分數授予徽章，且徽章應顯示為影像。

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

計分和簽名的調試日誌

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

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

若要快速設定slinglog檔案：

1. 存取 Adobe Experience Manager Web主控台記錄支援，例如

   • http://localhost:4502/system/console/slinglog

2. 選擇 添加新記錄器

   1. 選擇 DEBUG for 記錄層級

   2. 輸入 記錄檔，例如

      • logs/scoring-debug.log

   3. 輸入2 記錄器 （類）條目(使用 + 圖示)

      • com.adobe.cq.social.scoring
      • com.adobe.cq.social.badging

   4. 選擇 儲存

要查看日誌條目，請執行以下操作：

• 從Web控制台

  • 在 狀態 功能表
  • 選擇 記錄檔
  • 搜尋您的記錄檔檔案名稱，例如 scoring-debug

• 在伺服器的本地磁碟上

  • 日誌檔案為<server-install-dir>/crx-quickstart/logs/<log-file-name>.log
  • 例如 .../crx-quickstart/logs/scoring-debug.log

UGC用於計分和簽名

當選擇的SRP是JSRP或MSRP，但不是ASRP時，可以查看與計分和徽章相關的UGC。 (如果不熟悉這些術語，請參閱 社群內容儲存 和 儲存資源提供程式概述.)

存取計分和加註資料的說明使用JSRP，因為UGC可透過 CRXDE Lite.

JSRP關於作者:在製作環境中實驗會導致UGC，而此UGC僅可從製作環境中看到。

發佈JSRP:同樣地，如果在發佈環境上進行測試，則需要以發佈例項的管理權限存取CRXDE Lite。 如果發佈執行個體在 生產模式 (nosamplecontent runmode)，則必須 啟用CRXDE Lite.

UGC在JSRP上的基地位置為 /content/usergenerated/asi/jcr/.

計分與加號API

下列API可供使用：

• com.adobe.cq.social.scoring.api
• com.adobe.cq.social.badging.api

已安裝的最新Javadoc 發行 供開發人員從Adobe存放庫使用。 請參閱 將Maven用於社群：Javadocs.

UGC在存放庫中的位置和格式可能會變更，恕不另行警告.

範例設定

存放庫資料的螢幕擷取畫面來自為兩個不同AEM網站上的論壇設定計分和標籤：

1. 具有唯一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

   • 使用者登入、建立論壇主題，並獲得銅牌

2. 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

   • 使用者登入、建立論壇主題，並獲得銅牌

3. 系統會使用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

由於使用者已獲得兩個銅牌，並且已獲得版主徽章，因此以下是使用者在論壇項目中的顯示方式：

訪問計分UGC

使用 API 為偏好設定。

為了調查目的，以JSRP為例，包含分數的基本資料夾為

• /content/usergenerated/asi/jcr/scoring

的子節點 scoring是計分規則名稱。 因此，最佳實務是，伺服器上的計分規則名稱是全域唯一的。

對於Geometrixx參與網站，使用者及其分數位於包含計分規則名稱、社群網站網站ID( engage-ba81p)、唯一id和使用者id:

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

對於社群元件指南網站，使用者及其分數位於以計分規則名稱（預設ID）建構的路徑中( default-site)、唯一id和使用者id:

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

分數會儲存在屬性中 scoreValue_tl 其中可能直接包含值或間接引用atomicCounter。

訪問標籤UGC

使用 API 為偏好設定。

為了調查目的，以JSRP為例，包含已指派或已授予徽章之資訊的基本資料夾為

• /content/usergenerated/asi/jcr

後接使用者設定檔的路徑，結尾為徽章資料夾，例如

• /home/users/community/w271Oup2Z4DjnOQrviv/profile/badgs

獎章

指派徽章

其他資訊

要根據點顯示按排序的成員清單，請執行以下操作：

• 排行榜功能 以包含在社群網站或群組範本中。
• 排行榜元件，此元件為排行榜功能的精選元件，用於頁面編寫。

Business.Adobe.com 資源

Ecommerce Integrations Asset Collections Mobile Forms Document Generation Managed Cloud Customer Experience Management