Referencing local data sources using ID instead of path

-

In my previous blog post we discussed about the problem with renaming local data sources and the issue with converting data sources created in a hierarchical structure to IDs using the out of the box PowerShell script. In this post I am going to show how to prevent using path to reference local data sources in the first place.

Sitecore decides on whether to use ID or path to link data source to the rendering in presentation details at the time of selection of data source using the Select Associated Content dialog.


So, I decided to take a look into what's happening behind the scenes when you click OK on this dialog using the network traffic monitor in the browser developer tools. I noticed a call to the following URL with the below response.

https://demo.dev.local/sitecore/shell/default.aspx?xmlcontrol=Sitecore.Shell.Applications.Dialogs.SelectRenderingDatasource&...


The response has a command called SetDialogValue with the path of local data source as value. The same call has different response value for the SetDialogValue command when I selected a shared data source. Instead of path I got ID of the selected data source item in response.


From the request URL I found that Sitecore.Shell.Applications.Dialogs.SelectRenderingDatasource is the XML control responsible for handling this request, so I decided to take a look into the control located at 

<SitecoreRoot>\sitecore\shell\Applications\Dialogs\SelectRenderingDatasource\SelectRenderingDatasource.xml
If you are using SXA, this dialog control is overridden, so you can find the control at the following path.
<SitecoreRoot>\sitecore\shell\Override\Applications\Dialogs\SelectRenderingDatasource\SelectRenderingDatasource.xml
Taking a look into the XML revealed the code beside class used by the control


To override the default behaviour I created a custom class inheriting from Sitecore.XA.Foundation.LocalDatasources.Dialogs.SelectRenderingDatasourceForm and overridden the SelectDialogResult method to always return the ID for both local and shared data sources.

Now to make the SelectRenderingDatasourceForm to use our custom class, make a copy of the  <SitecoreRoot>\sitecore\shell\Override\Applications\Dialogs\SelectRenderingDatasource\SelectRenderingDatasource.xml file and copy it to <SitecoreRoot>\sitecore\shell\Override\SelectRenderingDatasource.xml. Open the file in any text editor and change the Code beside tag value to our custom class.


With our override in place the Select Associated Content dialog will now store IDs for both local and shared data sources which will fix the issue with renaming local data sources permanently. One drawback of this is the path of the local data source in the Control Properties dialog will no longer show local:/..., it will always start from the root sitecore/... node.

If you find this article useful or if you have any questions leave a comment in  the comments section.
 

Comments

Post a Comment

Popular posts from this blog

SXA Scriban extension to get link field target URL

-
Scriban is the new templating language which was introduced in Sitecore 9.3, it replaces the obsolete NVelocity templates in the earlier versions. If you are upgrading from earlier versions of Sitecore and used a lot of NVelocity templates, you need to convert all your NVelocity templates to Scriban as NVelocity is no longer supported in Sitecore 9.3. Scriban is a powerful language with support to import your own .Net functions. Sitecore provides a rich set of Scriban extensions to use which meets most of the common requirements. You can find more about the out of the box Sitecore Scriban extensions here . While using Scriban to create custom markup which can't be achieved through other Rendering Variant fields I came across a requirement to wrap a section of HTML with an anchor tag targeting to an URL set in a link field in the template. In SXA we would set the link target field on the Rendering Variant and set the Is Link property value of the Rendering Variant field to W
Read more

View and download Sitecore log files using Log Viewer

-
Image
As a Sitecore developer you would want to regularly monitor the log files for recurring errors and warnings and keep them clean. I am quite used to downloading my log files and running the tools like Sitecore Log Analyzer to filter and group errors and warnings.  As we started to productionise our website and apply the security hardening best practices, I ended up losing access to the logs folder and admin pages. To complicate the things further we started using containers to host our Sitecore instance with zero access to file system for developers, even when it is needed for troubleshooting issues.  The only way I could access the logs was using AWS Log Insights which gives you a stream of events without any option to download the full log file. It is especially difficult to troubleshoot issues when you need to correlate events from multiple logs which means you need to look for events across multiple log streams and try to put together the jigsaw puzzle to see the full picture. This
Read more

How to ace your Sitecore .Net Developer 10 Certification Exam

-
Image
  I have been a Sitecore developer for five years and worked on various Sitecore projects, yet every time I take the certification exam it makes me nervous. From my conversations with the other Sitecore developers I worked with, even the most experienced Sitecore developers are nervous about failing the certification exam. They try to avoid taking the exam unless absolutely necessary. A few reasons for this could be, The exam is too expensive to fail. Most employers will only reimburse the fee for successful certification attempts. The score required to pass the exam is quite high (80%) compared to your academic exams.  The Sitecore training modules for exam competencies can be expensive. Not everyone gets a chance to work on the latest version of Sitecore. The exam competencies include areas of Sitecore you never had a chance to work on. In this blog post I will share my most recent experience of preparing and successfully completing the Sitecore .NET 10 Developer certification exam.
Read more