コミュニティのスコアとバッジ communities-scoring-and-badges

概要 overview

AEM Communitiesのスコアおよびバッジ機能を使用すると、コミュニティメンバーを特定して報酬を付与できます。

スコアとバッジの主な側面は次のとおりです。

注意 バッジの授与は デフォルトでは有効になっていません.

バッジ badges

バッジはメンバーの名前の下に配置され、メンバーの役割またはコミュニティ内での地位を示します。 バッジは、画像または名前として表示できます。 画像として表示される場合、名前はアクセシビリティの代替テキストとして含まれます。

デフォルトでは、バッジは次の場所にあるリポジトリに格納されます。

別の場所に保存されている場合は、すべてのユーザーがアクセス可能な状態で読み取る必要があります。

バッジは、ルールに従って割り当てられたか、獲得したかに応じて、UGC で区別されます。 現在、割り当てられたバッジはテキストとして表示され、獲得したバッジは画像として表示されます。

バッジ管理 UI badge-management-ui

コミュニティ バッジコンソール メンバーが獲得（授与）した場合や、コミュニティで特定の役割を担った（割り当てられた）場合に表示できるカスタムバッジを追加できます。

割り当て済みバッジ assigned-badges

役割ベースのバッジは、コミュニティ内の役割に基づいて、管理者がコミュニティメンバーに割り当てます。

割り当てられた（および付与された）バッジは、選択されたに保存されます SRP とに直接アクセスすることはできません。 GUI が使用可能になるまで、役割ベースのバッジを割り当てる唯一の手段は、コードまたは cURL を使用することです。 cURL の手順については、というタイトルの節を参照してください。 バッジの割り当てと失効.

リリースには、役割ベースのバッジが 3 つ含まれています。

審査済みバッジ awarded-badges

報酬ベースのバッジは、コミュニティ内のメンバーのアクティビティに適用されるルールに基づいて、スコアリングサービスによってコミュニティメンバーに付与されます。

アクティビティの報酬としてバッジが表示されるようにするには、次の 2 つの処理を行う必要があります。

リリースには、報酬ベースのバッジが 3 つ含まれています。

カスタムバッジ custom-badges

カスタムバッジは、 バッジコンソール また、バッジルールに割り当てまたは指定します。

バッジコンソールからインストールすると、カスタムバッジがパブリッシュ環境に自動的に複製されます。

スコアリングを有効にする enable-scoring

スコアリングは、デフォルトでは有効になっていません。 バッジのスコアリングと授与を設定して有効にするための基本的な手順は次のとおりです。

を参照してください。 クイックテスト フォーラムとコメントのデフォルトのスコアおよびバッジルールを使用してコミュニティサイトのスコアリングを有効にする節です。

コンテンツへのルールの適用 apply-rules-to-content

スコアおよびバッジを有効にするには、以下のプロパティを追加します scoringRules および badgingRules をサイトのコンテンツツリー内の任意のノードに追加します。

サイトが既に公開されている場合は、すべてのルールを適用してコンポーネントを有効にした後、サイトを再公開します。

バッジが有効になっているコンポーネントに適用されるルールは、現在のノードまたはその上位のノードのルールです。

ノードのタイプがの場合 cq:Page （推奨） CRXDE|Lite を使用して、のプロパティをに追加します jcr:content ノード。

コンポーネントのバッジを有効にする enable-badges-for-component

スコアおよびバッディングルールは、でコンポーネント設定を編集することでバッジを有効にしているコンポーネントのインスタンスに対してのみ有効になります オーサリングモード.

ブール値プロパティ、 allowBadges、コンポーネントインスタンスのバッジの表示を有効または無効にします。 で設定できます コンポーネント編集ダイアログ というラベルの付いたチェックボックスを使用したフォーラム、QnA、コメントのコンポーネント バッジを表示.

例：フォーラムコンポーネントインスタンスの allowBadges example-allowbadges-for-forum-component-instance

スコアルール scoring-rules

スコアルールは、バッジを付与するためのスコアリングの基礎です。

各スコアルールは、1 つ以上のサブルールのリストです。 スコアルールは、バッジが有効な場合に適用するルールを識別するために、コミュニティサイトのコンテンツに適用されます。

