kvmobile - Versionsgeschichte

Pkorduan: /* Ablauf der Synchronisation */

2024-09-13T10:03:07Z

‎Ablauf der Synchronisation

Pkorduan: /* Ablauf der Synchronisation */

2024-09-11T13:36:46Z

‎Ablauf der Synchronisation

Pkorduan: /* Ablauf der Synchronisation */

2024-09-11T12:37:56Z

‎Ablauf der Synchronisation

Pkorduan: /* Ablauf der Synchronisation */

2024-09-09T10:47:27Z

‎Ablauf der Synchronisation

Pkorduan: /* Ablauf der Synchronisation */

2024-09-09T10:19:40Z

‎Ablauf der Synchronisation

Pkorduan: /* Ablauf der Synchronisation */

2024-09-09T10:10:43Z

‎Ablauf der Synchronisation

Pkorduan: /* Ablauf der Synchronisation */

2024-09-06T13:22:13Z

‎Ablauf der Synchronisation

Pkorduan: /* Ablauf der Synchronisation */

2024-09-06T13:06:05Z

‎Ablauf der Synchronisation

Pkorduan: /* Ablauf der Synchronisation */

2024-09-06T12:40:27Z

‎Ablauf der Synchronisation

Pkorduan: /* Ablauf der Synchronisation */

2024-09-06T12:14:30Z

‎Ablauf der Synchronisation

@@ Zeile 90: / Zeile 90: @@
 == Ablauf der Synchronisation ==
-) Wenn der Client die Stellen beim Server abfragt (go = mobile_get_stellen), wird auf dem Server die höchste Version aus der deltas_all-Tabelle abgefragt und im Parameter last_delta_version mit zum Client geschickt. Der Client merkt sich diese Version.
+) Der Client fragt als erstes die Stellen beim Server ab
-) Nach dem laden der Stellen lädt die App die Metadaten der Layer mit dem Case go=mobile_get_layers. Die Anfrage erfolgt mit folgenden Parametern:
+) Nach dem Laden der Stellen lädt die App die Metadaten der Layer mit dem Case go=mobile_get_layers. Die Anfrage erfolgt mit folgenden Parametern:
 * go string = mobile_get_layers
 * Stelle_ID int
 * passwort string
 * login_name string
-Als Antwort bekommt der Client ein Array von Layerdefinitionen. Die Layerdefinition enthalten die Attribute:
+Als Antwort bekommt der Client ein Array von Layerdefinitionen und die höchste Version der Deltas. Die Layerdefinition enthalten die Attribute und Klassendefinitionen:
-   "id" : $layerset['Layer_ID'],
+Result:
-  "title" : $layerset['Name'],
-  "alias" : $layerset['alias'],
+    "success": true,
-  "id_attribute" : $layerset['oid'],
+    "layers": [ {
-  "name_attribute" : $layerset['labelitem'],
+      "id": "831",
-  "classitem" : $layerset['classitem'],
+      "title":"Baumkataster Baum",
-  "transparency" : $layerset['transparency'],
+      "alias":null,
-  "geometry_attribute" : $attributes['the_geom'],
+      "id_attribute":"uuid",
-  "geometry_type" : $geometry_types[$layerset['Datentyp']],
+      "name_attribute":"baumnummer",
-  "table_name" : $layerset['maintable'],
+      "classitem" : "id_nr",
-  "schema_name" : $layerset['schema'],
+      "transparency" : 80,
-  "query" : $layerset['pfad'],
+      "geometry_attribute" : "the_geom",
-  "filter" : $layerset['Filter'],
+      "geometry_type" : 0,
-  "document_path" : $layerset['document_path'],
+      "table_name" : "baum",
-  "vector_tile_url" : $layerset['vector_tile_url'],
+      "schema_name" : "kob",
-  "privileg" : $layerset['privileg'],
+      "query": "SELECT ... ",
-  "drawingorder" : $layerset['drawingorder'],
+      "filter":"",
-  'legendorder' : $layerset['legendorder'],
+      "document_path":"\/var\/www\/data\/bilder\/baumkataster\/","vector_tile_url":"",
-  "sync" : $layerset['sync'],
+      "privileg":"2",
-  "version" : $layerset['version']
+      "drawingorder":"91000",
-  "attributes" : [ Liste der Attribute des Layers],
+      "legendorder":null,
-  "tables" : [ Liste der vom Layer verwendeten Tabellen],
+      "sync":"1",
-  "classes" : [ Liste der vom Layer verwendeten Klassen]
+      "version":"1.0.0",
-Die Version des Layers kennzeichnet den Stand des Datenmodells. Später kommen bei mobile_sync_all alle Versionen der Layer zurück und können im Client abgeglichen werden. Wenn sich eine Layerversion geändert hat müssen alle Layerdefinitionen und Daten neu geladen werden.
+Die Version des Layers kennzeichnet den Stand des Datenmodells. Später kommen bei mobile_sync_all alle Versionen der Layer zurück und können im Client abgeglichen werden. Wenn sich eine Layerversion geändert hat, müssen alle Layerdefinitionen und Daten neu geladen werden.
 ) Im nächsten Schritt werden die Daten der Layer abgefragt. Bei der Abfrage der Daten wird last_delta_version als Filter angewendet.

@@ Zeile 195: / Zeile 195: @@
 ) Falls der Client Deltas mitgeschickt hat, werden diese, falls die Berechtigung dazu besteht, nacheinander auf dem Server ausgeführt. Hat der Nutzer keine Berechtigung die Deltas auf dem Server auszuführen, werden diese als failed_deltas an den Client zurückgeschickt.
