評分和徽章要點

AEM Communities評分和徽章功能可識別並獎勵社群成員。

有關設定功能的詳細資訊，請參閱

• 社群評分和預算

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

• 操作說明 顯示徽章 做為影像或文字
• 如何開啟廣泛功能 偵錯記錄
• 操作說明 存取UGC 與評分和徽章相關

顯示徽章

徽章是以文字還是影像顯示，都是由HBS範本的使用者端控制。

例如，搜尋 this.isAssigned 在 /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，isAssigned會指出該徽章已獲得贏取的分數，且該徽章應顯示為影像。

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

評分和徽章的偵錯記錄

為協助偵錯評分和徽章，可以設定自訂記錄檔案。 如果功能發生問題，可將此記錄檔的內容提供給客戶支援。

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

若要快速設定slinglog檔案：

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

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

2. 選取 新增記錄器

   1. 選取 DEBUG 的 記錄層級

   2. 輸入名稱 記錄檔，例如

      • logs/scoring-debug.log

   3. 輸入兩個 Logger （類別）專案(使用 + 圖示)

      • 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，因為使用 CRXDE Lite.

作者上的JSRP：在製作環境中實驗會產生只能從製作環境看到的UGC。

發佈時的JSRP：同樣地，如果在發佈環境中進行測試，就必須在發佈執行個體上使用管理許可權來存取CRXDE Lite。 如果發佈執行個體執行於 生產模式 (nosamplecontent runmode)，必須 啟用CRXDE Lite.

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

評分和徽章API

以下API可供使用：

• 6.3中的com.adobe.cq.social.scoring.api
• 6.3中的com.adobe.cq.social.badging.api

開發人員可從Adobe存放庫取得已安裝功能套件的最新Javadoc。 另請參閱 使用Maven for Communities ： Javadocs.

UGC在存放庫中的位置和格式可能會有所變更，恕不發出警告.

範例設定

存放庫資料的熒幕擷取畫面來自於為兩個不同AEM網站上的論壇設定評分和徽章：

1. AEM網站 替換為 唯一id （使用精靈建立的社群網站） ：

   • 使用快速入門教學課程（參與）網站(建立於 快速入門教學課程

   • 找到論壇頁面節點

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

   • 新增評分和徽章屬性

   scoringRules = [/libs/settings/community/scoring/rules/comments-scoring,
   /libs/settings/community/scoring/rules/forums-scoring]
   

   badgingRules =[/libs/settings/community/badging/rules/comments-scoring,
   /libs/settings/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 = [/libs/settings/community/scoring/rules/comments-scoring,
   /libs/settings/community/scoring/rules/forums-scoring]
   

   badgingRules =[/libs/settings/community/badging/rules/comments-badging,
   /libs/settings/community/badging/rules/forums-badging]
   

   • 找到論壇元件節點

     /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=/libs/settings/community/badging/images/moderator/jcr:content/moderator.png" https://localhost:4503/home/users/community/w271OOup2Z4DjnOQrviv/profile.social.json
   

   由於使用者已獲得兩個銅級徽章並獲得了版主徽章，因此該使用者與其論壇條目出現如下：

   

存取評分UGC

使用 API 建議使用。

在調查用途中，以JSRP為例，包含分數的基本資料夾為

• /content/usergenerated/asi/jcr/scoring

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

對於GeometrixxEngage網站，使用者及其分數位於使用評分規則名稱、社群網站的網站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/w271OOup2Z4DjnOQrviv/profile/badges

已授與的徽章

已指派的徽章

其他資訊

若要根據點顯示已排序的成員清單，請執行下列動作：

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

Business.Adobe.com 資源

Automated Onboarding Style System Auto Form Fill Dynamic Media Dynamic Forms Digital Signage