スコアルールは継承されますが、加算はできません。 次に例を示します。

複数のスコアルールがある場合、スコアはルールごとに別々に維持されます。

スコアルールは、タイプのノードです cq:Page プロパティが設定されたアセット jcr:content サブルールを定義するサブルールのリストを指定するノード。

スコアは SRP に保存されます。

スコアリングサブルール scoring-sub-rules

スコアリングサブルールには、コミュニティに参加するための値の詳細を示すプロパティが含まれています。

各スコアリング・サブルールは、次の項目を識別します。

デフォルトでは、サブルールでコンテンツの所有者にポイントの付与が指定されていない限り、アクションを実行したメンバーにポイントが付与されます（ forOwner）に設定します。

各サブルールは、1 つ以上のスコアルールに含めることができます。

サブルールの名前は、通常、 件名, オブジェクト、および 動詞. 次に例を示します。

サブルールはタイプのノードです cq:Page プロパティが設定されたアセット jcr:contentを指定するノード 動詞とトピック .

スコアルールとサブルールを含む included-scoring-rules-and-sub-rules

リリースには、次の 2 つのスコアルールが含まれています フォーラム機能 （フォーラム機能のフォーラム コンポーネントとコメント コンポーネントごとに 1 つ）。

メモ：

カスタムスコアルールの有効化 activating-custom-scoring-rules

オーサー環境で行われたスコアルールまたはサブルールに対する変更や追加は、パブリッシュ環境にインストールする必要があります。

バッジルール badging-rules

バッジルールは、次のように指定して、スコアルールをバッジにリンクします。

バッジルールは、タイプのノードです cq:Page プロパティが設定されたアセット jcr:content スコアルールをスコアおよびバッジに関連付けるノード。

バッジのルールは必須で構成されています thresholds バッジにマッピングされたスコアの順序付きリストであるプロパティ。 スコアは、値を増やして並べ替える必要があります。 次に例を示します。

バッジルールは、ポイントの蓄積方法を決定するスコアルールとペアになっています。 というタイトルのセクションを参照してください。 コンテンツへのルールの適用.

この scoringRules バッジルールのプロパティは、その特定のバッジルールとペアにできるスコアルールを制限するだけです。

含まれるバッジルール included-badging-rules

リリースには、に対応する 2 つのバッジルールが含まれています フォーラムとコメントのスコアルール.

メモ：

カスタムバッジルールのアクティブ化 activating-custom-badging-rules

オーサー環境で行われたバッジルールまたは画像の変更や追加は、すべてパブリッシュ環境にインストールする必要があります。

バッジの割り当てと取り消し assign-and-revoke-badges

バッジは、次のいずれかを使用してメンバーに割り当てることができます メンバーコンソール または、cURL コマンドをプログラムで使用した場合も同様です。

次の cURL コマンドは、バッジの割り当てと取り消しに関する HTTP リクエストに必要な操作を示しています。 基本的な形式は次のとおりです。

cURL -i -X POST -H ヘッダー -u サインイン -F 操作 -F バッジ member-profile-url

ヘッダー = "Accept:application/json" カスタムヘッダーをサーバーに渡す（必須）

サインイン =管理者 id：パスワード（例：admin:admin）

操作 = ":operation=social:assignBadge"または":operation=social:deleteBadge"

バッジ = "badgeContentPath=badge-image-file“

badge-image-file =リポジトリ内のバッジ画像ファイルの場所（例：/libs/settings/community/badging/images/moderator/jcr:content/moderator.png）

member-profile-url =公開時のメンバーのプロファイルのエンドポイント（例：https://）<server>:<port>/home/users/community/riley/profile.social.json

例： examples

モデレータバッジを割り当てる assign-a-moderator-badge

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" /home/users/community/updcs9DndLEI74DB9zsB/profile.social.json

割り当てられたシルバーバッジの取り消し revoke-an-assigned-silver-badge

curl -i -X POST -H "Accept:application/json" -u admin:admin -F ":operation=social:deleteBadge" -F "badgeContentPath=/libs/settings/community/badging/images/silver/jcr:content/silver.png" /home/users/community/updcs9DndLEI74DB9zsB/profile.social.json

