View source for Change List

{{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 ==

# In the app, go to the [[Setup]] / Settings screen.
# 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.

== Using the change list ==

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

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

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.)

[[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:Support]]