채점 및 배지 핵심 사항 scoring-and-badges-essentials

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

기능 설정에 대한 세부 사항은에서 설명합니다.

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

CAUTION
CRXDE Lite에 표시되는 구현 구조는 변경될 수 있습니다.

배지 표시 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 파일을 빠르게 설정하려면:

  1. 액세스 Adobe Experience Manager 웹 콘솔 로그 지원, 예

    • https://localhost:4502/system/console/slinglog
  2. 선택 새 로거 추가

    1. 선택 DEBUG 대상 로그 수준

    2. 이름 입력 로그 파일, 예

      • logs/scoring-debug.log
    3. 2개 입력 Logger (클래스) 항목(사용 + 아이콘)

      • com.adobe.cq.social.scoring
      • com.adobe.cq.social.badging
    4. 저장 ​을 선택합니다

debug-scoring-log

로그 항목을 보려면 다음 작업을 수행하십시오.

  • 웹 콘솔에서

    • 아래 상태 메뉴
    • 선택 로그 파일
    • 다음과 같은 로그 파일 이름을 검색합니다. scoring-debug
  • 서버의 로컬 디스크에서

    • 로그 파일은 <server-install-dir>/crx-quickstart/logs/<log-file-name>.log

    • 예, .../crx-quickstart/logs/scoring-debug.log

scoring-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 사이트에서 포럼에 대한 점수 및 배지 설정에서 가져옵니다.

  1. 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

    • 사용자가 로그인하고 포럼 주제를 만들고 브론즈 배지를 받습니다

  2. AEM 사이트 없이 고유 id :

    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

    • 사용자가 로그인하고 포럼 주제를 만들고 브론즈 배지를 받습니다

  3. 사용자에게 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
    

    사용자가 두 개의 브론즈 배지를 받고 중재자 배지가 수여되면 다음과 같이 포럼 항목이 있는 사용자가 표시됩니다.

    중재자

NOTE
이 예는 다음 모범 사례를 따르지 않습니다.
  • 채점 규칙 이름은 전체적으로 고유해야 하며 동일한 이름으로 끝나서는 안 됩니다.

    의 예 아님 수행 방법:

    /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를 참조할 수 있습니다.

access-scoring-ugc

액세스 배지 UGC access-badging-ugc

사용 API 선호됩니다.

조사 목적으로 예를 들어 JSRP를 사용하는 경우 할당되거나 부여된 배지에 대한 정보가 포함된 기본 폴더는 입니다.

  • /content/usergenerated/asi/jcr

뒤에 사용자 프로필에 대한 경로가 표시되고 배지 폴더로 끝납니다. 예:

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

수여된 배지 awarded-badge

시상식-배지-ugc

할당된 배지 assigned-badge

할당된 배지

추가 정보 additional-information

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

recommendation-more-help
81e2cd9d-0789-409d-b87c-2a8ce4f28791