文件AEM 6.5Communities 指南

評分和徽章要點 scoring-and-badges-essentials

Last update: Sun Jul 14 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

建立對象：

  • 管理員

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

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

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

CAUTION
CRXDE Lite中顯示的實作結構可能會有所變更。

顯示徽章 displaying-badges

徽章是以文字還是影像的形式顯示，需在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，isAssigned表示該徽章已獲得贏取分數，並且該徽章應顯示為影像。

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

評分和徽章的偵錯記錄 debug-log-for-scoring-and-badging

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

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

若要快速設定slinglog檔案：

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

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

  2. 選取​ 新增記錄器

    1. 為​ 記錄層級 ​選取DEBUG

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

      • logs/scoring-debug.log

    3. 輸入兩個​ 記錄器 （類別）專案（使用+圖示）

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

    4. 選取​ 儲存

debug-scoring-log

若要檢視記錄專案，請執行下列動作：

  • 從Web控制檯

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

  • 在伺服器的本機磁碟上

    • 記錄檔位於<server-install-dir>/crx-quickstart/logs/<log-file-name>.log

    • 例如 .../crx-quickstart/logs/scoring-debug.log

評分記錄

評分和徽章的UGC ugc-for-scoring-and-badging

當所選的SRP是JSRP或MSRP，而不是ASRP時，可以檢視與評分和徽章相關的UGC。 （若不熟悉這些術語，請參閱社群內容儲存和儲存資源提供者概觀。）

使用JSRP存取評分和徽章資料的說明，因為使用CRXDE Lite可輕鬆存取UGC。

作者上的JSRP：在作者環境中進行實驗會產生UGC，而且只能從作者環境中看到。

發佈​ 上的 JSRP：同樣地，如果在發佈環境中進行測試，就必須在發佈執行個體上使用管理許可權來存取CRXDE Lite。 如果發佈執行個體是在生產模式 （nosamplecontent執行模式）中執行，則需要啟用CRXDE Lite。

JSRP上UGC的基礎位置是/content/usergenerated/asi/jcr/。

評分和徽章API scoring-and-badging-apis

以下API可供使用：

已安裝Feature Pack的最新Javadoc可供Adobe存放庫中的開發人員使用。 請參閱使用Maven for Communities ： Javadocs。

存放庫中UGC的位置和格式可能會變更，而不會出現警告。

範例設定 example-setup

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

  1. 具有​ 唯一識別碼的AEM網站 （使用精靈建立的社群網站） ：

    • 使用在快速入門教學課程期間建立的快速入門教學課程（參與）網站

    • 找出論壇頁面節點

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

    • 新增評分和徽章屬性

    code language-none 
    scoringRules = [/libs/settings/community/scoring/rules/comments-scoring,
/libs/settings/community/scoring/rules/forums-scoring]
    code language-none 
    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網站：

    • 使用社群元件指南

    • 找出論壇頁面節點

      /content/community-components/en/forum/jcr:content

    • 新增評分和徽章屬性

    code language-none 
    scoringRules = [/libs/settings/community/scoring/rules/comments-scoring,
/libs/settings/community/scoring/rules/forums-scoring]
    code language-none 
    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為使用者指派版主徽章：

    code language-shell 
    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

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

    版主

NOTE
此範例未遵循下列最佳實務：

  • 評分規則名稱應為全域唯一名稱，且不得以相同名稱結尾。

    不 ​的用途範例：

    /libs/settings/community/scoring/rules/site1/forums-scoring
    /libs/settings/community/scoring/rules/site2/forums-scoring

  • 為不同的AEM網站建立唯一的徽章影像

存取評分UGC access-scoring-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。

access-scoring-ugc

存取徽章UGC access-badging-ugc

建議使用API。

在調查用途中，以JSRP為例，包含指派或獎勵徽章相關資訊的基本資料夾為

  • /content/usergenerated/asi/jcr

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

  • /home/users/community/w271OOup2Z4DjnOQrviv/profile/badges

已授與的徽章 awarded-badge

warded-badging-ugc

已指派的徽章 assigned-badge

指派的徽章

其他資訊 additional-information

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

recommendation-more-help
81e2cd9d-0789-409d-b87c-2a8ce4f28791