Inherits from TICDSOperation : NSOperation
Declared in TICDSPostSynchronizationOperation.h

Overview

The TICDSPostSynchronizationOperation class describes a generic operation used by the TICoreDataSync framework to synchronize changes made to a document.

In brief, a post-synchronization operation pushes out the local set of unsynchronized sync changes.

In full, the operation carries out the following tasks: (Sync Command tasks are included below, although not yet implemented)

  1. If there are local SyncCommands, rename UnsynchronizedSyncCommands.ticdsync to UUID.synccmd and push the file to the remote.
  2. If there are local SyncChanges, rename UnsynchronizedSyncChanges.syncchg to UUID.syncchd and push the file to the remote.
  3. Save this client’s file in the RecentSyncs directory for this document.

Operations are typically created automatically by the relevant sync manager.

%warning%
Warning: You must use one of the subclasses of TICDSPostSynchronizationOperation.

Tasks

Methods Overridden by Subclasses

Callbacks

File Locations

Properties

appliedSyncChangeSetsFileLocation

The location of this document’s AppliedSyncChangeSets.ticdsync file.

@property (strong) NSURL *appliedSyncChangeSetsFileLocation

Declared In

TICDSPostSynchronizationOperation.h

localRecentSyncFileLocation

The location of the local RecentSync file to upload at the end of the synchronization process.

@property (strong) NSURL *localRecentSyncFileLocation

Declared In

TICDSPostSynchronizationOperation.h

localSyncChangesToMergeURL

The location of the SyncChangesBeingSynchronized.syncchg file for this synchronization operation.

@property (strong) NSURL *localSyncChangesToMergeURL

Declared In

TICDSPostSynchronizationOperation.h

Instance Methods

uploadLocalSyncChangeSetFileAtLocation:

Upload the specified sync changes file to the client device’s directory inside the document’s SyncChanges directory.

- (void)uploadLocalSyncChangeSetFileAtLocation:(NSURL *)aLocation

Parameters

aLocation

The location of the file to upload.

Discussion

This method must call uploadedLocalSyncChangeSetFileSuccessfully: to indicate whether the creation was successful.

Declared In

TICDSPostSynchronizationOperation.h

uploadRecentSyncFileAtLocation:

Upload the specified RecentSync file to the document’s RecentSync directory.

- (void)uploadRecentSyncFileAtLocation:(NSURL *)aLocation

Parameters

aLocation

The location of the file to upload.

Discussion

This method must call uploadedRecentSyncFileSuccessfully: to indicate whether the creation was successful.

Declared In

TICDSPostSynchronizationOperation.h

uploadedLocalSyncChangeSetFileSuccessfully:

Indicate whether the upload of the sync change set file was successful.

- (void)uploadedLocalSyncChangeSetFileSuccessfully:(BOOL)success

Parameters

success

YES if the sync change set file was uploaded, otherwise NO.

Discussion

If not, call setError: first, then specify NO for success.

Declared In

TICDSPostSynchronizationOperation.h

uploadedRecentSyncFileSuccessfully:

Indicate whether the upload of the RecentSync file was successful.

- (void)uploadedRecentSyncFileSuccessfully:(BOOL)success

Parameters

success

YES if the RecentSync file was uploaded, otherwise NO.

Discussion

If not, call setError: first, then specify NO for success.

Declared In

TICDSPostSynchronizationOperation.h