Jump to content

Change List: Difference between revisions

From Resco's Wiki
 
(15 intermediate revisions by 2 users not shown)
Line 1: Line 1:
The change list is an optional part of [[Resco mobile apps]]. It displays records changed in the local database on the device, waiting for synchronization.
{{Support TOC}}
The change list is an optional part of [[Resco mobile apps]]. It displays records changed (also created, deleted) in the local database on the device, waiting for synchronization.


== Enabling the change list ==
== Enabling the change list ==


# In the app, go to the [[Setup]] / Settings screen.
# In the app, go to the [[Setup]] / Settings screen.
# Scroll down to '''Appearance''' and enable '''Change List'''.
# Scroll down to '''Advanced''' and enable '''Show "Change list"'''. Save changes.
# When you return to the [[home screen]], a new menu item, Change List, should be visible at the very top.
# When you return to the [[home screen]], a new menu item, Change List, should be visible at the very top.


== Using the change list ==
== Using the change list ==


Tap '''Change List''' to display the records.
Tap '''Change List''' to display the records on the '''Unsynced Data Changes''' view.


[[File:Change list example.png|600px]]
[[File:Change list example.png|alt=Using the change list|600px]]


The following functions are available in this list:
The following functions are available in this list:
Line 17: Line 18:
* Tap any record to display its details.
* Tap any record to display its details.
* The status bar at the bottom displays summary information about all changes.
* The status bar at the bottom displays summary information about all changes.
* Tap '''View Edits''' to display changes in pseudo JSON format.
* Tap '''View Edits''' to display changes in pseudo-JSON format. This list largely corresponds to the data sent to the server during synchronization. (The only difference is that binary data are omitted.)


[[File:Change list user edits.png|600px]]
[[File:Change list user edits.png|alt=change list user edits|600px]]


To see a list of unsynchronized documents, search for "doc".


[[File:Unsynced documents.png|alt=Unsynced data changes]]
== File columns in change list ==
[[File column]] changes may also be included in the change list, for example:
<syntaxhighlight lang="text">
  *** List of changed entity records ***
  [account, JohnV, 10407f42-2cfe-4ce5-87b2-e1ee9df1b338]  ---> {
    "name":"JohnV"
  }
  DeleteFile account[JohnV, 10407f42-2cfe-4ce5-87b2-e1ee9df1b338].cr180_filetypecolumn1 - null
  UploadFile account[JohnV, 10407f42-2cfe-4ce5-87b2-e1ee9df1b338].cr180_filetypecolumn3 - 5.txt
</syntaxhighlight>
In the example above, the following file actions are to be performed:
# Delete the file stored previously in the field cr180_filetypecolumn1
# Upload a new file to the field cr180_filetypecolumn3. File name is "5.txt".
== Technical information ==
Resco mobile apps collect information about record changes in the so-called changelog. This is an internal table which contains an entry for each changed record. This entry contains information about whether the record was created, modified, or deleted; which fields were changed; and information about eventual upload problems or conflicts.
Resco mobile apps can display changelog content on the following two forms:
* Change List (this form)
* [[Sync Errors]] form


[[Category:Resco Mobile CRM]]
[[Category:Resco Mobile CRM]]
[[Category:Support]]

Latest revision as of 11:18, 17 February 2025

The change list is an optional part of Resco mobile apps. It displays records changed (also created, deleted) in the local database on the device, waiting for synchronization.

Enabling the change list

  1. In the app, go to the Setup / Settings screen.
  2. Scroll down to Advanced and enable Show "Change list". Save changes.
  3. When you return to the home screen, a new menu item, Change List, should be visible at the very top.

Using the change list

Tap Change List to display the records on the Unsynced Data Changes view.

Using the change list

The following functions are available in this list:

  • Use the Search bar on top to quickly locate records.
  • Tap any record to display its details.
  • The status bar at the bottom displays summary information about all changes.
  • Tap View Edits to display changes in pseudo-JSON format. This list largely corresponds to the data sent to the server during synchronization. (The only difference is that binary data are omitted.)

change list user edits

To see a list of unsynchronized documents, search for "doc".

Unsynced data changes

File columns in change list

File column changes may also be included in the change list, for example:

  *** List of changed entity records ***
  [account, JohnV, 10407f42-2cfe-4ce5-87b2-e1ee9df1b338]  ---> {
     "name":"JohnV"
  }

  DeleteFile account[JohnV, 10407f42-2cfe-4ce5-87b2-e1ee9df1b338].cr180_filetypecolumn1 - null
  UploadFile account[JohnV, 10407f42-2cfe-4ce5-87b2-e1ee9df1b338].cr180_filetypecolumn3 - 5.txt

In the example above, the following file actions are to be performed:

  1. Delete the file stored previously in the field cr180_filetypecolumn1
  2. Upload a new file to the field cr180_filetypecolumn3. File name is "5.txt".

Technical information

Resco mobile apps collect information about record changes in the so-called changelog. This is an internal table which contains an entry for each changed record. This entry contains information about whether the record was created, modified, or deleted; which fields were changed; and information about eventual upload problems or conflicts.

Resco mobile apps can display changelog content on the following two forms: