Skip to the content
Documentation
Help Start
Reading in:
  • German: 9,110 of 9,110 pages
About the help in other languages
All help pages

Synchronisation und Offline-Lesen

Einen Teil einer Exponential-Website auf einem Gerät ohne Netz lesbar halten - auswählen, was synchronisiert wird, eine vollständige und eine inkrementelle Synchronisation mit der Route list und dateModified…

Download as PDF

Address: https://doc.exponential.earth/exphelp/viewer/help/mobile-app-developers/offline-and-performance/syncing-and-offline-reading.md

On this page

This page is a translation. Read the English original

Synchronisation und Offline-Lesen

Diese Seite richtet sich an App-Entwickler, deren App offline funktionieren muss: ein Leitfaden für den Außeneinsatz, ein Katalog für den Vertrieb, ein Handbuch auf einem Schiff. Exponential hat keinen Änderungs-Feed für den ganzen Baum, daher synchronisiert die App mit den vorhandenen Routen, was sie braucht. Der Entwurf unten ist ein Vorschlag, der auf diesen Routen aufbaut.

Inhalt

  1. Auswählen, was synchronisiert wird
  2. Die erste vollständige Synchronisation
  3. Inkrementelle Synchronisationen
  4. Entfernte Elemente
  5. Offline vorgenommene Schreibzugriffe

Auswählen, was synchronisiert wird

Synchronisieren Sie Ordner, nicht die Website: einen oder wenige Teilbäume, die die App zeigt, mit dem Website-Team per Remote-ID vereinbart (Knoten-IDs, Remote-IDs und Deep Links). Legen Sie fest, welchen Bildalias Sie je Element speichern, und lassen Sie Originale weg.

Die erste vollständige Synchronisation

Für jeden synchronisierten Ordner:

  1. Blättern Sie durch GET /api/ezp/v2/content/node/<id>/list/offset/<n>/limit/50?ResponseGroups=Fields, bis offset den Wert metadata.childrenCount erreicht (Unterknoten auflisten und Paginierung).
  2. Wiederholen Sie das für jeden Unterknoten, der selbst ein Container ist, den die App zeigt.
  3. Holen Sie je Bild eine Alias-URL (expimage::url) und laden Sie die Dateien herunter.
  4. Speichern Sie nodeId, dateModified und die Antwort; merken Sie sich, wann die Synchronisation begonnen hat.

Inkrementelle Synchronisationen

WegWieErfasst
Nach Änderung sortieren.../list/offset/0/limit/50/sort/modified/desc, beim ersten Element mit dateModified vor der letzten Synchronisation aufhörenneue und geänderte direkte Unterknoten
expnode::modifiedSince::<node id>::<timestamp or date>::<limit>::<offset>die Remote-Dienste, unterhalb eines Knotens in beliebiger TiefeElemente, die seit diesem Zeitpunkt veröffentlicht wurden: Der Dienst filtert nach dem Veröffentlichungsdatum (published >=), Bearbeitungen älterer Elemente sind also nicht enthalten
childrenCount vergleichenGET .../childrenCountdass etwas hinzugekommen oder entfernt worden ist, günstig

Für geänderte Elemente tiefer im Baum kombinieren Sie: modifiedSince für neue Elemente und je synchronisiertem Ordner eine nach Änderung sortierte Liste für Bearbeitungen.

Entfernte Elemente

Ein entferntes Element verschwindet einfach aus den Listen. Sie erkennen es an:

  • einem 404, wenn die App ein zwischengespeichertes Detail liest; löschen Sie es dann lokal;
  • einem childrenCount, der kleiner ist als die Zahl der lokalen Unterknoten; lesen Sie dann die Knoten-IDs des Ordners erneut (eine Liste ohne Fields ist leicht) und löschen Sie die, die verschwunden sind.

Elemente, die vor dem Benutzer der App verborgen oder aus dem synchronisierten Ordner verschoben wurden, sehen aus Sicht der App genauso aus wie entfernte.

Offline vorgenommene Schreibzugriffe

  • Stellen Sie Schreibzugriffe auf dem Gerät mit allem in eine Warteschlange, was nötig ist, um sie später zu senden.
  • Geben Sie jedem wartenden Anlegen eine auf dem Gerät erzeugte remote_id und senden Sie sie mit expnode::create: Bricht die Verbindung ab, nachdem der Server veröffentlicht hat, antwortet die Wiederholung mit 409, statt ein Duplikat anzulegen (Über expservices schreiben).
  • Senden Sie wartende Schreibzugriffe einzeln und der Reihe nach, wenn das Gerät online ist; halten Sie die Warteschlange bei 401 an und bitten Sie den Benutzer, sich anzumelden.
  • Offline vorgenommene Aktualisierungen können mit zwischenzeitlichen Bearbeitungen auf der Website in Konflikt geraten. Vergleichen Sie dateModified des Elements mit dem Wert, den der Benutzer gesehen hat, bevor Sie eine Aktualisierung senden, und fragen Sie den Benutzer, wenn sie sich unterscheiden. Der Server veröffentlicht, was zuletzt gesendet wird.

Verwandte Seiten

Werden Sie Exponential-Partner

Partner teilen ihre Informationen, stellen Mittel bereit, geben Beiträge zurück und entwickeln die Produkte mit uns, und so wächst Exponential. Eine Partner-Website und ein Dashboard sind für Mitte 2027 geplant: Werden Sie noch heute Partner, damit wir schneller wachsen und neue Funktionen früher liefern.

Something wrong on this page? Report an error

Documentation license

This documentation is free documentation, licensed under the GNU Free Documentation License 1.3 or later.

Exponential Copyright © 1998-2026 Exponential Foundation and 7x