Inhaltsbereitstellung content-delivery

CAUTION
AEM 6.4 hat das Ende der erweiterten Unterstützung erreicht und diese Dokumentation wird nicht mehr aktualisiert. Weitere Informationen finden Sie in unserer technische Unterstützung. Unterstützte Versionen suchen here.
NOTE
Adobe empfiehlt die Verwendung des SPA-Editors für Projekte, für die ein frameworkbasiertes Client-seitiges Rendering für einzelne Seiten (z. B. React) erforderlich ist. Weitere Informationen

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.

NOTE
Over-the-Air-Inhalt kann über ContentSync -Handler von einem der oben genannten stammen. Sie kann zum Stapelgebungs- und Versand über Zips sowie zur Wartung von Updates oder Paketen verwendet werden.

Content Services bietet drei Hauptmaterialtypen:

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

chlimage_1-154

Assets 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 asset-optimization

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 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 die Asset-Referenz-Workflow:

chlimage_1-155

Verwalten von Assets managing-assets

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

Vorhandene verwaltete Assets existing-managed-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 accessing-cs-asset-entities

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 getting-a-list-of-available-asset-entities

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.

chlimage_1-156

Abrufen eines Bildes getting-an-image

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.

Paketmäßiger HTML-Inhalt packaged-html-content

HTML-Inhalte sind für Kunden erforderlich, 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 mobilen App über die API HTML-Inhalte bereitstellen. Kunden, die AEM Inhalt als HTML verfügbar machen möchten, erstellen eine HTML-Seitenentität, die auf die AEM Inhaltsquelle verweist.

Die folgenden Optionen werden berücksichtigt:

  • Zip-Datei: Damit das gesamte referenzierte Material der Seite am besten auf dem Gerät angezeigt werden kann - 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.

chlimage_1-157

Kanalunabhängige Inhalte channel-independent-content

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 managing-channel-independent-content

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
recommendation-more-help
547b817b-14b5-4d82-aa0f-a64750e0e592