Inhaltsbereitstellung

Mobile Apps sollten nach Bedarf alle Inhalte in AEM verwenden können, um das Targeting-App-Erlebnis bereitzustellen.

Dazu gehören die Verwendung von Assets, Site-Inhalten, CaaS-Inhalten (über die Luft) und benutzerspezifischen Inhalten, die möglicherweise eine eigene Struktur haben.

Content Services bietet drei Hauptmaterialtypen:

1. Assets
2. Verpackte HTML-Inhalte (HTML/CSS/JS)
3. Unabhängiger Kanal

Assets

Asset-Sammlungen sind AEM Konstrukte, die Verweise auf andere Sammlungen enthalten.

Eine Asset-Sammlung kann über Content Services bereitgestellt werden. Beim Aufrufen einer Asset-Sammlung in einer Anforderung wird ein Objekt zurückgegeben, das eine Liste der Assets einschließlich ihrer URLs darstellt. Assets werden über eine URL aufgerufen. Die URL wird in einem Objekt bereitgestellt. Beispiel:

• Eine Seitenentität gibt JSON (Seitenobjekt) zurück, das einen Bildverweis enthält. Die Bildreferenz ist eine URL, mit der die Asset-Binärdatei für das Bild abgerufen wird.
• Eine Anforderung einer Liste von Assets in einem Ordner gibt JSON mit Details zu allen Entitäten in diesem Ordner zurück. Diese Liste ist ein Objekt. Die JSON-Datei enthält URL-Verweise, die verwendet werden, um die Asset-Binärdatei für jedes Asset in diesem Ordner abzurufen.

Asset-Optimierung

Ein wichtiger Wert von Content Services ist die Möglichkeit, Assets zurückzugeben, die für das Gerät optimiert sind. Dadurch werden die Anforderungen an die Datenspeicherung lokaler Geräte verringert und die App-Performance verbessert.

Die Asset-Optimierung ist eine serverseitige Funktion, die auf den in der API-Anforderung bereitgestellten Informationen basiert. Wo immer möglich, sollten die Asset-Darstellungen zwischengespeichert werden, damit ähnliche Anforderungen keine erneute Generierung der Asset-Darstellung erfordern.

Asset-Workflow

Der Asset-Arbeitsablauf lautet wie folgt:

1. Asset-Referenz im Lieferumfang AEM

2. Asset-Referenzentität nach ihrem Modell erstellen

3. Entität bearbeiten

   1. Asset oder Asset-Sammlung auswählen
   2. JSON-Rendering anpassen

Das folgende Diagramm zeigt den Asset Reference Workflow:

Verwalten von Assets

Content Services bieten Zugriff auf AEM verwalteten Assets, auf die möglicherweise nicht über andere AEM verwiesen wird.

Vorhandene verwaltete Assets

Ein bestehender AEM Sites- und Assets-Benutzer verwendet AEM Assets, um alle digitalen Inhalte für alle Kanal zu verwalten. Sie entwickeln eine native mobile App und müssen mehrere Assets verwenden, die von AEM Assets verwaltet werden. Zum Beispiel Logos, Hintergrundbilder, Schaltflächensymbole usw.

Derzeit befinden sich diese im Assets-Repository. Die Dateien, auf die die App verweisen muss, befinden sich in:

• /content/dam/geometrixx-outdoors/brand/logo_light.png
• /content/dam/geometrixx-outdoors/brand/logo_dark.png
• /content/dam/geometrixx-outdoors/styles/backgrounds/gray_blue.jpg
• /content/dam/geometrixx-outdoors/brand/icons/app/cart.png
• /content/dam/geometrixx-outdoors/brand/icons/app/home.png

Zugriff auf CS Asset Entities

