점수 및 배지 필수 패키지

AEM Communities 점수 및 배지 기능은 커뮤니티 구성원을 식별하고 포상하는 기능을 제공합니다.

기능 설정에 대한 자세한 내용은

• 커뮤니티 점수 및 배지

이 페이지에는 추가적인 기술 세부 정보가 포함되어 있습니다.

• 배지를 이미지 또는 텍스트로 표시하는 방법
• 광범위한 디버그 로깅을 설정하는 방법
• 점수 및 배지 매기와 관련된 UGC에 액세스하는 방법

배지 표시

배지가 텍스트로 표시되는지 아니면 이미지가 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인 경우, 할당됨은 획득한 배지가 이미지로 표시되어야 함을 나타냅니다.

이 동작에 대한 모든 변경 사항은 사용자 지정된 스크립트(재정의 또는 오버레이)로 수행해야 합니다. 클라이언트측 사용자 지정을 참조하십시오.

점수 및 배지에 대한 디버그 로그

점수부여 및 배지 디버깅에 도움이 되도록 사용자 지정 로그 파일을 설정할 수 있습니다. 이 기능에 문제가 발생하는 경우 이 로그 파일의 내용을 고객 지원에 제공할 수 있습니다.

자세한 지침은 사용자 지정 로그 파일 만들기를 참조하십시오.

슬링로그 파일을 빠르게 설정하려면 다음을 수행합니다.

1. 예를 들어 Adobe Experience Manager 웹 콘솔 로그 지원​에 액세스합니다

   • http://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. 저장​을 선택합니다

로그 항목을 보려면

• 웹 콘솔에서

  • 상태 메뉴 아래에 있습니다.
  • 로그 파일 선택
  • scoring-debug 등의 로그 파일 이름을 검색합니다.

• 서버의 로컬 디스크

  • 로그 파일은 <server-install-dir/crx-quickstart/logs/<log-file-name.log에 있습니다.
  • 예, .../crx-quickstart/logs/scoring-debug.log

점수 및 배지에 대한 UGC

선택한 SRP가 JSRP 또는 MSRP이지만 ASRP가 아닌 경우 점수 및 배지 지정과 관련된 UGC를 볼 수 있습니다. (이러한 용어에 익숙하지 않은 경우 커뮤니티 컨텐츠 저장소 및 저장소 리소스 공급자 개요를 참조하십시오.)

CRXDE Lite을 사용하여 UGC에 쉽게 액세스할 수 있으므로 점수부여 및 배지 데이터에 액세스하기 위한 설명은 JSRP를 사용합니다.

작성자의 JSRP:작성 환경에서 테스트하면 작성 환경에서만 표시되는 UGC가 만들어집니다.

게시할 때의 JSRP:마찬가지로, 게시 환경에서 테스트하는 경우 게시 인스턴스에 대한 관리 권한이 있는 CRXDE Lite에 액세스해야 합니다. 게시 인스턴스가 프로덕션 모드(nosamplecontent runmode)에서 실행 중인 경우 CRXDE Lite을 활성화해야 합니다.

JSRP에 대한 UGC의 기본 위치는 /content/usergenerated/asi/jcr/입니다.

점수 및 배지 API

다음 API를 사용할 수 있습니다.

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

설치된 릴리스에 대한 최신 Javadocs는 Adobe 리포지토리에서 개발자가 사용할 수 있습니다. 커뮤니티에 Maven 사용 을 참조하십시오.Javadocs.

저장소에서 UGC의 위치와 형식은 경고 없이 변경될 수 있습니다.

설치 예

저장소 데이터의 스크린샷은 두 개의 서로 다른 AEM 사이트에서 포럼에 대한 점수 및 배지 설정으로부터 나옵니다.

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

사용자가 청동 배지 두 개를 획득하고 중재자 배지 수여를 받았으므로 사용자가 다음과 같이 포럼 항목과 함께 표시됩니다.

액세스 점수 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

뒤에 사용자 프로필에 대한 경로가 차례로 표시되고 다음과 같은 배지 폴더로 끝납니다.

• /home/users/community/w271Up2Z4DjnOQrviv/profile/badge

수여된 배지

지정된 배지

추가 정보

점을 기준으로 정렬된 멤버 목록을 표시하려면 다음을 수행합니다.

• 커뮤니티 사이트 또는 그룹 템플릿에 포함할 리드 보드 기능.
• 리더보드 기능의 주요 구성 요소인 페이지 작성을 위한 리더보드 구성 요소입니다.

Business.Adobe.com 리소스

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