Fundamentos de pontuação e medalhas scoring-and-badges-essentials

O recurso de pontuação e medalhas do AEM Communities identifica e recompensa os membros da comunidade.

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

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

Exibição de selos displaying-badges

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

Por exemplo, pesquisar por 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 selo foi atribuído a uma função, e o selo deve ser exibido como texto.

Se false, isAssigned indica que o selo foi concedido para uma pontuação recebida e o selo deve ser exibido como uma imagem.

Qualquer alteração nesse comportamento deve ser feita em um script personalizado (substituição ou sobreposição). Consulte Personalização no lado do cliente.

Log de depuração para pontuação e medalha debug-log-for-scoring-and-badging

Para ajudar a depurar a pontuação e o símbolo, é possível configurar um arquivo de log personalizado. O conteúdo desse arquivo de log poderá 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 log do Sling:

Para ver entradas de log:

UGC para pontuação e medalha ugc-for-scoring-and-badging

É possível exibir o UGC relacionado à pontuação e ao badging quando o SRP escolhido for JSRP ou MSRP, mas não ASRP. (Se não estiver familiarizado com esses termos, consulte Armazenamento do Conteúdo da Comunidade e Visão Geral do Provedor de Recursos de Armazenamento.)

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

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

JSRP em publicar: da mesma forma, se estiver testando no ambiente de publicação, 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 (modo de execução nosamplecontent), será necessário habilitar o CRXDE Lite.

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

APIs de pontuação e medalha scoring-and-badging-apis

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

Os Javadocs mais recentes para o pacote de recursos instalado estão disponíveis para desenvolvedores no repositório do Adobe. Consulte Uso do Maven para comunidades: Javadocs.

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

Exemplo de configuração example-setup

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

UGC de pontuação de acesso access-scoring-ugc

O uso das APIs é preferível.

Para fins investigativos, usando JSRP para o exemplo, a pasta base que contém pontuações é

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

Para o site Geometrixx Engage, 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:

Para o site de guia dos 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:

A pontuação está armazenada na propriedade scoreValue_tl que só pode conter um valor ou fazer referência indireta a um atomicCounter.

UGC de acesso a emblemas access-badging-ugc

O uso das APIs é preferível.

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

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

Selo concedido awarded-badge

Selo atribuído assigned-badge

Informações adicionais additional-information

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