-) Bei Update-Statements wird auf dem Server abgefragt ob es in der Tabelle die geupdated werden soll einen Datensatz mit der gleichen uuid gibt, mit jüngeren updated_at_client oder updated_at. Wenn ja, wird der Update ohne den Wert von updated_at ausgeführt. Das Update-Statement wird also ausgeführt, aber kein neues updated_at gesetzt.
+Bei Update-Statements wird vorher abgefragt ob es in der Tabelle die geupdated werden soll einen Datensatz mit der gleichen uuid gibt, mit jüngeren updated_at_client oder updated_at. Wenn ja, werden die Deltas mit jüngerem Datum in action_time abgefragt um sie nach der Ausführung des Delta vom Client auszuführen.
 ) Unabhängig davon ob Deltas vom Client auf dem Server ausgeführt wurden oder nicht, werden alle Deltas abgefragt

@@ Zeile 195: / Zeile 195: @@
 ) Falls der Client Deltas mitgeschickt hat, werden diese, falls die Berechtigung dazu besteht, nacheinander auf dem Server ausgeführt. Hat der Nutzer keine Berechtigung die Deltas auf dem Server auszuführen, werden diese als failed_deltas an den Client zurückgeschickt.
-) Auf dem Server wird abgefragt welche Version gerade in der deltas_all Tabelle die höchste ist. Diese wird als Begrenzung für die Abfrage der Deltas verwendet.
+) Bei Update-Statements wird auf dem Server abgefragt ob es in der Tabelle die geupdated werden soll einen Datensatz mit der gleichen uuid gibt, mit jüngeren updated_at_client oder updated_at. Wenn ja, wird der Update ohne den Wert von updated_at ausgeführt. Das Update-Statement wird also ausgeführt, aber kein neues updated_at gesetzt.
-) Unabhängig davon ob Deltas vom Client auf dem Server ausgeführt wurden oder nicht, werden alle Deltas abgefragt, die
+) Unabhängig davon ob Deltas vom Client auf dem Server ausgeführt wurden oder nicht, werden alle Deltas abgefragt
-* nicht vom Client sind
 * dessen Versionsnummer größer als die last_delta_version vom Client ist
-* dessen Versionsnummer kleiner oder gleich der last_delta_version vom Server ist
+* keine insert Deltas mit der client_id vom Client
-Die gefundenen Deltas werden zum Client zurückgeschickt und ebenso die neue last_client_version.
+Die gefundenen Deltas werden sortiert nach Version zum Client zurückgeschickt und ebenso die neue last_client_version.
 Die Datenstruktur, die an den Client im JSON-Format zurückgeschickt wird, sieht wie folgt aus:

@@ Zeile 215: / Zeile 215: @@
      "success" : false,
      "last_delta_version" : 18,
      "deltas" : [...],
      "failedDeltas" : [...],

