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

• Pontuação das comunidades e emblemas

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

• Como exibir um crachá como imagem ou texto
• Como ativar registro de depuração extenso
• Como acessar UGC relacionado à pontuação e marcação

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

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

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:

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

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:

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.

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

crachá atribuído

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.

Recursos do Business.Adobe.com

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