점수 지정 및 배지 필수

AEM Communities 점수 및 배지 기능을 사용하면 커뮤니티 구성원을 식별하고 보상할 수 있습니다.

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

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

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

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

배지 표시 중

배지가 텍스트 또는 이미지로 표시되는지 여부는 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. Logger (클래스) 항목 두 개 입력(+ 아이콘 사용)

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

chlimage_1-248

로그 항목을 보려면:

  • 웹 콘솔에서

    • 상태 메뉴 아래
    • 로그 파일​을 선택합니다.
    • 로그 파일 이름(예: scoring-debug) 검색
  • 서버의 로컬 디스크에

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

chlimage_1-249

채점 및 배지에 대한 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를 사용할 수 있습니다.

설치된 릴리스에 대한 최신 Javadocs는 Adobe 저장소의 개발자가 사용할 수 있습니다. 커뮤니티에 대한 마비사항 사용: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
    • 사용자가 로그인하고 포럼 주제를 만든 후 bronze 배지를 수여합니다.

  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
    • 사용자가 로그인하고 포럼 주제를 만든 후 bronze 배지를 수여합니다.

  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

사용자가 두 개의 청동 배지를 받았고 사회자 배지를 받았으며 포럼 참가자와 함께 표시되는 방식은 다음과 같습니다.

chlimage_1-250

노트

이 예는 다음 우수 사례를 따르지 않습니다.

  • 점수 지정 규칙 이름은 전체적으로 고유해야 합니다.동일한 이름으로 끝나지 않아야 합니다.
    이(가) 아닌​의 예:
    /etc/community/scoring/rules/site1/forums-scoring
    /etc/community/scoring/rules/site2/forums-scoring

  • 다양한 AEM 사이트에 대한 고유한 배지 이미지 만들기

점수 지정 UGC 액세스

APIs를 사용하는 것이 좋습니다.

이 예제에 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를 간접적으로 참조할 수 있습니다.

chlimage_1-251

배지 UGC 액세스

APIs를 사용하는 것이 좋습니다.

예를 들어 JSRP를 사용하여 할당 또는 수여된 배지에 대한 정보가 포함된 기본 폴더는 조사 목적으로 사용됩니다.

  • /content/usergenerated/asi/jcr

사용자 프로필의 경로 뒤에 배지 폴더(예:

  • /home/users/community/w271Up2Z4DjnOQrviv/profile/badges

수여된 배지

chlimage_1-252

할당된 배지

chlimage_1-253

추가 정보

포인트를 기준으로 정렬된 멤버 목록을 표시하려면 다음을 수행하십시오.

이 페이지에서는

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now