{"id":1291,"date":"2015-05-26T12:57:07","date_gmt":"2015-05-26T07:27:07","guid":{"rendered":"https:\/\/www.inogic.com\/blog\/?p=1291"},"modified":"2015-05-26T12:57:07","modified_gmt":"2015-05-26T07:27:07","slug":"change-tracking-feature-of-crm-2015-update-1","status":"publish","type":"post","link":"https:\/\/www.inogic.com\/blog\/2015\/05\/change-tracking-feature-of-crm-2015-update-1\/","title":{"rendered":"Change Tracking Feature of CRM 2015 Online Update 1"},"content":{"rendered":"

As we have integration of Dynamics CRM with other external systems, in that case we need to keep track of changes that were done after last synchronization of data and we integrate only those changes in external system. To achieve this previously we have to add some kind of custom logic like add one date field in CRM to track the date of last synchronization. Now, in CRM 2015 update 1 we have a built-in functionality to achieve this, it is called Change Tracking<\/strong>.<\/p>\n

Change Tracking<\/strong> is used in Dynamics CRM to keep the data synchronized in a better way by detecting what data has changed since the data was last synchronized.<\/p>\n

To retrieve the changes for an entity, we need to enable the Change Tracking<\/strong> functionality for that entity.<\/p>\n

This feature can be enabled by using the customization user interface (UI) or programmatically by setting the\u00a0ChangeTrackingEnabled<\/strong><\/a><\/span>\u00a0property to\u00a0True<\/strong>.<\/p>\n

\"ChangeTracking2\"<\/a><\/p>\n

To achieve this functionality CRM\u00a02015<\/strong> has introduced a new request called RetrieveEntityChangesRequest.<\/p>\n

When you execute this request for the very first time, then it returns all records for the entity and that data can be used to sync into any other external system. The message also returns a DataToken<\/strong>\u00a0that we can use in the RetrieveEntityChangesRequest, so that when we execute this request the next time then it returns data for those changes that occurred since last execution of request.<\/p>\n

If you want to get the changed data(created\/updated\/deleted) of Account since last execution of request then RetrieveEntityChangesRequest message is used to retrieve the data. After executing this request it will return the BusinessEntityChangesCollection of new\/updated and deleted records. The new\/updated records can be retrieved from NewOrUpdatedItem and deleted item can be retrieved from RemovedOrDeletedItem.<\/p>\n

Following is the sample code for RetrieveEntityChangesRequest<\/strong>:<\/p>\n

RetrieveEntityChangesRequest changeTracking = new RetrieveEntityChangesRequest();<\/p>\n

\/\/set the properties<\/p>\n

changeTracking.Columns = new ColumnSet(true);<\/p>\n

changeTracking.DataVersion = “471550!05\/15\/2015 10:08:13”;<\/p>\n

changeTracking.EntityName = “account”;<\/p>\n

changeTracking.PageInfo = new PagingInfo() { Count = 5000, PageNumber = 1, ReturnTotalRecordCount = false };<\/p>\n

RetrieveEntityChangesResponse res = (RetrieveEntityChangesResponse)_service.Execute(changeTracking);<\/p>\n

\/\/get the token<\/p>\n

string dataToken = res.EntityChanges.DataToken;<\/p>\n

BusinessEntityChangesCollection busEntChanColl = res.EntityChanges.Changes;<\/p>\n

for (int bizColl = 0; busEntChanColl.Count > bizColl; bizColl++)
\n{
\nif (busEntChanColl[bizColl].Type.ToString().ToLowerInvariant() == “neworupdated”)
\n{
\nNewOrUpdatedItem createUp =(NewOrUpdatedItem) busEntChanColl[bizColl];
\nEntity changedEnt = createUp.NewOrUpdatedEntity;
\n}
\nelse if(busEntChanColl[bizColl].Type.ToString().ToLowerInvariant() == “removeordeleted”)
\n{
\nRemovedOrDeletedItem removeOrDelItem = (RemovedOrDeletedItem)busEntChanColl[bizColl];
\nEntityReference delItem = removeOrDelItem.RemovedItem;
\n}
\n}<\/p>\n

If you doesn`t provide the DataVersion<\/strong> parameter for request then it will always return all records.<\/p>\n

So to retrieve only records those are Created\/Updated\/Delete after the last execution of request then you have to provide the DataVersion<\/strong> parameter, DataToken<\/strong> returned by previous execution of request is what we have to pass as DataVersion <\/strong>new value for the next request.<\/p>\n

For example: res.EntityChanges.DataToken<\/strong> in the above code snippet gives us the DataToken<\/strong>.<\/p>\n

If you have the windows service\/ windows application for integration of CRM with another system then you can store the DataToken<\/strong> value in app.config<\/strong>. If you used it in a plug-in or a workflow then it is better to create custom entity<\/strong> to store value of DataToken<\/strong>.<\/p>\n","protected":false},"excerpt":{"rendered":"

As we have integration of Dynamics CRM with other external systems, in that case we need to keep track of changes that were done after last synchronization of data and we integrate only those changes in external system. To achieve this previously we have to add some kind of custom logic like add one date\u2026 Read More: Change Tracking Feature of CRM 2015 Online Update 1 »<\/a><\/span><\/p>\n","protected":false},"author":13,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[15,23,24],"tags":[266,597],"class_list":["post-1291","post","type-post","status-publish","format-standard","hentry","category-development","category-dynamics-crm-2015-update-1","category-dynamics-crm-2016","tag-change-tracking","tag-dynamics-crm-2015"],"aioseo_notices":[],"aioseo_head":"\n\t\t\n\t\n\t\n\t\n\t\n\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t