You can access Desktop Sync from the Windows system tray where the application icon appears:

Hover your cursor over the Desktop Sync icon to display sync status information, such as date and time of last sync, sync issues (conflicts), and any pending updates.

Right-click on the Desktop Sync icon to see the application popup menu:

Application menu items

The following section goes through each one of the Desktop Sync menu items.

Open

Displays information about checked out files, any pending syncs, and conflicts.

• SelectChecked out to view information about any files you’ve checked out from Desktop Sync, for example, file name, file location, and details when the file was downloaded.
• SelectPending to view information about any pending syncs, for example, file name, status of the pending sync, modifier, file location, and details when the file was last accessed.
• SelectConflicts to view conflict-related information and resolve the conflict. The information displayed includes file name, the conflict or issue, modifier, location of the conflict, and details when the file was last modified.
• Select the file in conflict and clickResolve.

To resolve a conflict, choose which version to keep, Alfresco or your changes and clickKeep:

• Alfresco version: Replaces the local file with the Alfresco copy.
• My version: Copies updates made to content locally to Alfresco.

Working with multiple checked out files

If several files areChecked out, you have the following options:

• Select files individually using the check boxes to the left hand side, or use the select all files check box at the top.
• When you select more than one check box, you can pick bulk actions at the top of the tab,Check In andCancel Check Out. If you chooseCheck In, you can select if the new version is a major or minor change, and optionally input a comment. SelectCheck In again to save your changes. This applies the same version change and comment (if added) to all the selected files.

Go to Alfresco Folder

Opens theAlfresco sync folder for Desktop Sync.

Search

Opens theSearch dialog so you can search your local synced files and folders.

You can only search the content that’s already synced in theAlfresco folder. This avoids having to use the search feature in Mac Finder/Windows Explorer which takes longer and sometimes provides irrelevant results.

• Start your search by typing in the search field. You’ll see results presented even if you’ve only provided partial search text. In the search results, you’ll see files and folders are easily identifiable by their respective icons.
• You can view the search results listed byName,Location,Modified Date, andSize. You can also search by file name and file extension, for example, by enteringpng or.png.
• To locate a file from theSearch dialog, double-click the file/folder icon to show the content in Windows Explorer.

Recent Files

ClickRecent Files to open the Recent Files dialog and view your recently used files in theAlfresco sync folder.

• The recently used files are listed byName,Location,Modified Date, andSize, where the most recently updated file is at the top.
• To locate a file from theRecent Files dialog, double-click the required file to show the content in Windows Explorer.

Sync Now

By default local content is synced to Alfresco immediately and Alfresco content is synced locally every five minutes. Click this if you want content synced immediately.

Pause Sync

Pauses Sync if you don’t wish to synchronize files from the server, for example when you have a low bandwidth connection.

Manage Your Account

You can manage which folders and sites get synced on your desktop and other account details usingManage Your Account. The available options are:

• Manage Folders: Opens Choose folders and sites to sync screen. SeeSelect content to sync.

  If you deselect a previously synced folder and clickSync, then the synced content from your desktop is removed. In case you have any unsynced or conflicted files, they will be orphaned inC:\Users\<username>\Alfresco\orphaned.

• Consistency Check: Performs a consistency check on Desktop Sync. This is typically used in collaboration with your IT team when you need support.

• Account Information: View the account information for Desktop Sync:

  • User Name for the currently logged in user.
  • Storage Used by theAlfresco sync folder on your hard drive.

• Enter Your New Password: If you have recently changed your Alfresco password, use this option to update the same password in Desktop Sync.

  TheHave you recently changed your password in Alfresco? window appears. Specify the updated password to resume syncing and clickUpdate.

• Remove Local Content: Removes all the synced content from Desktop Sync without the need to remove the user account. This provides support for a customer policy where content is only kept on a device when users are actively working on that content and using Desktop Sync.

  To start using Desktop Sync again, you’ll need to set up your synced files via theManage Your Account > Manage Folders menu option. SeeSelect content to sync.

• Remove Account: Removes the synced user from Desktop Sync and deletes all the synced content from the desktop. You can still access your files in Alfresco. On removing your account you are taken back to the Desktop Sync login screen. SeeSetting up Desktop Sync.

About

Tells you which version of Desktop Sync you’re using.

Help

View online help.

Quit

Closes Desktop Sync.

You will no longer be able to sync during this time. Syncing will resume when you restart Desktop Sync. Any content updated while Desktop Sync was closed will be synced when the application is restarted.

