{"id":33407,"date":"2022-12-20T15:47:40","date_gmt":"2022-12-20T10:17:40","guid":{"rendered":"https:\/\/www.inogic.com\/blog\/?p=33407"},"modified":"2023-07-17T11:51:49","modified_gmt":"2023-07-17T06:21:49","slug":"how-to-trigger-the-plugin-on-any-business-process-flow-stage-change-and-update-custom-entity-record-related-to-the-active-stage","status":"publish","type":"post","link":"https:\/\/www.inogic.com\/blog\/2022\/12\/how-to-trigger-the-plugin-on-any-business-process-flow-stage-change-and-update-custom-entity-record-related-to-the-active-stage\/","title":{"rendered":"How to trigger the plugin on any Business Process Flow stage change and update custom entity record related to the Active Stage"},"content":{"rendered":"

Introduction<\/strong><\/h2>\n

Recently while working on a customer requirement, we came across a scenario where we needed to trigger a plugin on change of Business Process Flow stages. So, in the pursuit of finding a solution, we came across workflow and process stage entities, but they were not very useful in this scenario. Our requirement was to trigger the plugin on the Business Process Flow<\/a> stage change of an Employee entity. So, we tried writing a plugin for the update of an Employee entity. There\u2019s one field \u201cstageid\u201d on every entity on which a Business process flow is configured. We thought on the change of the Business Process Flow stage this field might be getting updated with the Id of the current active stage, which we can further use to fulfill our requirement. But to our disappointment, this field is now deprecated and thus we are left empty-handed.<\/p>\n

Further investigation brought light to the reality i.e., for every Business Process Flow, a subsequent Entity gets created in Dynamic365 CRM. In this blog, we shall further see how using this entity, we achieved the customer\u2019s requirement.<\/p>\n

Scenario:<\/strong><\/h2>\n

To handle the recruitment process there\u2019s an Employee table as well as an Employee Stages table. We want to update the status of the related Employee Stage record for whichever stage currently is active.<\/p>\n

In the below Image, we can see that even when we changed the stage of the Employee record the stage id stays blank. In the name itself, we can see it is stated that it\u2019s now deprecated.<\/p>\n

\"Business<\/p>\n

Solution:<\/strong><\/p>\n

The below image represents the Business Process Flow on the Employee Entity to handle the employee recruitment process.<\/p>\n

\"Business<\/p>\n

\"Business<\/p>\n

In the above screenshot, we can see that CRM created an entity for the custom Business Process Flow, and it contains the \u201cactivestageid<\/strong>\u201d field which has the current active stage for a particular record.<\/p>\n

Now we will write a plugin on the update of the above Business Process Flow entity <\/strong>and add the filtering attribute of \u201cactivestageid<\/strong>\u201d.<\/p>\n

\"Business<\/strong>In the below image, we find the first record of the Employee Stages entity having the status as Active, and the remaining records are currently in an Inactive state.<\/p>\n

\"Business<\/p>\n

When we change the stage of the Business Process Flow from Sourcing to Screening, using our plugin we are changing the status of the related Employee Stages entity record named Screening to Active.<\/p>\n

\"Business<\/p>\n

Code: <\/strong><\/p>\n

private void changeBPFstage(PluginConfig config, StringBuilder traceLogBuilder, Entity targetEntity)\r\n\r\n{\r\n\r\n\/\/Get current BPF activestageID\r\n\r\nEntityReference currentBpfStageId = targetEntity.Attributes.Contains(\"activestageid\") ? targetEntity.GetAttributeValue<EntityReference>(\"activestageid\") : null;\r\n\r\n\/\/Execute Fetchxml\r\n\r\nstring fetchXML = \"< fetch >\" +\r\n\r\n\" <entity name='new_employeestage'>\" +\r\n\r\n\" <attribute name='new_ employeestageid'\/>\" +\r\n\r\n\" <filter type ='and'>\" +\r\n\r\n\" <condition attribute='new_ employeestageid' operator= 'eq' value='\"+currentBpfStageId+\"'\/>\" +\r\n\r\n\" <\/ filter>\" +\r\n\r\n\"<\/ entity>\" +\r\n\r\n\" <\/fetch>\";\r\n\r\n\u00a0\r\n\r\nEntityCollection entityCollection = config.Service.RetrieveMultiple(new FetchExpression(fetchXML));\r\n\r\n\/\/To check entitycollection count is greater than 0\r\n\r\nif(entityCollection.Entities.Count>0)\r\n\r\n{\r\n\r\n\/\/Update status of employee record\r\n\r\nEntity entemployee = new Entity(\"new_employeestage\", targetEntity.Id);\r\n\r\nentemployee.Attributes[\"statuscode\"] = new OptionSetValue(1);\r\n\r\nentemployee.Attributes[\"statecode\"] = new OptionSetValue(0);\r\n\r\nconfig.Service.Update(entemployee);\r\n\r\n}\r\n\r\n}<\/pre>\n
Conclusion<\/h2>\n
In this way, we can easily call the plugin on the Business Process Flow stage change.<\/p>\n
\"Business<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"
Introduction Recently while working on a customer requirement, we came across a scenario where we needed to trigger a plugin on change of Business Process Flow stages. So, in the pursuit of finding a solution, we came across workflow and process stage entities, but they were not very useful in this scenario. Our requirement was\u2026 Read More »<\/a><\/span><\/p>\n","protected":false},"author":13,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"om_disable_all_campaigns":false,"_monsterinsights_skip_tracking":false,"_monsterinsights_sitenote_active":false,"_monsterinsights_sitenote_note":"","_monsterinsights_sitenote_category":0,"footnotes":""},"categories":[2361],"tags":[226,2648],"class_list":["post-33407","post","type-post","status-publish","format-standard","hentry","category-technical","tag-business-process-flow-dynamics-365","tag-business-process-flow-stage"],"aioseo_notices":[],"_links":{"self":[{"href":"https:\/\/www.inogic.com\/blog\/wp-json\/wp\/v2\/posts\/33407","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.inogic.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.inogic.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.inogic.com\/blog\/wp-json\/wp\/v2\/users\/13"}],"replies":[{"embeddable":true,"href":"https:\/\/www.inogic.com\/blog\/wp-json\/wp\/v2\/comments?post=33407"}],"version-history":[{"count":0,"href":"https:\/\/www.inogic.com\/blog\/wp-json\/wp\/v2\/posts\/33407\/revisions"}],"wp:attachment":[{"href":"https:\/\/www.inogic.com\/blog\/wp-json\/wp\/v2\/media?parent=33407"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.inogic.com\/blog\/wp-json\/wp\/v2\/categories?post=33407"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.inogic.com\/blog\/wp-json\/wp\/v2\/tags?post=33407"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}