スコアおよびバッジの基本事項

AEM Communities のスコアおよびバッジ機能を使用すると、コミュニティメンバーを分類して報奨を与えることができます。

この機能の設定方法について詳しくは、以下を参照してください。

このページには、次の技術詳細が別途まとめられています。

  • バッジを画像またはテキストとして表示する方法
  • 詳細なデバッグログを有効にする方法
  • スコアリングとバッジングに関連したUGCにアクセスする方法
注意

CRXDE Lite に表示される実装構造は変更される可能性があります。

バッジの表示

バッジをテキストと画像のいずれで表示するかは、クライアント側の HBS テンプレートを使用して制御します。

例えば、/libs/social/forum/components/hbs/topic/list-item.hbsthis.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}}

isAssigned が true の場合、役割に対してバッジが割り当てられ、そのバッジはテキストとして表示されることを示します。

isAssigned が false の場合、獲得されたスコアに対する報奨としてバッジが与えられ、そのバッジは画像として表示されることを示します。

必要に応じて、スクリプトをカスタマイズし、この動作を変更できます(オーバーライドまたはオーバーレイ)。「クライアント側のカスタマイズ」を参照してください。

スコアおよびバッジのデバッグログ

スコアおよびバッジのデバッグに役立つように、カスタムログファイルを設定できます。この機能に問題が発生した場合は、このログファイルの内容をカスタマーサポートに提供できます。

詳細な手順については、カスタムログファイルの作成を参照してください。

slinglog ファイルをすばやく設定するには、次の手順に従います。

  1. Adobe Experience ManagerWebコンソールログのサポート​にアクセスします。

    • http://localhost:4502/system/console/slinglog
  2. 追加新しいロガー​を選択

    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

選択された SRP が ASRP ではなく JSRP または MSRP のいずれかである場合、スコアおよびバッジに関連する UGC を参照できます(これらの用語に詳しくない場合は、コミュニティコンテンツストレージおよびストレージリソースプロバイダーの概要を参照してください)。

ここでは、JSRP を例に挙げて、スコアおよびバッジデータにアクセスする方法を説明しています。この場合、CRXDE Lite を使用して UGC に容易にアクセスできます。

作成者:作成者の環境を試すと、UGCは作成者の環境からのみ表示されます。

発行時のJSRP:同様に、発行環境でテストする場合は、発行インスタンスの管理者権限を持つCRXDE Liteにアクセスする必要があります。発行インスタンスが実稼働モード(nosamplecontent runmode)で実行されている場合は、CRXDE Liteを有効にする必要があります。

JSRP上のUGCの基本位置は/content/usergenerated/asi/jcr/です。

スコアおよびバッジの API

使用できる API を以下に示します。

Adobeリポジトリから開発者が入手できる、インストール済みのリリースの最新のJavadoc。 Communities 用 Maven の使用:Javadoc を参照してください。

リポジトリ内の UGC の場所と形式は予告なく変更されることがあります

設定例

リポジトリデータのスクリーンショットは、2 つの異なる AEM Sites 上のフォーラムに対してスコアおよびバッジを設定する場合の例です。

  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. 一意のIDが​ないAEMサイト:

    • コミュニティコンポーネントガイドの使用

    • フォーラムページのノードを見つけます

      • /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

ユーザーはブロンズのバッジを2つ獲得し、モデレーターバッジを与えられたので、ユーザーは次のようにフォーラムに参加して表示されます。

chlimage_1-250

メモ

この例では次のベストプラクティスに従っていません。

  • スコアルールの名前はグローバルレベルで一意にする必要があり、末尾を同じ名前にしてはなりません。
    not​の処理の例を次に示します。
    /etc/community/scoring/rules/site1/forums-scoring
    /etc/community/scoring/rules/site2/forums-scoring

  • 異なる AEM Sites にはそれぞれ一意のバッジ画像を作成します。

スコア関連の 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

スコアは、直接値のみを含む場合や、間接的にatomicCounterを参照する場合があるプロパティscoreValue_tlに格納されます。

chlimage_1-251

バッジ関連の UGC へのアクセス

API の使用が推奨されます。

例えば JSRP を使用する場合、割り当てられたバッジまたは報奨として与えられたバッジについての情報が格納される基本フォルダーは次のとおりです。

  • /content/usergenerated/asi/jcr

次のように、ユーザーのプロファイルのパスが続き、最後が badges フォルダーになります。

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

バッジを授与

chlimage_1-252

割り当てられたバッジ

chlimage_1-253

追加情報

ポイントに基づいて並べ替えたメンバーリストを表示するには:

このページ

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now