@@ Zeile 92: / Zeile 92: @@
 ) Wenn der Client die Stellen beim Server abfragt (go = mobile_get_stellen), wird auf dem Server die höchste Version aus der deltas_all-Tabelle abgefragt und im Parameter last_delta_version mit zum Client geschickt. Der Client merkt sich diese Version.
-) Nach dem laden der Stellen lädt die App die Layer und fragt die Daten der Layer ab. Bei der Abfrage der Daten wird last_delta_version als Filter angewendet.
+) Nach dem laden der Stellen lädt die App die Metadaten der Layer mit dem Case go=mobile_get_layers. Die Anfrage erfolgt mit folgenden Parametern:
    version < last_delta_version
 Die Daten werden mit dem Case go=mobile_get_data abgefragt.
@@ Zeile 102: / Zeile 134: @@
 * last_delta_version int $last_delta_version
 ) Die nächste Synchronisierung des Clients mit dem Server erfolgt ebenfalls mit last_delta_version. Dadurch bekommt der Client nur die Deltas von Änderungen geschickt, die er noch nicht kennt. Bei der Synchronisierung bekommt der Client erneut die höchste abgefragte Version vom Server mitgeteilt und weiß somit wieder bis wo er bereits gepullt hat.
 Für die Synchronisierung sammelt der Client alle Deltas aus seiner eigenen deltas_all Tabelle ein die vom type sql sind und sendet eine Anfrage an den Server mit folgenden Parametern:
@@ Zeile 137: / Zeile 169: @@
+   }
 ) Zunächst werden in der Funktion mobile_sync_all_parameter_valide die Parameter geprüft.
 * Die Attribute login_name und passwort werden schon bei der Authentifizierung geprüft.
 * Das Attribute go und Stelle_Id werden bei der Authorisierung geprüft.
@@ Zeile 161: / Zeile 193: @@
+   }
 ) Falls der Client Deltas mitgeschickt hat, werden diese, falls die Berechtigung dazu besteht, nacheinander auf dem Server ausgeführt. Hat der Nutzer keine Berechtigung die Deltas auf dem Server auszuführen, werden diese als failed_deltas an den Client zurückgeschickt.
 ) Auf dem Server wird abgefragt welche Version gerade in der deltas_all Tabelle die höchste ist. Diese wird als Begrenzung für die Abfrage der Deltas verwendet.
 ) Unabhängig davon ob Deltas vom Client auf dem Server ausgeführt wurden oder nicht, werden alle Deltas abgefragt, die
 * nicht vom Client sind
 * dessen Versionsnummer größer als die last_delta_version vom Client ist

@@ Zeile 174: / Zeile 174: @@
 * success boolean - True bei Erfolgt und false bei Misserfolg. Unabhängig ob failed deltas zurückkommen.
 * last_delta_version - Die Version bis zu der die Änderungen abgefragt wurden.
 * deltas Delta[] - Array mit Objekten der Struktur Delta, siehe unten
 * failedDeltas Delta[] - Array mit Objekten der Struktur Delta, bei denen Fehler auftraten. Zusätzlich haben diese Deltas die Eigenschaft err_msg.
@@ Zeile 182: / Zeile 183: @@
      "success" : false,
      "last_delta_version" : 18,
      "deltas" : [...],
      "failedDeltas" : [...],

@@ Zeile 111: / Zeile 111: @@
          "uuid" : "003de0b8-2185-4380-a547-f4c1634ff1sd",
          "sql" : "INSERT INTO test.punkte (uuid, bilder, bilder_updated_at, updated_at_client, updated_at_server, user_name, status, name, is_active, created_at, created_from, user_id, stelle_id, geom , version) VALUES ('003de0b8-2185-4380-a547-f4c1634ff1sd', null, null, '2024-03-01 10:35:12', '2024-02-01 09:39:42', 'Peter Korduan', '0', 'Testfläche 4', 'f', '2024-02-01 07:12:32', 'Peter Korduan', '2', '54', '010100004FED29DFF3D28404AD6D20E610000054FED29DF4FED29DFF3D28404AD6DF3D28404AD6D4FED29DFF3D28404AD6D2AC68094B40', 3)",
-         "schemaName" : "test",
+         "schema_name" : "test",
-         "tableName" : "polygone",
+         "table_name" : "polygone",
          "action" : "update",
