Documentazione AEM 6.5 Guida di Communities

Panoramica del provider di risorse di archiviazione

5 maggio 2025

Si applica a:
Experience Manager 6.5

Argomenti:
Communities

Creato per:

Amministratore

Introduzione

A partire da Adobe Experience Manager (AEM) Communities 6.1, il contenuto della community, comunemente denominato User-generated content (UGC), viene archiviato in un unico archivio comune fornito da un provider di risorse di archiviazione (SRP).

Sono disponibili diverse opzioni SRP, tutte per accedere a UGC tramite una nuova interfaccia AEM Communities, l'API SocialResourceProvider (API SRP), che include tutte le operazioni di creazione, lettura, aggiornamento ed eliminazione (CRUD).

Tutti i componenti SCF vengono implementati utilizzando l'API SRP, consentendo lo sviluppo del codice senza conoscere la topologia sottostante 1} o la posizione di UGC.

L'API SocialResourceProvider è disponibile solo per i clienti con licenza di AEM Communities.

NOTE

Componenti personalizzati: per i clienti con licenza di AEM Communities, l'API SRP è disponibile per gli sviluppatori di componenti personalizzati per l'accesso a UGC indipendentemente dalla topologia sottostante. Consulta SRP e UGC Essentials.

Consulta anche:

SRP e UGC Essentials - Metodi ed esempi dell'utilità SRP.
Accesso a UGC con SRP - Linee guida per la codifica.
Refactoring di SocialUtils - Mappatura dei metodi di utilità obsoleti ai metodi di utilità SRP correnti.

Informazioni sull’archivio

Per comprendere i criteri SRP, è utile comprendere il ruolo dell’archivio dell’AEM (Oak) in un sito della community AEM.

Archivio dei contenuti Java™ (JCR)
Questo standard definisce un modello dati e un'interfaccia di programmazione dell'applicazione (API JCR) per gli archivi di contenuti. Combina le caratteristiche dei file system convenzionali con quelle dei database relazionali e aggiunge diverse funzioni aggiuntive di cui le applicazioni di contenuti hanno spesso bisogno.

Un’implementazione del JCR è l’archivio dell’AEM, Oak.

Apache Jackrabbit Oak
Oak è un'implementazione di JCR 2.0 che è un sistema di archiviazione dei dati progettato per applicazioni incentrate sui contenuti. Si tratta di un tipo di database gerarchico progettato per i dati non strutturati e semistrutturati. L’archivio memorizza non solo il contenuto rivolto all’utente, ma anche tutto il codice, i modelli e i dati interni utilizzati dall’applicazione. L'interfaccia utente per l'accesso al contenuto è CRXDE Liti.

Sia JCR che Oak vengono in genere utilizzati per fare riferimento all’archivio AEM.

Dopo aver sviluppato il contenuto del sito nell’ambiente di authoring privato, deve essere copiato nell’ambiente di pubblicazione pubblico. Questa operazione viene spesso eseguita tramite un'operazione denominata replica. Questo accade sotto il controllo dell’autore/sviluppatore/amministratore.

Per UGC, il contenuto viene immesso dai visitatori del sito registrati (membri della community) nell’ambiente di pubblicazione pubblico. Questo succede in modo casuale.

A scopo di gestione e reporting, è utile avere accesso a UGC dall’ambiente di authoring privato. Con SRP, l’accesso a UGC da Author è più coerente ed efficiente, in quanto non è necessaria la replica inversa da Publish a Author.

Informazioni su SRP

Quando UGC viene salvato nello storage condiviso, esiste una singola istanza di contenuto membro a cui è possibile accedere, nella maggior parte delle implementazioni, sia dagli ambienti di authoring che da quelli di pubblicazione. Indipendentemente dalla scelta SRP (MSRP, ASRP, JSRP), tutto deve essere accessibile a livello di programmazione con l’API SRP.

NOTE

Per il codice di esempio e ulteriori dettagli, consulta SRP e UGC Essentials.

Consulta Accesso a UGC con SRP per le best practice per la codifica.

ASRP

Se è presente ASRP, UGC non viene memorizzato in JCR, ma in un servizio cloud ospitato e gestito da Adobe. Le UGC memorizzate in ASRP potrebbero non essere visualizzate con CRXDE Lite o non essere accessibili utilizzando l’API JCR.

Vedere ASRP - Provider risorse di archiviazione Adobe.

