채점 및 배지 핵심 사항 scoring-and-badges-essentials
AEM Communities 점수 및 배지 기능은 커뮤니티 구성원을 식별하고 보상합니다.
기능 설정에 대한 세부 사항은에서 설명합니다.
이 페이지에는 추가 기술 세부 정보 가 포함되어 있습니다.
배지 표시 displaying-badges
배지가 텍스트 또는 이미지로 표시되는지 여부는 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
배지가 획득 점수에 대해 부여되었으며 배지가 이미지로 표시되어야 함을 나타냅니다.
이 비헤이비어에 대한 모든 변경은 사용자 지정된 스크립트(오버라이드 또는 오버레이)에서 수행해야 합니다. 다음을 참조하십시오 클라이언트측 사용자 정의.
점수 및 배지 디버그 로그 debug-log-for-scoring-and-badging
채점 및 배지를 디버깅하기 위해 사용자 지정 로그 파일을 설정할 수 있습니다. 이 로그 파일의 내용은 기능에 문제가 발생하는 경우 고객 지원 센터에 제공될 수 있습니다.
자세한 지침은 다음을 참조하십시오. 사용자 지정 로그 파일 만들기.
slinglog 파일을 빠르게 설정하려면:
-
액세스 Adobe Experience Manager 웹 콘솔 로그 지원, 예
- https://localhost:4502/system/console/slinglog
-
선택 새 로거 추가
-
선택
DEBUG
대상 로그 수준 -
이름 입력 로그 파일, 예
- logs/scoring-debug.log
-
2개 입력 Logger (클래스) 항목(사용
+
아이콘)com.adobe.cq.social.scoring
com.adobe.cq.social.badging
-
저장 을 선택합니다
-
로그 항목을 보려면 다음 작업을 수행하십시오.
-
웹 콘솔에서
- 아래 상태 메뉴
- 선택 로그 파일
- 다음과 같은 로그 파일 이름을 검색합니다.
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를 볼 수 있습니다. (이 용어에 익숙하지 않은 경우 다음을 참조하십시오.) 커뮤니티 콘텐츠 저장소 및 저장소 리소스 공급자 개요.)
UGC는 를 사용하여 쉽게 액세스할 수 있으므로 채점 및 배지 데이터에 액세스하기 위한 설명은 JSRP를 사용합니다. CRXDE Lite.
작성자의 JSRP: 작성 환경에서 테스트하면 작성 환경에서만 볼 수 있는 UGC가 생성됩니다.
게시 시 JSRP: 마찬가지로 게시 환경에서 테스트하는 경우 게시 인스턴스에 대한 관리 권한으로 CRXDE Lite에 액세스해야 합니다. 게시 인스턴스가 실행 중인 경우 프로덕션 모드 (nosamplecontent 실행 모드), 다음을 수행해야 합니다. CRXDE Lite 활성화.
JSRP에서 UGC의 기본 위치는 다음과 같습니다. /content/usergenerated/asi/jcr/
.
채점 및 배지 API scoring-and-badging-apis
다음 API를 사용할 수 있습니다.
설치된 기능 팩의 최신 Javadocs는 Adobe 저장소에서 개발자가 사용할 수 있습니다. 다음을 참조하십시오 Maven for Communities : Javadocs 사용.
저장소에서 UGC의 위치 및 형식은 경고 없이 변경될 수 있습니다.
예제 설정 example-setup
저장소 데이터의 스크린샷은 두 개의 다른 AEM 사이트에서 포럼에 대한 점수 및 배지 설정에서 가져옵니다.
-
AEM 사이트 포함 고유 id(마법사를 사용하여 만든 커뮤니티 사이트):
-
다음 작업 중에 생성된 시작 자습서(참여) 사이트 사용 시작하기 자습서
-
포럼 페이지 노드를 찾습니다
/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
-
사용자가 로그인하고 포럼 주제를 만들고 브론즈 배지를 받습니다
-
-
AEM 사이트 없이 고유 id :
-
포럼 페이지 노드를 찾습니다
/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
-
사용자가 로그인하고 포럼 주제를 만들고 브론즈 배지를 받습니다
-
사용자에게 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
사용자가 두 개의 브론즈 배지를 받고 중재자 배지가 수여되면 다음과 같이 포럼 항목이 있는 사용자가 표시됩니다.
-
채점 규칙 이름은 전체적으로 고유해야 하며 동일한 이름으로 끝나서는 안 됩니다.
의 예 아님 수행 방법:
/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를 참조할 수 있습니다.
액세스 배지 UGC access-badging-ugc
사용 API 선호됩니다.
조사 목적으로 예를 들어 JSRP를 사용하는 경우 할당되거나 부여된 배지에 대한 정보가 포함된 기본 폴더는 입니다.
/content/usergenerated/asi/jcr
뒤에 사용자 프로필에 대한 경로가 표시되고 배지 폴더로 끝납니다. 예:
/home/users/community/w271OOup2Z4DjnOQrviv/profile/badges
수여된 배지 awarded-badge
할당된 배지 assigned-badge
추가 정보 additional-information
점을 기준으로 정렬된 멤버 목록을 표시하려면 다음을 수행합니다.
- 리더보드 기능 커뮤니티 사이트 또는 그룹 템플릿에 포함할 수 있습니다.
- 리더보드 구성 요소: 페이지 작성을 위한 리더보드 기능의 주요 구성 요소입니다.