--- schema_version: "1" id: 6bdf17ceb7392dc0b84520158673603ce812af681f9105a5a2b159a5e05aba07 title: DeviceSyncTransaction collection: legacydeveloper version: current locale: en-us portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/life_sciences_dev_guide/sforce_api_objects_devicesynctransaction.md canonical_url: https://developer.salesforce.com/docs/atlas.en-us.life_sciences_dev_guide.meta/life_sciences_dev_guide/sforce_api_objects_devicesynctransaction.htm source_site: developer.salesforce.com content_type: documentation content_hash: 20574f285cc549895396eaf43163522eae98676306c3032a23b371c566614ca5 description: Represents a set of related data items to synchronize from a mobile device. This object is available in API version 65.0 and later. --- # DeviceSyncTransaction Represents a set of related data items to synchronize from a mobile device. This object is available in API version 65.0 and later. ## Supported Calls create(), delete(), describeLayout(), describeSObjects(), getDeleted(), getUpdated(), query(), retrieve(), search(), undelete(), update(), upsert() ## Fields ### ActualRecordsCount - **Type**: int - **Properties**: Filter, Group, Nillable, Sort - **Description**: The number of data items retrieved from the mobile device and ready to sync. ### ApiName - **Type**: string - **Properties**: Create, Filter, Group, Nillable, Sort, Update - **Description**: Indicates the business API to use to process the transaction when the transaction type is Business API. For example, Quote, Order, or Contact. Required when Transaction Type is Business API. ### ApiType - **Type**: picklist - **Properties**: Create, Filter, Group, Nillable, Restricted picklist, Sort, Update - **Description**: Indicates the API type to use to process the device sync transaction. API. - **Default value**: sObject - **Possible values**: - BusinessAPI—The sync transaction is processed by using the specified business API type. - sObjectAPI—The sync transaction is processed by using the standard object data API. ### AppVersion - **Type**: string - **Properties**: Create, Filter, Group, Sort, Update - **Description**: Required. The version of the mobile application with data to sync. ### CanCancDpndBeRetired - **Type**: boolean - **Properties**: Defaulted on create, Filter, Group, Sort - **Description**: Indicates whether a retry operation is available for a dependent child transaction with a status of Canceled (true) or not (false). This field is a calculated field. - **Default value**: false ### Comments - **Type**: textarea - **Properties**: Create, Nillable, Update - **Description**: Additional information about the transaction. ### DependentOfflineIdentifiers - **Type**: string - **Properties**: Create, Filter, Group, Nillable, Sort, Update - **Description**: A comma-separated list of IDs that represent dependent transactions from the mobile device. The transactions are processed in the order in which they’re listed. ### DeviceIdentifier - **Type**: string - **Properties**: Create, Filter, Group, Sort, Update - **Description**: Required. The ID of the mobile device. ### DevicePlatform - **Type**: picklist - **Properties**: Create, Filter, Group, Nillable, Restricted picklist, Sort, Update - **Description**: The operating system of the mobile device. - **Possible values**: - Android - MacOS - Windows - iOS ### DeviceType - **Type**: string - **Properties**: Create, Filter, Group, Nillable, Sort, Update - **Description**: The type of mobile device, for example Phone or Tablet. ### ExpectedRecordCount - **Type**: int - **Properties**: Create, Filter, Group, Nillable, Sort, Update - **Description**: The expected number of data items to sync. ### IsBulk - **Type**: boolean - **Properties**: Create, Defaulted on create, Filter, Group, Sort, Update - **Description**: Indicates whether to sync data items in bulk (true) or not (false). Synchronize data items in bulk only if there are no dependencies between transactions. - **Default value**: false ### IsDebugMode - **Type**: boolean - **Properties**: Create, Defaulted on create, Filter, Group, Sort, Update - **Description**: Indicates whether the sync runs in debug mode (true) or not (false). - **Default value**: false ### IsOwnerPermissionEnforced - **Type**: boolean - **Properties**: Create, Defaulted on create, Filter, Group, Sort, Update - **Description**: Indicates whether to respect the user permissions of the transaction record’s owner during the sync (true) or not (false). - **Default value**: false ### IsRealTime - **Type**: boolean - **Properties**: Create, Defaulted on create, Filter, Group, Sort, Update - **Description**: Indicates whether the transaction is eligible for real-time batch processing (true) or not (false). - **Default value**: false ### IsRetry - **Type**: boolean - **Properties**: Defaulted on create, Filter, Group, Sort - **Description**: Indicates whether the sync is a retry operation (true) or not (false). This field is a calculated field. - **Default value**: false ### IsSimulatable - **Type**: boolean - **Properties**: Defaulted on create, Filter, Group, Sort - **Description**: Indicates whether the simulate operation applies to the transaction (true) or not (false). This field is a calculated field. - **Default value**: false ### IsWithSignedItem - **Type**: boolean - **Properties**: Create, Defaulted on create, Filter, Group, Sort, Update - **Description**: Indicates whether the transaction includes data items with a signature (true) or not (false). - **Default value**: false ### LastReferencedDate - **Type**: dateTime - **Properties**: Filter, Nillable, Sort - **Description**: The timestamp when the current user last accessed this record indirectly, for example, through a list view or related record. ### LastRunDebug - **Type**: string - **Properties**: Create, Filter, Group, Nillable, Sort, Update - **Description**: The ID associated with the debug log attachment from the most recent sync. ### LastRunLogId - **Type**: reference - **Properties**: Create, Filter, Group, Nillable, Sort, Update - **Description**: The transaction log from the most recent sync. If no errors occurred, the log is empty. This field is a relationship field. - **Relationship Name**: LastRunLog - **Relationship Type**: Lookup - **Refers To**: DeviceSyncTransactionLog ### LastViewedDate - **Type**: dateTime - **Properties**: Filter, Nillable, Sort - **Description**: The timestamp when the current user last viewed this record or list view. If this value is null, and LastReferenceDate is not null, the user accessed this record or list view indirectly. ### MetadataVersion - **Type**: string - **Properties**: Create, Filter, Group, Sort, Update - **Description**: Required. The metadata version for data from the mobile device. ### Name - **Type**: string - **Properties**: Autonumber, Defaulted on create, Filter, idLookup, Sort - **Description**: A system-generated identifier for the device sync transaction. ### NumberOfFailedAttempts - **Type**: int - **Properties**: Create, Filter, Group, Nillable, Sort, Update - **Description**: The number of sync failures for the transaction. ### OfflineTimestamp - **Type**: dateTime - **Properties**: Create, Filter, Sort, Update - **Description**: Required. The timestamp when the record from the mobile device occurred. ### OfflineUniqueIdentifier - **Type**: string - **Properties**: Create, Filter, Group, idLookup, Sort, Update - **Description**: Required. A unique identifier for the record from the mobile device. ### OwnerId - **Type**: reference - **Properties**: Create, Defaulted on create, Filter, Group, Sort, Update - **Description**: The ID of the owner of the record. This field is a polymorphic relationship field. - **Relationship Name**: Owner - **Refers To**: Group, User ### Sequence - **Type**: int - **Properties**: Create, Filter, Group, Nillable, Sort, Update - **Description**: Order position of the transaction in relation to other transactions to sync. Use sequence values to process device sync transactions in a specific order. ### Status - **Type**: picklist - **Properties**: Create, Filter, Group, Restricted picklist, Sort, Update - **Description**: Required. The sync status. - **Possible values**: - Canceled - Failed - InProgress - Manual - New - Retry - Success - Waiting ### TotSyncTranRecordCount - **Type**: int - **Properties**: Filter, Group, Nillable, Sort - **Description**: The number of data items in the transaction. This field is a calculated field. ### TransactionSource - **Type**: picklist - **Properties**: Create, Filter, Group, Nillable, Restricted picklist, Sort, Update - **Description**: The application that stores the data items to sync. - **Possible values**: - CLM. ### UserDeviceData - **Type**: textarea - **Properties**: Create, Nillable, Update - **Description**: User data from the mobile device. ### GroupIdentifier - **Type**: string - **Properties**: Create, Filter, Group, Nillable, Sort, Update - **Description**: A unique identifier shared by all device sync transactions that originated from the same mobile transaction. Populated only when the mobile device splits a large transaction into multiple transactions. ### GroupRecordCount - **Type**: int - **Properties**: Create, Filter, Group, Nillable, Sort, Update - **Description**: The total number of device sync transactions in the group. The server uses this count to confirm that all transactions have arrived before processing. Populated only when the mobile device splits a large transaction into multiple transaction. ## Associated Objects This object has the following associated objects. If the API version isn’t specified, they’re available in the same API versions as this object. Otherwise, they’re available in the specified API version and later. [DeviceSyncTransactionFeed](https://developer.salesforce.com/docs/atlas.en-us.life_sciences_dev_guide.meta/life_sciences_dev_guide/sforce_api_associated_objects_feed.htm "StandardObjectNameFeed is the model for all feed objects associated with standard objects. These objects represent the posts and feed-tracked changes of a standard object.") Feed tracking is available for the object. [DeviceSyncTransactionHistory](https://developer.salesforce.com/docs/atlas.en-us.life_sciences_dev_guide.meta/life_sciences_dev_guide/sforce_api_associated_objects_history.htm "StandardObjectNameHistory is the model for all history objects associated with standard objects. These objects represent the history of changes to the values in the fields of a standard object.") History is available for tracked fields of the object.