Non è possibile per gli sviluppatori accedere direttamente all’UGC.

ASRP utilizza Adobe Cloud per le query.

MSRP

Se è presente, MSRP, UGC non è memorizzato in JCR, ma in MongoDB. Le UGC memorizzate in MSRP potrebbero non essere visualizzate con CRXDE Lite o non essere accessibili utilizzando l’API JCR.

Vedere MSRP - Provider risorse di archiviazione MongoDB.

Anche se MSRP è paragonabile ad ASRP, poiché tutte le istanze del server AEM accedono allo stesso UGC, è possibile utilizzare strumenti comuni per accedere direttamente al UGC memorizzato in MongoDB.

MSRP utilizza Solr per le query.

JSRP

JSRP è il provider predefinito per l’accesso a tutti i contenuti generati dagli utenti su una singola istanza AEM. Consente di utilizzare rapidamente AEM Communities 6.1 senza la necessità di configurare MSRP o ASRP.

Vedi JSRP - Provider risorsa di archiviazione JCR.

Se è presente JSRP mentre UGC è memorizzato in JCR ed è accessibile nelle API CRXDE Liti e JCR, l’Adobe consiglia di non utilizzare mai l’API JCR a tale scopo. In tal caso, le modifiche future potrebbero influire sul codice personalizzato.

Inoltre, l’archivio per gli ambienti Author e Publish non è condiviso. Sebbene un cluster di istanze di pubblicazione generi un archivio di pubblicazione condiviso, l’UGC immesso in Publish non è visibile nell’ambiente Author, pertanto non è possibile gestirlo dall’ambiente Author. L’UGC viene mantenuto solo nell’archivio AEM (JCR) dell’istanza in cui è stato inserito.

JSRP utilizza gli indici Oak per le query.

Informazioni sui nodi ombra in JCR

I nodi shadow, che imitano il percorso di UGC, esistono nell’archivio locale per due scopi:

Controllo degli accessi (ACL)
Risorse non esistenti (NER)

Indipendentemente dall'implementazione SRP, l'UGC effettivo è non visibile nella stessa posizione del nodo shadow.

Per il controllo degli accessi (ACL)

Alcune implementazioni SRP, come ASRP e MSRP, memorizzano il contenuto della community in database che non forniscono alcuna verifica ACL. I nodi shadow forniscono una posizione nell’archivio locale a cui possono essere applicati gli ACL.

Utilizzando l'API SRP, tutte le opzioni SRP eseguono lo stesso controllo della posizione ombra prima di tutte le operazioni CRUD.

Il controllo ACL utilizza un metodo di utilità che restituisce un percorso adatto per la verifica delle autorizzazioni applicate all’UGC della risorsa.

Per il codice di esempio, consulta SRP e UGC Essentials.

Per le risorse non esistenti (NER)

Alcuni componenti di Communities sono inclusi in uno script e quindi richiedono un nodo indirizzabile Sling per supportare le funzioni di Communities. I componenti inclusi sono denominati risorse non esistenti (NER).

I nodi shadow forniscono una posizione indirizzabile Sling nell’archivio.

CAUTION

Poiché il nodo shadow ha più utilizzi, la presenza di un nodo shadow not implica che il componente sia un NER.

Percorso di archiviazione

Di seguito è riportato un esempio di nodo shadow che utilizza il componente Commenti nella Guida ai componenti della community:

Il componente esiste nell’archivio locale in:

/content/community-components/en/comments/jcr:content/content/includable/comments
Il nodo shadow corrispondente esiste nell’archivio locale in:

/content/usergenerated/content/community-components/en/comments/jcr:content/content/includable/comments

Nessun UGC trovato nel nodo shadow.

Il comportamento predefinito consiste nell’impostare nodi shadow in un’istanza Publish ogni volta che si fa riferimento alla sottostruttura pertinente per una lettura o una scrittura.

Si supponga, ad esempio, che la distribuzione sia MSRP con una farm di pubblicazione TarMK.

Quando un membro pubblica un UGC su pub1 (memorizzato in MongoDB), vengono creati nodi shadow in JCR su pub1.

La prima volta che l'UGC viene letto su pub2, se non viene configurato nulla, il comportamento predefinito consiste nel creare i nodi ombra.

Per un comportamento diverso da quello predefinito, è necessario impostarlo sull’istanza di authoring e riportarlo a tutte le istanze di pubblicazione, solitamente un processo manuale.

recommendation-more-help