{"id":3787,"date":"2016-10-26T16:47:40","date_gmt":"2016-10-26T11:17:40","guid":{"rendered":"https:\/\/www.inogic.com\/blog\/?p=3787"},"modified":"2016-10-26T16:47:40","modified_gmt":"2016-10-26T11:17:40","slug":"programmatically-publish-customizations-in-dynamics-crm","status":"publish","type":"post","link":"https:\/\/www.inogic.com\/blog\/2016\/10\/programmatically-publish-customizations-in-dynamics-crm\/","title":{"rendered":"Programmatically Publish Customizations in Dynamics CRM"},"content":{"rendered":"

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

In Dynamics CRM, to make the entity customization changes visible it is important to \u201cPublish\u201d the customization. The customization could be changes to the entity metadata or form design or adding buttons to the ribbon bar. You can also import solutions that update the customizations and publish them.<\/p>\n

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

In one of the processes that we were designing it required updating of data to the XML web resource as part of the solution configuration process. We did not want the user to manually manipulate the XML resource as it could be error-prone and therefore a suitable UI provided for data entry which would then programmatically need to be updated to the XML web resource.<\/p>\n

While it was easy to update the content in the XML web resource. We noticed that the changes didn\u2019t take effect until the web resource was published. Here we discuss how we can programmatically publish the customizations.<\/p>\n

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

One must take a note that, publishing customizations causes the CRM application to freeze for the moment, (i.e. till the customizations get published) and thus should be used thoughtfully and executed from within operations that are performed during non-business hours.<\/strong><\/p>\n

To publish data programmatically CRM SDK<\/a> has provided two messages.<\/p>\n

    \n
  1. PublishXmlRequest<\/a> – Publishes a single component.<\/li>\n
  2. PublishAllXmlRequest<\/a> – Publishes all the customizations.<\/li>\n<\/ol>\n

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

    We will publish an XML Webresource in our example using the PublishXMLRequest.<\/p>\n

    Kindly refer PublishXmlRequest.ParameterXml<\/a> property to refer to the xml, required to be passed to publish different solution components (like Entity, Ribbons, Dashboards, etc.\u2026).<\/p>\n

    In our case since it is web resource we would be providing the following xml to the publish message.<\/p>\n

    string webResctag = “<webresource>” + webResourceId + “<\/webresource>”;<\/p>\n

    string webrescXml = “<importexportxml><webresources>” + webResctag + “<\/webresources><\/importexportxml>”;<\/p>\n

    Here we update the content of the web resource:<\/strong><\/p>\n

    Entity webSrc = new Entity(\"webresource\");\n\n\/\/Set the id of the webresource\nwebSrc.Id = webResourceId;\n\n\/\/Set the content of the webresource\nwebSrc.Attributes[\"content\"] = content;\n\nUpdateRequest updaterequest = new UpdateRequest{Target = webSrc};<\/pre>\n
    Following is the code to publish the updated web resource:<\/strong><\/p>\n
    string webResctag = \"<webresource>\" + webResourceId + \"<\/webresource>\";\n\nstring webrescXml = \"<importexportxml><webresources>\" + webResctag + \u00a0\u00a0\u00a0\"<\/webresources><\/importexportxml>\";\n\n\u00a0 PublishXmlRequest publishxmlrequest = new PublishXmlRequest\n\n\u00a0 {\n\n\u00a0\u00a0\u00a0\u00a0 ParameterXml = String.Format(webrescXml)\n\n\u00a0 };<\/pre>\n
    Following is the code to execute both the requests sequentially: \u00a0\u00a0<\/strong><\/p>\n
    ExecuteMultipleRequest executemultiplerequest = new ExecuteMultipleRequest();\n\n\u00a0 executemultiplerequest.Settings = new ExecuteMultipleSettings();\n\n\u00a0 executemultiplerequest.Settings.ContinueOnError = false;\n\n\u00a0 executemultiplerequest.Settings.ReturnResponses = true;\n\n\u00a0 executemultiplerequest.Requests = new OrganizationRequestCollection();\n\n\u00a0 executemultiplerequest.Requests.Add(updaterequest);\n\n\u00a0 executemultiplerequest.Requests.Add(publishxmlrequest);<\/pre>\n
    \/\/Below is the execute method of IOrganizationServiceFactory <\/strong>interface which will execute the ExecuteMultipleRequest<\/strong><\/p>\n
    \/\/<\/strong> organizationservice is the object of the IOrganizationServiceFactory <\/strong>interface.<\/p>\n
    organizationservice.Execute(executemultiplerequest);<\/p>\n
    Now if one wants to publish all the customizations at a go, then \u2018PublishAllXmlRequest\u2019<\/strong> is what is needed.<\/p>\n
    Following is the code to publish all the customisations of an organisation:<\/strong><\/p>\n
    PublishAllXmlRequest publishallxmlrequest = new PublishAllXmlRequest();<\/pre>\n
    NOTE:<\/strong><\/p>\n