Esenciales de puntuación y distintivos

La función de puntuación y distintivos de AEM Communities permite identificar y premiar a los miembros de la comunidad.

Los detalles de la configuración de la función se describen en

Esta página contiene detalles técnicos adicionales:

ATENCIÓN

La estructura de implementación visible en el CRXDE Lite está sujeta a cambios.

Visualización de distintivos

Indica si un distintivo se muestra como texto o como imagen y se controla en el lado del cliente en la plantilla HBS.

Por ejemplo, busque this.isAssigned en /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}}

Si es true, isAssigned indica que el distintivo se asignó a una función y que el distintivo debe mostrarse como texto.

Si es false, is Assigned indica que el distintivo se ha concedido para una puntuación ganada y que el distintivo debe mostrarse como una imagen.

Cualquier cambio en este comportamiento se debe realizar en una secuencia de comandos personalizada (ya sea sobrescribir o superponer). Consulte Personalización del cliente.

Registro de depuración para Puntuación e Insignia

Para ayudar a depurar la puntuación y el distintivo, se puede configurar un archivo de registro personalizado. El contenido de este archivo de registro se puede proporcionar a la asistencia al cliente si se producen problemas con la función.

Para obtener instrucciones detalladas, visite Crear un archivo de registro personalizado.

Para configurar rápidamente un archivo de registro de inclinación:

  1. Acceda a la Compatibilidad con el registro de la consola web de Adobe Experience Manager, por ejemplo

    • http://localhost:4502/system/console/slinglog
  2. Seleccione Añadir nuevo registrador

    1. Seleccione DEBUG para Nivel de registro

    2. Escriba un nombre para Archivo de registro, por ejemplo

      • logs/scoring-debug.log
    3. Introduzca dos entradas Logger (clase) (con el icono +)

      • com.adobe.cq.social.scoring
      • com.adobe.cq.social.badging
    4. Seleccione Guardar

chlimage_1-247

Para ver las entradas de registro:

  • Desde la consola web

    • En el menú Estado
    • Seleccione Archivos de registro
    • Busque el nombre del archivo de registro, como scoring-debug
  • En el disco local del servidor

    • El archivo de registro se encuentra en <server-install-dir>/crx-quickstart/logs/<log-file-name>.log.
    • Por ejemplo, .../crx-quickstart/logs/scoring-debug.log

chlimage_1-249

UGC para Puntuación e Insignia

Es posible realizar una vista del UGC en relación con la puntuación y la insignia cuando el SRP elegido sea JSRP o MSRP, pero no ASRP. (Si no está familiarizado con estos términos, consulte Almacenamiento de contenido de la comunidad y Información general del proveedor de recursos de Almacenamiento).

Las descripciones para acceder a los datos de puntuación y marca utilizan JSRP, ya que el UGC es fácilmente accesible mediante CRXDE Lite.

JSRP del autor: experimentar en el entorno del autor resulta en UGC que solo es visible desde el entorno del autor.

JSRP al publicar: del mismo modo, si realiza pruebas en el entorno de publicación, será necesario acceder a CRXDE Lite con privilegios de administrador en una instancia de publicación. Si la instancia de publicación se está ejecutando en modo de producción (nosamplecontent runmode), será necesario habilitar CRXDE Lite.

La ubicación base de UGC en JSRP es /content/usergenerated/asi/jcr/.

API de Puntuación y Badging

Las siguientes API están disponibles para su uso:

Los últimos Javadocs para las versiones instaladas están disponibles para los desarrolladores desde el repositorio de Adobe. Consulte Uso de Maven para comunidades: Javadocs.

La ubicación y el formato del UGC en el repositorio están sujetos a cambios sin previo aviso.

Ejemplo de configuración

Las capturas de pantalla de los datos del repositorio provienen de la configuración de la puntuación y la identificación para un foro en dos sitios de AEM diferentes:

  1. Un sitio AEM con un identificador único (sitio de comunidad creado mediante un asistente):

    • Uso del sitio Tutorial de introducción (participación) creado durante el tutorial de introducción

    • Localizar el nodo de la página del foro

      • /content/sites/engage/en/forum/jcr:content
    • Añadir las propiedades de puntuación y marca

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

    • Localización del nodo del componente del foro

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

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

    • Añadir propiedad para mostrar distintivos

      • allowBadges = true
    • Un usuario inicia sesión, crea un tema del foro y recibe una insignia de bronce

  2. Un sitio AEM sin un identificador único:

    • Uso de la guía Community Components

    • Localizar el nodo de la página del foro

      • /content/community-components/en/forum/jcr:content
    • Añadir las propiedades de puntuación y marca

      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]
      
    • Localización del nodo del componente del foro

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

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

    • Añadir propiedad para mostrar distintivos

      • allowBadges = true
    • Un usuario inicia sesión, crea un tema del foro y recibe una insignia de bronce

  3. A un usuario se le asigna una insignia de moderador mediante 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 un usuario ha obtenido dos insignias de bronce y ha recibido una insignia de moderador, así es como aparece el usuario con su entrada en el foro:

chlimage_1-250

NOTA

Este ejemplo no sigue estas optimizaciones:

  • los nombres de las reglas de puntuación deben ser globalmente únicos; no deben terminar con el mismo nombre.
    Un ejemplo de lo que no debe hacer:
    /etc/community/scoring/rules/site1/forums-scoring
    /etc/community/scoring/rules/site2/forums-scoring

  • creación de imágenes de distintivo únicas para distintos sitios de AEM

Acceso a UGC de Puntuación

Se prefiere el uso de las API.

Para fines de investigación, con JSRP por ejemplo, la carpeta base que contiene puntuaciones es

  • /content/usergenerated/asi/jcr/scoring

El nodo secundario de scoringes el nombre de la regla de puntuación. Por lo tanto, una práctica recomendada es que los nombres de las reglas de puntuación en un servidor sean globalmente únicos.

Para el sitio de participación en la Geometrixx, el usuario y su puntuación se encuentran en una ruta con el nombre de la regla de puntuación, la identificación del sitio de la comunidad ( engage-ba81p), una identificación única y la identificación del usuario:

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

Para el sitio de la guía de componentes de comunidad, el usuario y su puntuación se encuentran en una ruta construida con el nombre de la regla de puntuación, una identificación predeterminada ( default-site), una identificación única y la identificación del usuario:

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

La puntuación se almacena en la propiedad scoreValue_tl, que puede contener un valor directamente o hacer referencia indirectamente a atomicCounter.

chlimage_1-251

Acceso a la insignia UGC

Se prefiere el uso de las API.

Para fines de investigación, con JSRP por ejemplo, la carpeta base que contiene información sobre las insignias asignadas o adjudicadas es

  • /content/usergenerate/asi/jcr

Seguido de la ruta al perfil del usuario, finalizando en una carpeta de distintivos, como

  • /home/users/community/w271OOup2Z4DjnOQrviv/perfil/badges

Insignia otorgada

chlimage_1-252

distintivo asignado

chlimage_1-253

Información adicional

Para mostrar una lista ordenada de miembros basada en puntos:

  • Función de tabla de clasificación para incluirla en un sitio de comunidad o en una plantilla de grupo.
  • Componente de tabla de clasificación, el componente destacado de la función Mesa de clasificación, para la creación de páginas.

En esta página