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

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}}

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

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

必要に応じて、スクリプトをカスタマイズし、この動作を変更できます（オーバーライドまたはオーバーレイ）。詳しくは、 クライアント側のカスタマイズ.

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

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

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

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

1. 次にアクセス： Adobe Experience Manager Web コンソールログのサポート​例：

   • 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. 選択 保存

ログエントリを表示するには：

• Web コンソールから

  • 以下 ステータス メニュー
  • 選択 ログファイル
  • ログファイル名を検索します（例： ）。 scoring-debug

• サーバのローカルディスク上

  • ログファイルは <server-install-dir>/crx-quickstart/logs/<log-file-name>.log
  • 例：.../crx-quickstart/logs/scoring-debug.log

スコアおよびバッジの UGC

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

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

オーサー環境の JSRP:オーサー環境で実験を行うと、UGC がオーサー環境からのみ表示されるようになります。

公開時の JSRP:同様に、パブリッシュ環境でテストする場合は、パブリッシュインスタンス上の管理者権限を持つCRXDE Liteにアクセスする必要があります。 パブリッシュインスタンスがで実行されている場合 実稼動モード （nosamplecontent 実行モード）の場合、 有効CRXDE Lite.

JSRP 上の UGC の基本的な場所は次のとおりです。 /content/usergenerated/asi/jcr/.

スコアおよびバッジの API

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

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

インストール済みのの最新の Javadoc リリース 開発者は、デベロッパーリポジトリからAdobeを使用できます。 Communities 用 Maven の使用：Javadoc を参照してください。

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

設定例

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

1. 一意の ID を持つAEMサイト（ウィザードを使用して作成されたコミュニティサイト）:

   • 使用の手引きのチュートリアル (engage) サイトを使用し、 はじめにのチュートリアル

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

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

ユーザーが 2 つのブロンズバッジを獲得し、モデレーターバッジを授与されたので、ユーザーは次のようにフォーラムエントリと共に表示されます。

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

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

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

授与されたバッジ

割り当てられたバッジ

追加情報

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

• リーダーボード機能 コミュニティサイトまたはグループテンプレートに含める。
• リーダーボードコンポーネント：ページオーサリング用のリーダーボード機能の主要コンポーネント

Business.Adobe.com リソース

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