カスタムコンポーネントのスコアとバッジ scoring-and-badges-for-custom-components

コンポーネント用に作成したイベントトピックを動詞に関連付けることで、カスタムコンポーネントのスコアおよびバッジルールを作成できます。

トピックと動詞 topics-and-verbs

メンバーがコミュニティの機能を操作すると、通知やスコアリングなどの非同期リスナーをトリガーにできるイベントが送信されます。

コンポーネントの SocialEvent インスタンスは、イベントをとして記録します actions ～に起こる topic. SocialEvent には、 verb アクションに関連付けられます。 次のものがあります n-1 ～間の関係 actions および verbs.

提供されるコミュニティコンポーネントについて、次の表で説明します verbs それぞれに定義済み topic ～で利用できる スコアリングサブルール.

カレンダーコンポーネント
SocialEvent topic= com/adobe/cq/social/calendar

コメントコンポーネント
SocialEvent topic= com/adobe/cq/social/comment

ファイルライブラリコンポーネント
SocialEvent topic= com/adobe/cq/social/fileLibrary

フォーラムコンポーネント
SocialEvent topic= com/adobe/cq/social/forum

ジャーナルコンポーネント
SocialEvent topic= com/adobe/cq/social/journal

QnA コンポーネント
SocialEvent topic = com/adobe/cq/social/qna

レビューコンポーネント
SocialEvent topic= com/adobe/cq/social/review

評価コンポーネント
SocialEvent topic= com/adobe/cq/social/tally/rating

投票コンポーネント
SocialEvent topic= com/adobe/cq/social/tally/voting

モデレートが有効なコンポーネント
SocialEvent topic= com/adobe/cq/social/moderation

カスタムコンポーネントイベント custom-component-events

カスタムコンポーネントの場合、SocialEvent がインスタンス化されて、コンポーネントのイベントが次のように記録されます actions ～に起こる topic.

スコアリングをサポートするには、SocialEvent がメソッドを上書きする必要があります getVerb() 適切なように verb は、それぞれの action. この verb アクションに対して返されるものには、一般的に使用されるもの（例えば POST）またはコンポーネントに特化したもの（例： ADD RATING）に設定します。 次のものがあります n-1 ～間の関係 actions および verbs.

トラブルシューティング troubleshooting

バッジが表示されない badges-are-not-appearing

Web サイトのコンテンツにスコアおよびバッジルールが適用されていて、アクティビティに対してバッジが付与されていない場合は、そのコンポーネントのインスタンスに対してバッジが有効になっていることを確認してください。

参照： コンポーネントのバッジを有効にする.

スコアルールが無効 scoring-rule-has-no-effect

Web サイトのコンテンツにスコアルールとバッジルールが適用されていて、一部のアクションにのみバッジが付与され、他のアクションには付与されない場合は、バッジルールが適用対象のスコアルールを制限していないことを確認します。

を参照してください。 scoringRules のプロパティ バッジルール.

大文字と小文字を区別するタイプミス case-sensitive-typo

ほとんどのプロパティと値、特に動詞では、大文字と小文字が区別されます。 スコアリング サブルールで使用する場合、動詞はすべて大文字である必要があります。

機能が期待どおりに動作しない場合は、データが正しく入力されていることを確認します。

クイックテスト quick-test

を使用してスコアリングとバッジをすばやく試すことができます 入門チュートリアル （engage） サイト :

次に、フォーラムおよびコメントのコンポーネントで、バッジを表示できることを確認します。

次に、 再公開 コミュニティサイト。

最後に

最初のフォーラムバッジルールの最初のしきい値が 1 のスコアなので、これにより、コミュニティメンバーにはフォーラム投稿に表示されるブロンズバッジが与えられます。

追加情報 additional-information

詳しくは、 スコアおよびバッジの基本事項 開発者向けのページです。

高度スコアリング・エンジンの詳細は、次を参照してください： 高度なスコアとバッジ.

設定可能なリーダーボード component および 関数 コミュニティサイトでのメンバーとそのスコアの表示を簡素化します。