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 (Over-the-Air) und benutzerdefinierten Inhalten, die möglicherweise eine eigene Struktur aufweisen.

Content Services bietet drei Hauptmaterialtypen:

1. Assets
2. Verpackter HTML-Inhalt (HTML/CSS/JS)
3. Kanalunabhängiger Inhalt

Assets

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

Eine Asset-Sammlung kann über Content Services verfügbar gemacht werden. Der Aufruf einer Asset-Sammlung in einer Anfrage gibt ein Objekt zurück, das eine Liste der Assets einschließlich ihrer URLs ist. Der Zugriff auf Assets erfolgt über eine URL. Die URL wird in einem Objekt bereitgestellt. Beispiel:

• Eine Seitenentität gibt JSON (Seitenobjekt) zurück, das eine Bildreferenz enthält. Die Bildreferenz ist eine URL, mit der die Asset-Binärdatei für das Bild abgerufen wird.
• Eine Anfrage nach 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 Schlüsselwert von Content Services ist die Möglichkeit, Assets zurückzugeben, die für das Gerät optimiert sind. Dadurch werden die Anforderungen an die lokale Gerätespeicherung reduziert und die App-Leistung verbessert.

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

Assets-Workflow

Der Asset-Workflow sieht wie folgt aus:

1. Asset-Referenz verfügbar in AEM nativen

2. Erstellen einer Asset-Referenzentität anhand des Modells

3. Entität bearbeiten

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

Das folgende Diagramm zeigt den Asset-Referenz-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 Kanäle 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 sind diese auf das Assets-Repository verteilt. 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

Zugreifen auf CS Asset-Entitäten

Lassen wir die Schritte beiseite, die zeigen, wie die Seite zunächst über die API zur Verfügung gestellt wird (sie wird von der Beschreibung der AEM UI abgedeckt), und gehen Sie davon aus, dass sie abgeschlossen ist. Asset-Entitäten wurden erstellt und zum Bereich "appImages"hinzugefügt. Zusätzliche Ordner wurden aus organisatorischen Gründen unter dem Bereich erstellt. Daher werden die Asset-Entitäten im 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

Abrufen einer Liste der verfügbaren Asset-Entitäten

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 Web Service API SDK bereitstellen.

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

Abrufen eines Bildes

Die 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 "Warenkorb"-Bild zu erhalten, wird die Client-Bibliothek erneut verwendet.

Verpackter HTML-Inhalt

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

AEM Content Services kann der Mobile App über die API HTML-Inhalte bereitstellen. Kunden, die AEM Inhalt als HTML verfügbar machen möchten, erstellen eine HTML-Seitentität, die auf die AEM Inhaltsquelle verweist.

Die folgenden Optionen werden berücksichtigt:

• ZIP-Datei: Damit die beste Möglichkeit besteht, das gesamte referenzierte Material der Seite ordnungsgemäß auf dem Gerät anzuzeigen - CSS, JavaScript, Assets usw. - wird in einer einzelnen komprimierten Datei mit der Antwort enthalten sein. Die Verweise auf der HTML-Seite werden angepasst, um einen relativen Pfad zu diesen Dateien zu verwenden.
• Streaming: Abrufen eines Manifests der erforderlichen Dateien von AEM. Verwenden Sie dann dieses Manifest, um alle Dateien (HTML, CSS, JS usw.) anzufordern. mit nachfolgenden Anfragen.

Kanalunabhängiger Inhalt

Kanalunabhängiger Inhalt ist eine Möglichkeit, AEM Inhaltskonstrukte - wie z. B. Seiten - verfügbar zu machen, ohne sich um Layout, Komponenten oder andere kanalspezifische 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 zu den Daten des Inhalts, die vom AEM Repository entkoppelt sind. Dazu gehören die Rückgabe von Metadaten und AEM Referenzlinks zu Assets sowie die Beziehungen zwischen Inhaltsstrukturen - einschließlich der Entitätshierarchie.

Verwalten von kanalunabhängigen Inhalten

Inhalte können auf verschiedene Arten in die App gelangen.

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

   • Content Sync-Handler können das ZIP-Paket direkt aktualisieren oder vorhandene Content-Renderer aufrufen

     • Platform-Handler
     • AEM-Handler
     • Benutzerdefinierte Handler

2. GET direkt über Content Renderer

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