-         "actionTime" : "2024-03-01 10:35:12",
+         "action_time" : "2024-03-01 10:35:12",
          "version" : 15
        }, {
          "uuid" : "003de0a8-2185-4380-a547-f4c1634ff9bd",
          "sql" : "INSERT INTO test.punkte (uuid, bilder, bilder_updated_at, updated_at_client, updated_at_server, user_name, status, name, is_active, created_at, created_from, user_id, stelle_id, version, geom , version) VALUES ('4992613c-7a0a-463d-bb40-99a1345486bd', '{"/var/www/data/kvwmap_pet_dev/punkte/1650531377364.jpg&original_name=1650531377364.jpg","/var/www/data/kvwmap_pet_dev/punkte/1650531386496.jpg&original_name=1650531386496.jpg"}', '2024-03-01 10:39:05', '2024-03-01 10:39:05', '2024-03-01 10:39:05', 'Peter Korduan', '0', 'Test 4', 'f', '2024-03-01 10:39:05', 'Peter Korduan', '2', '54', '0101000020E610000054FED29DFF3D28404AD6D2AC68094B40' , 4)",
-         "schemaName" : "test",
+         "schema_name" : "test",
-         "tableName" : "punkte",
+         "table_name" : "punkte",
          "action" : "insert",
-         "actionTime" : "2024-03-01T10:39:05",
+         "action_time" : "2024-03-01T10:39:05",
          "version" : 16
        }, {
@@ Zeile 166: / Zeile 166: @@
 Die Datenstruktur, die an den Client im JSON-Format zurückgeschickt wird, sieht wie folgt aus:
 * success boolean - True bei Erfolgt und false bei Misserfolg. Unabhängig ob failed deltas zurückkommen.
-* syncData Objekt der Struktur
+* last_delta_version - Die Version bis zu der die Änderungen abgefragt wurden.
-** clientId integer - Die ID vom Client.
-** clientTime timestamp - Der vom Client geschickte Zeitstempel.
-** lastDeltaVersion - Die Version bis zu der die Änderungen abgefragt wurden.
 * deltas Delta[] - Array mit Objekten der Struktur Delta, siehe unten
 * failedDeltas Delta[] - Array mit Objekten der Struktur Delta, bei denen Fehler auftraten. Zusätzlich haben diese Deltas die Eigenschaft err_msg.
@@ Zeile 177: / Zeile 174: @@
+   {
      "success" : false,
-     "syncData" : {
+     "last_delta_version" : 18,
-      "clientId" :
-      "clientTime" : '2024-08-07T12:13:14',
-      "lastDeltaVersion" : 18
-    },
      "deltas" : [...],
      "failedDeltas" : [...],
@@ Zeile 191: / Zeile 184: @@
+   {
      "uuid" : "003de0a8-2185-4380-a547-f4c1634ff9bd",
-     "clientId": "a4a46b6fcfadb2c2",
+     "client_id": "a4a46b6fcfadb2c2",
      "sql" : "INSERT INTO test.punkte (uuid, bilder, bilder_updated_at, updated_at_client, updated_at_server, user_name, status, name, is_active, created_at, created_from, user_id, stelle_id, version, geom , version) VALUES ('4992613c-7a0a-463d-bb40-99a1345486bd', '{"/var/www/data/kvwmap_pet_dev/punkte/1650531377364.jpg&original_name=1650531377364.jpg","/var/www/data/kvwmap_pet_dev/punkte/1650531386496.jpg&original_name=1650531386496.jpg"}', '2024-03-01 10:39:05', '2024-03-01 10:39:05', '2024-03-01 10:39:05', 'Peter Korduan', '0', 'Test 4', 'f', '2024-03-01 10:39:05', 'Peter Korduan', '2', '54', '20', '0101000020E610000054FED29DFF3D28404AD6D2AC68094B40' , 2)",
-     "schemaName" : "test",
+     "schema_name" : "test",
-     "tableName" : "punkte",
+     "table_name" : "punkte",
      "version" : 17,
      "action" : "insert",
-     "errMsg?" : "Fehler beim Eintragen des Datensatzes mit der ID: 003de0a8-2185-4380-a547-f4c1634ff9bd in die Tabelle test.punkte. Meldung: ..."
+     "action_time" : "2024-03-01 10:39:05",
+   }