Show Menu
TÓPICOS×

Essenciais de pontuação e emblemas

O recurso de pontuação e selo do AEM Communities fornece 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 :
A estrutura de implementação visível no CRXDE Lite está sujeita a alterações.

Exibição de emblemas

Se um crachá é exibido como texto ou imagem é controlado no lado do cliente no modelo HBS.
Por exemplo, pesquise 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 lado 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 suporte de log do console da Web do Adobe Experience Manager, por exemplo
    • https://localhost:4502/system/console/slinglog
  2. Selecione Adicionar novo agente de log
    1. Selecionar DEBUG para o Nível de Log
    2. Digite um nome para Arquivo de log, por exemplo
      • logs/scoring-debug.log
    3. Digite duas entradas do 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
    • Selecionar arquivos de registro
    • 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 Crachá

É possível visualizar o UGC relacionado à pontuação e à identificação quando o SRP escolhido é JSRP ou MSRP, mas não ASRP. (Se não estiver familiarizado com esses termos, consulte Community Content Storage and Storage Resource Provider Overview .)
As descrições para acessar dados de pontuação e marcação usam o JSRP, já que o UGC é facilmente acessível usando o CRXDE Lite .
JSRP no autor : experimentar no ambiente do autor resulta em UGC que é visível apenas do ambiente do autor.
JSRP ao 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 (nosamplecontent runmode), será necessário ativar o CRXDE Lite .
A localização básica 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 mais recentes Javadocs para o pacote de recursos instalados estão disponíveis para desenvolvedores do repositório da 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 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 diferentes do AEM:
  1. Um site do AEM com uma ID exclusiva (site da comunidade criado usando o assistente):
    • Usar 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 do AEM sem uma id exclusiva:
    • Uso do guia 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" https://localhost:4503/home/users/community/w271OOup2Z4DjnOQrviv/profile.social.json
    
    
    Como um usuário ganhou dois crachás de bronze e recebeu um crachá de moderador, é assim que o usuário aparece com sua entrada no fórum.
Este exemplo não segue essas práticas recomendadas:
  • Os nomes das regras de pontuação devem ser globalmente exclusivos; não devem terminar com o mesmo nome. Um exemplo do que não fazer: /etc/community/scoring/rules/site1/forums-scoring /etc/community/scoring/rules/site2/forums-scoring
  • Criar imagens de crachá exclusivas para sites do AEM diferentes

Acesse a Pontuação UGC

O uso das APIs é preferido.
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 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 indiretamente se referir a um atomicCounter.

UGC da marca de acesso

O uso das APIs é preferido.
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/usergenerated/asi/jcr
Seguido pelo caminho para o perfil do usuário, terminando em uma pasta de crachás, como
  • /home/users/community/w271OOup2Z4DjnOQrviv/profile/badges

Crachá concedido

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.