Essenciais de pontuação e símbolos

O recurso de pontuação e emblemas do AEM Communities oferece a capacidade de identificar e recompensar membros da comunidade.

Os detalhes da configuração do recurso estão descritos em

Esta página contém detalhes técnicos adicionais:

CUIDADO

A estrutura de implementação visível no CRXDE Lite está sujeita a alterações.

Exibindo emblemas

Se um crachá é exibido como texto ou imagem é controlado no lado do cliente no modelo HBS.

Por exemplo, procure this.isAssigned em /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}}

Se verdadeiro, isAssigned indica que o crachá foi atribuído a uma função e que o crachá deve ser exibido como texto.

Se falso, é Atribuído indica que o crachá foi concedido para uma pontuação ganha e o crachá deve ser exibido como uma imagem.

Quaisquer alterações nesse comportamento devem ser feitas em um script personalizado (sobreposição ou sobreposição). Consulte Personalização do cliente.

Registro de depuração para pontuação e marcação

Para ajudar a depurar a pontuação e a identificação, é possível configurar um arquivo de log personalizado. O conteúdo desse arquivo de log pode ser fornecido ao suporte ao cliente se forem encontrados problemas com o recurso.

Para obter instruções detalhadas, visite Criar um arquivo de log personalizado.

Para configurar rapidamente um arquivo de registro de slides:

  1. Acesse o Adobe Experience Manager Web Console Log Support, por exemplo

    • http://localhost:4502/system/console/slinglog
  2. Selecione Adicionar novo agente de registro

    1. Selecione DEBUG para Nível de registro

    2. Digite um nome para Arquivo de Log, por exemplo

      • logs/scoring-debug.log
    3. Digite duas entradas Logger (classe) (usando o ícone +)

      • com.adobe.cq.social.scoring
      • com.adobe.cq.social.badging
    4. Selecione Salvar

chlimage_1-247

Para ver as entradas de log:

  • Do Console da Web

    • No menu Status
    • Selecione Arquivos de Log
    • Procure o nome do arquivo de log, como scoring-debug
  • No disco local do servidor

    • O arquivo de log está em <server-install-dir/crx-quickstart/logs/<log-file-name.log
    • Por exemplo, .../crx-quickstart/logs/scoring-debug.log

chlimage_1-249

UGC para Pontuação e Classificação

É possível visualização do UGC relacionado à pontuação e à identificação quando o SRP escolhido for JSRP ou MSRP, mas não ASRP. (Se não estiver familiarizado com esses termos, consulte Armazenamento de conteúdo da comunidade e Visão Geral do Provedor de recursos do Armazenamento.)

As descrições para acessar dados de pontuação e marcação usam o JSRP, já que o UGC é facilmente acessível usando CRXDE Lite.

JSRP no autor: experimentar no ambiente do autor resulta em UGC que só é visível do ambiente do autor.

JSRP ao publicar: da mesma forma, se estiver testando o ambiente publish, será necessário acessar o CRXDE Lite com privilégios administrativos em uma instância de publicação. Se a instância de publicação estiver sendo executada no modo de produção (nosamplecontent runmode), será necessário ativar CRXDE Lite.

O local base do UGC no JSRP é /content/usergenerated/asi/jcr/.

APIs de pontuação e marcação

As seguintes APIs estão disponíveis para uso:

Os Javadocs mais recentes para as versões instaladas estão disponíveis para desenvolvedores a partir do repositório do Adobe. Consulte Usando o Maven para Comunidades: Javadocs.

A localização e o formato do UGC no repositório estão sujeitos a alterações sem aviso prévio.

Exemplo de configuração

As capturas de tela dos dados do repositório vêm da configuração da pontuação e da identificação de um fórum em dois sites de AEM diferentes:

  1. Um site AEM com uma ID exclusiva (site da comunidade criado usando o assistente):

    • Usando o site Tutorial de Introdução (engajamento) criado durante o tutorial de introdução

    • Localize o nó da página do fórum

      • /content/sites/engage/en/forum/jcr:content
    • Adicionar propriedades de pontuação e marcação

      • 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]

    • Localize o nó do componente do fórum

      • /content/sites/engage/en/forum/jcr:content/content/primary/forum

        ( sling:resourceType = social/forum/components/hbs/forum)

    • Adicionar propriedade para exibir emblemas

      • allowBadges = true
    • Um usuário entra, cria um tópico do fórum e recebe um crachá de bronze

  2. Um site AEM sem uma ID exclusiva:

    • Usando o Guia de componentes da comunidade

    • Localize o nó da página do fórum

      • /content/community-components/en/forum/jcr:content
    • Adicionar propriedades de pontuação e marcação

      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]
      
    • Localize o nó do componente do fórum

      • /content/community-components/en/forum/jcr:content/content/forum

        ( sling:resourceType = social/forum/components/hbs/forum)

    • Adicionar propriedade para exibir emblemas

      • allowBadges = true
    • Um usuário entra, cria um tópico do fórum e recebe um crachá de bronze

  3. Um usuário recebe um crachá de moderador usando 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

Como um usuário ganhou dois símbolos de bronze e recebeu um crachá de moderador, é assim que o usuário aparece com sua entrada no fórum:

chlimage_1-250

OBSERVAÇÃO

Este exemplo não segue essas práticas recomendadas:

  • os nomes de regras de pontuação devem ser globalmente exclusivos; não devem terminar com o mesmo nome.
    Um exemplo do que not fazer:
    /etc/community/scoring/rules/site1/forums-scoring
    /etc/community/scoring/rules/site2/forums-scoring

  • criação de imagens de crachá exclusivas para sites de AEM diferentes

Acesse a Pontuação UGC

É preferível usar as APIs.

Para fins de investigação, usando o JSRP como exemplo, a pasta base que contém pontuações é

  • /content/usergenerated/asi/jcr/scoring

O nó filho de scoringé o nome da regra de pontuação. Assim, uma prática recomendada é que os nomes das regras de pontuação em um servidor sejam globalmente exclusivos.

Para o site de Envolvimento do Geometrixx, o usuário e sua pontuação estão em um caminho construído com o nome da regra de pontuação, a ID do site da comunidade ( engage-ba81p), uma ID exclusiva e a ID do usuário:

  • .../scoring/forums-scoring/engage-ba81p/6d179715c0e93cb2b20886aa0434ca9b5a540401/riley

Para o site de guia Componentes da comunidade, o usuário e sua pontuação estão em um caminho construído com o nome da regra de pontuação, uma ID padrão ( default-site), uma ID exclusiva e a ID do usuário:

  • .../scoring/forums-scoring/default-site/b27a17cb4910a9b69fe81fb1b492ba672d2c086e/riley

A pontuação é armazenada na propriedade scoreValue_tl, que pode conter apenas um valor ou referir-se indiretamente a um atomicCounter.

chlimage_1-251

Acesso com marca UGC

É preferível usar as APIs.

Para fins de investigação, usando o JSRP como exemplo, a pasta base que contém informações sobre crachás atribuídos ou atribuídos é

  • /content/usergenerate/asi/jcr

Seguido pelo caminho para o perfil do usuário, terminando em uma pasta de crachás, como

  • /home/users/community/w271Oup2Z4DjnOQrviv/perfil/badges

Crachá atribuído

chlimage_1-252

crachá atribuído

chlimage_1-253

Informações adicionais

Para exibir uma lista classificada de membros com base em pontos:

  • Função de quadro de líderes para inclusão em um site da comunidade ou modelo de grupo.
  • Componente de quadro de líderes, o componente em destaque da função de quadro de líderes, para criação de página.

Nesta página

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