It’s recommended that you always have Desktop Sync up and running so that your local content and Alfresco are in sync.

Windows Explorer context menu

The folder and file context menu can be accessed via the Windows Explorer.

Accessing and using the context menu

To view the Desktop Sync context menu, follow the steps below:

1. Navigate to your synced content (folder or file) in the File Explorer.
2. Right-click the content to access the Explorer menu actions.
3. ClickSync Now to sync your content immediately.
4. ClickCheck Out to lock it in Alfresco, so that other users can’t overwrite it while you make changes. Once you check out a file, you’ll see two more options:
   • Check In: Uploads a new version of your content to Alfresco.
   • Cancel Check Out: Cancels editing to unlock the file without saving any changes.
5. In the event of a conflict, you’ll see one more option:
   • Resolve: Selecting this option opens a screen where you can decide to keep your changes or the changes from the server.
6. ClickShare to enable file sharing when you right-click a synced file. Once set up in your configuration file, this option allows you to share a direct link to a file, so that anyone that has the link can view the file.
   • SeeConfiguring Desktop Sync for configuration details.
   • SeeSharing files for more.
7. ClickVersion History to view and manage version history when you right-click synced content.
   • SeeVersion History for more.
8. ClickProperties to enable viewing, editing, and updating of properties when you right-click synced content.
   • SeeProperties for more.
9. ClickUpdate Desktop Sync to download the new installer file to your local Downloads folder. SeeUpdating Desktop Sync for more.

Working with multiple files in Windows Explorer

You can also work with multiple files by using the Explorer right click menu actions:

• Sync Now,Check Out, andProperties.
• Check In andCancel Check Out are displayed if any file is already checked out.
• When you clickCheck In, select if the new version is a major or minor change, and optionally input a comment. ClickCheck In again to save your changes. This applies the same version change and comment (if added) to all the selected files.
• If you have selected a mixture of items, for example where you have files checked out and not checked out, then all the relevant options are shown. When an action is selected, it’s only applied to the files that are in a relevant state.
• If any of the files you selected are in conflict, you’ll have to resolve these individually, as the conflict resolution options are not displayed.

You can access Desktop Sync from the Mac OS X menu bar where the application icon appears:

• Application icon

  Click the Desktop Sync icon to see more options.

• Search

  Click the Search icon to open theSearch dialog and search your local synced files and folders.

  You can only search the content that’s already synced in theAlfresco folder. This avoids having to use the search feature in Mac Finder/Windows Explorer which takes longer and sometimes provides irrelevant results.

  • Start your search by typing in the search field. You’ll see results presented even if you’ve only provided partial search text. In the search results, you’ll see files and folders are easily identifiable by their respective icons.
  • You can view the search results listed byName,Modified Date, andSize. You can also search by file name and file extension, for example, by enteringpng or.png.
  • To locate a file from theSearch dialog, click the icon on the right side of the required row to show the content in Mac Finder.

• Sync folder

  Click the folder icon to open theAlfresco sync folder on your computer.

• Settings

  Click the icon to open the Desktop Sync settings menu. SeeSettings for more details.

Settings

You can access Desktop Sync settings by clicking the application icon in the menu bar then selectingSettings.

Click then to access theSettings options.

Pause / Resume Sync

Select Pause Sync when you prefer to work offline, for example due to slow network speeds, or if you’re working on a particularly large file. Once you’ve selectedPause Sync, the menu option changes toResume Sync.

Select Resume Sync to resume syncing with Alfresco Content Services.

Consistency Check

Performs a consistency check on Desktop Sync. This is typically used in collaboration with your IT team when you need support.

Recent Files

ClickRecent Files to open the Recent Files dialog and view your recently used files in theAlfresco sync folder.

• The recently used files are listed byName,Modified Date, andSize, where the most recently updated file is at the top.
• To locate a file from theRecent Files dialog, click the required row to show the content in Mac Finder.

Manage Sync Folder

SelectingManage Sync Folder opens the Select sites and folders to sync dialog. This allows you to select more content to sync, or deselect content to stop syncing. SeeSelect content to sync for more.

If you deselect a previously synced folder and clickSync, then the synced content from your desktop is removed. In case you have any unsynced or conflicted files, they will be orphaned in/<userHome>/Alfresco/orphaned.

Manage Your Account

• Account Information

  View the account information for Desktop Sync:

  • User Name for the currently logged in user.
  • Storage Used by theAlfresco sync folder on your hard drive.

