SQLite-DB sichern/wiederherstellen
Mit Hilfe dieser Aktion (Abbildung unten) können Sie in einem von Ihnen festgelegten Ordner mehrfach Sicherungskopien einer SQLite-Datenbank erstellen. Die SQLite-Datenbank kann anschließend anhand einer dieser Sicherungskopien wiederhergestellt werden. Diese Funktionalität steht nur in der MobileTogether Server Advanced Edition zur Verfügung.
Um Sicherungskopien anzulegen, gehen Sie folgendermaßen vor:
1.Aktivieren Sie Backup.
2.Wählen Sie die gewünschte Datenbankverbindung aus.
3.Wählen Sie den Ordner aus, in dem die Sicherungskopien gespeichert werden sollen. Dabei kann es sich um einen Pfad relativ zum Arbeitsverzeichnis der serverseitigen Lösung oder einen absoluten Pfad handeln. Der Dateiname der gesicherten SQLite-Datenbank wird automatisch generiert und ist eine Verkettung (i) des Namens der DB-Verbindung, den Sie in Schritt 2 eingegeben haben (in der Abbildung oben z.B. Contract_Management) mit (ii) dem aktuellen Zeitstempel (im Format JJJJ-MM-TT HH-MM-SS). Der Dateiname könnte z.B. folgendermaßen lauten: Contract_Management 2021-06-18_10-30-24, wobei die Zahlen für Datum und Uhrzeit stehen.
4.Geben Sie optional die maximale Anzahl an Backups ein. Sobald diese Anzahl überstiegen wird, wird die älteste Backup-Datei gelöscht. Wenn kein Wert definiert wird oder der Wert auf 0 gesetzt wird, können unbegrenzt viele Backups erstellt werden.
Um die SQLite-Datenbank anhand einer Sicherungskopie wiederherzustellen, gehen Sie folgendermaßen vor:
1.Wählen Sie Wiederherstellen aus.
2.Wählen Sie die Verbindung zur gewünschten SQLite-Datenbank aus..
3.Wählen Sie den relativen oder absoluten Pfad der Backup-Datei aus, anhand der die Datenbank wiederhergestellt werden soll. Relative Pfade müssen relativ zum Arbeitsverzeichnis der serverseitigen Lösung sein.
Anmerkung:
•Nachdem eine Sicherungskopie angelegt wurde, könnten Sie den Pfad dazu durch Aufruf der Funktion mt-last-file-path() abrufen. Beachten Sie, dass diese Funktion den vollständigen Dateipfad zurückgibt.
•Wenn eine SQLite-Datenbank mit Hilfe der Aktion "Wiederherstellen" wiederhergestellt wird, gehen alle (seit dem letzten Backup) neu hinzugekommenen Daten in der ersetzten Datenbankdatei verloren. Wenn Sie diese Daten behalten möchten, stellen Sie sicher, dass Sie ein Backup der Datenbank anlegen, bevor Sie sie wiederherstellen.
•Nachdem eine Datei mit Hilfe der Wiederherstellen-Aktion anhand der Sicherungskopie wiederhergestellt wurde, wird die Sicherungskopie nicht gelöscht. Nach einer Wiederherstellen-Aktion gibt die Funktion mt-last-file-path() den vollständigen Pfad der Backup-Datei (anhand der die Datei wiederhergestellt wurde) zurück.
•Wenn die Datenbank beim Versuch einer Wiederherstellung gesperrt ist, wird ein Fehler retourniert. Es gibt keine erneuten Versuche oder Timeouts.
Fehlerverarbeitung
Mit der Option Bei Fehler können Sie definieren, wie bei Auftreten eines Fehlers vorgegangen wird. Da die Fehlerbehandlung für diese Aktion genau definiert werden kann, werden Fehler in solchen Aktionen (für die eine Fehlerbehandlung vorgesehen ist) als Warnungen und nicht Fehler behandelt. Der Vorteil davon ist, dass Sie Fehler bei Aktionen, für die bereits eine Fehlerbehandlung definiert wurde, nicht überprüfen müssen. Die folgenden Fehlerbehandlungsoptionen stehen zur Verfügung:
•Skript abbrechen: Sobald ein Fehler auftritt, werden alle nach diesem Ereignis durchzuführenden Aktionen beendet. Dies ist das Standardverhalten bei Auftreten eines Fehlers. Wenn Sie möchten, dass auch bei einem Fehler fortgefahren werden soll, wählen Sie entweder die Option Weiter oder Throw aus.
•Weiter: Die Aktionen werden nicht beendet. Sie können stattdessen auswählen, was in jedem der beiden Fälle (kein Fehler (Bei Erfolg) oder Auftreten eines Fehlers (Bei Fehler)) geschehen soll. So kann z.B. ein Meldungsfeld definiert werden, das den Benutzer darüber informiert, ob eine Seite erfolgreich geladen werden konnte oder nicht.
•Throw: Wenn ein Fehler aufgetreten ist, wird mit dieser Option eine Ausnahme ausgelöst, die in der Variablen der Try/Catch-Aktion gespeichert wird. Mit dem Catch-Teil der Try/Catch-Aktion wird definiert, welche Aktion bei Auftreten eines Fehlers durchgeführt werden soll. Wenn kein Fehler auftritt, wird die nächste Aktion verarbeitet. Nähere Informationen dazu finden Sie im Abschnitt zur Aktion "Try/Catch Ausnahme".
MobileTogether-Erweiterungsfunktionen
MobileTogether enthält eine Reihe von XPath-Erweiterungsfunktionen, die speziell für die Verwendung in MobileTogether-Designs erstellt wurden. Einige davon können bei bestimmten Aktionen sehr nützlich sein. So erhalten Sie etwa mit mt-available-languages() die Sprachen, in denen die Lösung zur Verfügung steht. Diese Funktion könnte z.B. mit der Aktion Meldungsfeld verwendet werden. Wenn eine Funktion für diese Aktion besonders relevant ist, ist sie unten aufgelistet. Eine vollständige Liste aller Erweiterungsfunktionen und mit Beschreibungen finden Sie im Kapitel MobileTogether-Erweiterungsfunktionen.
mt-available-db-connection-names()
mt-external-error-code()
mt-external-error-text()