Understanding Desktop Sync icons
Desktop Sync always ensures that the files in your /<userHome>/Alfresco folder are synced with Alfresco. It adds status icons to your files and folders so you know the application is working.
You'll see icons in two different places: in the menu bar and next to individual files and folders.
Menu bar icons
Icons that appear over the Desktop Sync icon in your menu bar represent the overall status of your Alfresco folder.
Here's what each of these icons means.
|Green tick||A green tick shows all your files are synced and accessible from your desktop.|
|Red flag||A red flag indicates there are conflicts that need to be resolved by the user. Something isn't working properly and your file(s) are not being synced.|
|Blue arrows||A syncing icon indicates that file(s) are being synced or waiting to be synced.|
|Pause||A pause icon indicates that Desktop Sync is paused due to invalid server credentials or there's nothing configured to sync.|
|Warning||A warning icon indicates that Desktop Sync failed to get a successful server health check. Contact your IT team if you see this warning.|
|Offline||An offline icon indicates that Desktop Sync isn't connected to Alfresco and you are working offline. Check your Internet connection to resume syncing your files.|
Icons that appear next to individual files and folders represent the status of that file or folder.
Here's what each of these icons means.
|Icon name||File / Folder icon||Description|
|Green tick||It's synced - A green tick on a file indicates that the file or folder is in sync with the server copy.|
|Refresh arrows||It's in use. The blue arrows indicate that Desktop Sync is waiting for the application to release the file or for free space to become available.|
|Red flag||It's in conflict. A red flag on a file or folder indicates that update/rename/delete has conflicted with a server-side change and we aren't able to automatically resolve it. You need to decide which version to keep.|
|Grey arrow||It's checked out by another user. A grey arrow indicates that the file is checked out by another user in Alfresco. The file is locked, so you can't make changes until the file is checked in, or the check out is cancelled.|
|Blue arrow||It's checked out by you. A blue arrow indicates that the file is checked out by you. The file is locked on the server, so others can't make changes until the file is checked in, or the check out is cancelled.|
|Grey pencil||It's read-only. A grey pencil indicates that you don't have permission to edit this file. This could be due to insufficient privileges on the server, or the file has been declared as a record.|
Desktop Sync User Interface
Click to open the Desktop Sync User Interface (UI). By default, this is docked (or locked) to the menu bar. Click and drag it away from the menu bar to move it. Here is a brief description of each tab in the UI.
|Checked Out||Displays files that you have checked out from your synced folder in Desktop Sync. You can click the icon or file name to open it, or double-click to reveal the file in Finder. See working with multiple Checked Out files for more.|
|Pending||Displays any changes that are waiting to be synced to Alfresco.
Note: Files that are currently in use by another application are listed here.
|Conflicts||Displays a list of files or folders that are in conflict.
Note: If a folder is in conflict as well as any of its contents (such as a file or sub-folder), special rules apply for how this content is resolved. See conflict matrix for more details.
Finder menu actions
You can access Desktop Sync actions through the Finder context menu by right clicking on a file or folder.
|Sync Now||Use this option when you want to sync content immediately.|
|Check Out||When you check out a file, it's locked in Alfresco, so that other users can't overwrite it while you make changes offline. This also applies when working with multiple files in Finder.|
|Check In||Shown only when you have one or more files checked out. Select this option when you're ready to upload a new version to Alfresco. See working with multiple files in Finder for more.|
|Cancel Check Out||Shown only when you have one or more files checked out. You can cancel editing to unlock the file(s) without saving changes. See working with multiple files in Finder for more.|
|Keep my Changes||Shown only when you need to resolve a conflict. Select this option to keep the changes made on your computer. This will sync your changes to Alfresco as a new version.|
|Discard my Changes||Shown only when you need to resolve a conflict. Select this option to discard the changes made on your computer. This will sync the latest version from Alfresco, overwriting your changes in your Alfresco sync folder.|
|Declare as Record||Shown only when Alfresco Governance Services is running.
Select this option to declare the file as a record. See Declaring records for more.
Note: Files previously rejected as a record can't be automatically declared again. See Managing unfiled records for information on resetting the status.
What are conflicts?
Whilst Desktop Sync ensures that content is kept up to date silently, under normal operation there may be circumstances where Desktop Sync can't resolve differences between a file stored on your desktop and the corresponding file in Alfresco. When the sync changes can't be updated automatically you are asked to resolve the conflict manually. This happens when a file has changed in both locations since its last sync, making it difficult to determine which changes to save.
For example, a conflict occurs when you update a file in your Alfresco sync folder and an update to the same file has happened on the server since the last sync. Desktop Sync will give you a choice of resolving the sync conflict by either choosing to keep your changes, or discarding your changes in favor of the latest copy from Alfresco.
For more information, see Sync conflict resolution matrix.