Diffusion de contenu content-delivery
Les applications mobiles doivent pouvoir utiliser tout le contenu d’AEM si nécessaire pour offrir l’expérience d’application ciblée.
Cela inclut l’utilisation de ressources, de contenu de site, de contenu CaS (en direct) et de contenu personnalisé pouvant avoir sa propre structure.
Content Services fournit trois types principaux de contenu :
- Assets
- Contenu HTML compressé (HTML/CSS/JS)
- Contenu indépendant des canaux
Ressources assets
Les collections de ressources sont des éléments AEM qui contiennent des références à d’autres collections.
Une collection de ressources peut être exposée via Content Services. L’appel d’une collection de ressources dans une requête renvoie un objet qui est une liste des ressources, y compris leurs URL. Assets est accessible via une URL. L’URL est fournie dans un objet . Par exemple :
- Une entité de page renvoie le fichier JSON (objet de page) qui comprend une référence d’image. La référence d’image est une URL utilisée pour obtenir le binaire de ressource de l’image.
- Une requête pour obtenir une liste des ressources d’un dossier renvoie le fichier JSON avec des détails sur toutes les entités de ce dossier. Cette liste est un objet. Le fichier JSON comporte des références d’URL qui sont utilisées pour obtenir le binaire de ressource pour chaque ressource de ce dossier.
Optimisation des ressources asset-optimization
L’une des principales valeurs de Content Services est la possibilité de renvoyer des ressources optimisées pour l’appareil. Cela réduit les besoins de stockage de l’appareil local et améliore les performances de l’application.
L’optimisation des ressources est une fonction côté serveur, basée sur les informations fournies dans la requête API. Dans la mesure du possible, les rendus de ressource doivent être mis en cache de sorte que des requêtes similaires ne nécessitent pas de régénération du rendu de ressource.
Processus Assets assets-workflow
Le workflow de la ressource est le suivant :
-
Référence des ressources disponible dans AEM d’usine
-
Création d’une entité de référence de ressource selon son modèle
-
Modifier l’entité
- Sélection d’une ressource ou d’une collection de ressources
- Personnalisation du rendu JSON
Le diagramme suivant montre le processus de référence Assets :
Gestion des ressources managing-assets
Content Services permet d’accéder à des ressources gérées AEM qui ne peuvent pas être référencées via d’autres contenus AEM.
Assets géré existant existing-managed-assets
Un utilisateur d’AEM Sites et d’Assets utilise AEM Assets pour gérer l’ensemble de son contenu numérique pour tous les canaux. Ils développent une application mobile native et doivent utiliser plusieurs ressources gérées par AEM Assets. Par exemple, logos, images d’arrière-plan et icônes de bouton.
Actuellement, elles sont réparties dans le référentiel Assets. Les fichiers que l’application doit référencer sont les suivants :
- /content/dam/geometrixx-outdoors/brand/logo_light.png
- /content/dam/geometrixx-outdoors/brand/logo_dark.png
- /content/dam/geometrixx-outdoors/styles/backgrounds/grey_blue.jpg
- /content/dam/geometrixx-outdoors/brand/icons/app/cart.png
- /content/dam/geometrixx-outdoors/brand/icons/app/home.png
Accès aux entités de ressources CS accessing-cs-asset-entities
Mettons de côté les étapes de mise à disposition de la page via l’API pour l’instant (elle est couverte par la description de l’interface utilisateur d’AEM) et supposons qu’elle a été effectuée. Les entités de ressources ont été créées et ajoutées à l’espace "appImages". D’autres dossiers ont été créés sous l’espace à des fins d’organisation. Ainsi, les entités de ressources sont stockées dans le JCR AEM comme suit :
- /content/entities/appImages/logos/logo_light
- /content/entities/appImages/logos/logo_dark
- /content/entities/appImages/bkgnd/dark_blue
- /content/entities/appImages/icons/cart
- /content/entities/appImages/icons/home
Obtention d’une liste des entités de ressources disponibles getting-a-list-of-available-asset-entities
Un développeur d’applications peut obtenir une liste des ressources disponibles en récupérant les entités de ressources. Le point d’entrée de l’espace Content Services peut fournir ces informations par le biais du SDK de l’API du service Web.
Le résultat serait un objet au format JSON qui fournirait une liste des ressources du dossier "icons".
Obtention d’une image getting-an-image
Le fichier JSON fournit une URL pour chaque image générée par Content Services à l’image.
Pour obtenir le binaire de l’image "panier", la bibliothèque cliente est de nouveau utilisée.
Contenu des HTMLS compressés packaged-html-content
Le contenu de l’HTML est nécessaire pour les clients qui doivent conserver la mise en page du contenu. Cela s’avère utile pour les applications natives qui utilisent un conteneur web (un affichage web Cordova, par exemple) pour afficher le contenu.
AEM Content Services fournit du contenu d’HTML à l’application mobile au moyen de l’API. Les clients qui souhaitent exposer AEM contenu comme HTML peuvent créer une entité de page d’HTML qui pointe vers la source de contenu AEM.
Les options suivantes sont prises en compte :
- Fichier zip : Pour avoir la meilleure chance de s’afficher correctement sur l’appareil, les fichiers css de contenu, JavaScript, ressources référencés de la page sont inclus dans un seul fichier compressé avec la réponse. Les références de la page d’HTML peuvent être ajustées afin d’utiliser un chemin relatif vers ces fichiers.
- Diffusion en continu : Obtention d’un manifeste des fichiers requis à partir d’AEM. Utilisez ensuite ce manifeste pour demander tous les fichiers (HTML, CSS, JS, etc.) avec les requêtes suivantes.
Contenu indépendant du canal channel-independent-content
Le contenu indépendant d’un canal est un moyen d’exposer les éléments de contenu AEM, tels que les pages, sans se soucier de la mise en page, des composants ou d’autres informations spécifiques à un canal.
Ces entités de contenu sont générées à l’aide d’un modèle de contenu afin de traduire les structures AEM au format JSON. Les données JSON résultantes contiennent des informations sur les données du contenu qui sont découplées du référentiel AEM. Cela inclut le renvoi de métadonnées et de liens de référence d’AEM aux ressources et les relations entre les structures de contenu, y compris la hiérarchie des entités.
Gestion du contenu indépendant du canal managing-channel-independent-content
Le contenu peut accéder à l’application de plusieurs façons.
-
GET de contenu ZIPS par le biais d'AEM en vol
-
Les gestionnaires de synchronisation de contenu peuvent mettre à jour directement le package zip ou en appelant les rendus de contenu existants.
- Gestionnaire de plateformes
- Gestionnaires d’AEM
- Gestionnaires personnalisés
-
-
GET du contenu directement par le biais des rendus de contenu
- Rendu Sling par défaut prêt à l’emploi
- Rendu de contenu AEM Mobile/Content Services
- Rendu personnalisé