Lassen wir die Schritte beiseite, wie die Seite jetzt über die API zur Verfügung gestellt wird (sie wird durch die Beschreibung der AEM Benutzeroberfläche abgedeckt), und gehen davon aus, dass sie bereits erfolgt ist. Asset-Entitäten wurden erstellt und dem Bereich "appImages"hinzugefügt. Weitere Ordner wurden aus organisatorischen Gründen unter dem Raum erstellt. Die Asset-Entitäten werden also in der AEM JCR wie folgt gespeichert:

• /content/entity/appImages/logos/logo_light
• /content/entity/appImages/logos/logo_dark
• /content/entity/appImages/bkgnd/gray_blue
• /content/entity/appImages/icons/cart
• /content/entity/appImages/icons/home

Liste der verfügbaren Asset-Entitäten abrufen

Ein App-Entwickler kann eine Liste der verfügbaren Assets abrufen, indem er die Asset-Entitäten abruft. Der Leerzeichen-Endpunkt von Content Services kann diese Informationen über das Webdienst-API-SDK bereitstellen.

Das Ergebnis wäre ein Objekt im JSON-Format, das eine Liste der Assets im Ordner "icons"bereitstellt.

Abrufen eines Bildes

Das JSON stellt für jedes Bild eine URL bereit, die von Content Services für das Bild generiert wird.

Um die Binärdatei für das Bild "Einkaufswagen"zu erhalten, wird die Client-Bibliothek erneut verwendet.

HTML-Inhalt im Paket

HTML-Inhalte werden für Kunden benötigt, die das Layout der Inhalte beibehalten müssen. Dies ist nützlich für native Anwendungen, die einen Web-Container (z. B. eine Cordova-Webansicht) verwenden, um den Inhalt anzuzeigen.

AEM Content Services kann HTML-Inhalte über die API für die mobile App bereitstellen. Kunden, die AEM Inhalte als HTML bereitstellen möchten, erstellen eine HTML-Seitenentität, die auf die AEM Inhaltsquelle verweist.

Die folgenden Optionen werden in Betracht gezogen:

• Zip-Datei: Damit alle referenzierten Elemente der Seite am besten auf dem Gerät korrekt angezeigt werden können - CSS, JavaScript, Assets usw. - wird in einer einzelnen komprimierten Datei mit der Antwort enthalten. Die Verweise auf der HTML-Seite werden angepasst, um einen relativen Pfad zu diesen Dateien zu verwenden.
• Streaming: Abrufen eines Manifests der erforderlichen Dateien aus AEM. Verwenden Sie dieses Manifest dann, um alle Dateien (HTML, CSS, JS usw.) anzufordern. mit nachfolgenden Anforderungen.

Unabhängiger Kanal

Kanal-unabhängige Inhalte sind eine Möglichkeit, AEM Inhaltskonstrukte - wie z. B. Seiten - offen zu legen, ohne sich um Layout-, Komponenten- oder andere Kanal-spezifische Informationen zu sorgen.

Diese Inhaltsentitäten werden mithilfe eines Inhaltsmodells generiert, um die AEM Strukturen in ein JSON-Format zu übersetzen. Die resultierenden JSON-Daten enthalten Informationen über die Daten des Inhalts, die vom AEM-Repository entkoppelt werden. Dazu gehören die Rückgabe von Metadaten und AEM Referenz-Links zu Assets sowie die Beziehungen zwischen Inhaltsstrukturen - einschließlich der Entitätshierarchie.

Verwalten unabhängiger Kanal

Inhalte können auf verschiedene Weise zur App gelangen.

1. GET content ZIPS über AEM Over-the-Air

   • Content Sync-Handler können das ZIP-Paket direkt oder durch Aufruf vorhandener Inhalts-Renderer aktualisieren

     • Plattformhandler
     • AEMM-Handler
     • Benutzerdefinierte Handler

2. GET direkt über Content Renderer

   • Vordefinierte Standard-Sling-Renderer
   • AEM Mobile/Content Services Content Renderer
   • Benutzerdefinierte Wiedergabe