Change List: Difference between revisions
| (5 intermediate revisions by 2 users not shown) | |||
| Line 5: | Line 5: | ||
# In the app, go to the [[Setup]] / Settings screen. | # In the app, go to the [[Setup]] / Settings screen. | ||
# Scroll down to ''' | # 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. | ||
| Line 12: | Line 12: | ||
Tap '''Change List''' to display the records on the '''Unsynced Data Changes''' view. | 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 20: | Line 20: | ||
* 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.) | * 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". | To see a list of unsynchronized documents, search for "doc". | ||
[[File:Unsynced documents.png]] | [[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: | [[File column]] changes may also be included in the change list, for example: | ||
<syntaxhighlight lang=" | <syntaxhighlight lang="text"> | ||
*** List of changed entity records *** | *** List of changed entity records *** | ||
[account, JohnV, 10407f42-2cfe-4ce5-87b2-e1ee9df1b338] ---> { | [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 | DeleteFile account[JohnV, 10407f42-2cfe-4ce5-87b2-e1ee9df1b338].cr180_filetypecolumn1 - null | ||
UploadFile account[JohnV, 10407f42-2cfe-4ce5-87b2-e1ee9df1b338].cr180_filetypecolumn3 - 5.txt | |||
</syntaxhighlight> | </syntaxhighlight> | ||
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
- 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.
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.)
To see a list of unsynchronized documents, search for "doc".
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:
- 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