• Remove Local Content

  Removes all the synced content from Desktop Sync without the need to remove the user account. This provides support for a customer policy where content is only kept on a device when users are actively working on that content and using Desktop Sync.

  To start using Desktop Sync again, you’ll need to set up your synced files via theManage Sync Folder menu option. SeeSelect content to sync.

• Remove Account

  Removes the synced user from Desktop Sync and deletes all the synced content from the desktop. Use this option as the first stage of uninstalling Desktop Sync.

  You can still access your files in Alfresco. Any content that can’t be removed from your desktop is orphaned. On removing your account you are taken back to the Desktop Sync login dialog. Close the login dialog to quit the application. SeeSetting up Desktop Sync.

Help

View online help.

About

View the version number of Desktop Sync you’re using.

Quit

Closes Desktop Sync.

You won’t be able to sync content during this time. Syncing will resume when you restart Desktop Sync. Any content updated while Desktop Sync was closed will be synced when the application is restarted.

It’s recommended that you always have Desktop Sync up and running so that your local content and Alfresco are in sync.

Check Outs, Conflicts and Pending

Displays information about checked out files, any pending syncs, and conflicts.

• SelectChecked out to view information about any files you’ve checked out from Desktop Sync, for example, file name, file location, and details when the file was downloaded.
• SelectPending to view information about any pending syncs, for example, file name, status of the pending sync, modifier, file location, and details when the file was last accessed.

• SelectConflicts to view conflict-related information and resolve the conflict. The information displayed includes file name, the conflict or issue, modifier, location of the conflict, and details when the file was last modified.

  To resolve a conflict, select the conflict and either click:

  • Discard my changes: Replaces the local file with the Alfresco copy.
  • Keep my changes: Copies updates made to content locally over to Alfresco.

Note: There may be times when you can’t resolve a conflict for a file because the parent folder also has a conflict. In this case, your only choice is to resolve the conflict on the folder by either selectingKeep my changes orDiscard my changes. Your choice is then applied to all files within that folder.

Working with multiple checked out files

If several files areChecked out, you have the following options:

• Select files individually using the check boxes to the left hand side, or use the select all files check box at the top.
• When you select more than one check box, you can pick bulk actions at the top of the tab,Check In andCancel Check Out. If you chooseCheck In, you can select if the new version is a major or minor change, and optionally input a comment. SelectCheck In again to save your changes. This applies the same version change and comment (if added) to all the selected files.

Update password

Desktop Sync doesn’t allow you to change your password directly. However, if yourpassword changes in Alfresco Share, you will see a notification in Desktop Sync asking you to update your password. ClickUpdate Password to continue.

Mac Finder context menu

The folder and file context menu can be accessed via the Mac Finder.

Accessing and using the context menu

To view the Finder menu actions, follow the steps below:

1. Navigate to your synced content in Finder.
2. Right-click on a file or folder to access the Finder menu actions.
3. ClickSync Now to sync your content immediately.
4. ClickCheck Out to lock it in Alfresco, so that other users can’t overwrite it while you make changes offline. Once you check out a file, you’ll see two more options:
   • Check In: Uploads a new version of your content to Alfresco.
   • Cancel Check Out: Cancels editing to unlock the file without saving any changes.
5. In the event of a conflict, you’ll see two more options:
   • Discard my Changes: Replaces the local file with the Alfresco copy.
   • Keep my Changes: Copies updates made to content locally over to Alfresco.
6. ClickShare to enable file sharing when you right-click a synced file. Once set up in your configuration file, this option allows you to share a direct link to a file, so that anyone that has the link can view the file.
   • SeeConfiguring Desktop Sync for configuration details.
   • SeeSharing files for more.
7. ClickVersion History to view and manage version history when you right-click synced content.
   • SeeVersion History for more.
8. ClickProperties to enable viewing, editing, and updating of properties when you right-click synced content.
   • SeeProperties for more.
9. ClickUpdate Desktop Sync to download the new installer file to your local Downloads folder. SeeUpdating Desktop Sync for more.

Working with multiple files in Finder

You can also work with multiple files by using the Finder right click menu actions:

• Sync Now,Check Out, andProperties.
• Check In andCancel Check Out are displayed if any file is already checked out.
• When you clickCheck In, select if the new version is a major or minor change, and optionally input a comment. ClickCheck In again to save your changes. This applies the same version change and comment (if added) to all the selected files.
• If you have selected a mixture of items, for example where you have files checked out and not checked out, then all the relevant options are shown. When an action is selected, it’s only applied to the files that are in a relevant state.
• If any of the files you selected are in conflict, you’ll have to resolve these individually, as the conflict resolution options are not displayed.