Dynamics SL 2015 Customization Upgrade Gotcha

I had a great time attending the Dynamics SL User Group in San Antonio this week! Thanks to everyone who worked to hard to make it an informative and fun event!!!
In an interactive session with SL developer legend, Tom Malia, he mentioned a gotcha while upgrading VBA customization code to version 2015. Tom said he had been frustrated and searched the internet to no avail for help with the issue. I ran into the same thing earlier myself and thought, at the time, that I would blog about it. Sometimes, though, I feel that writing about crazy little things that take too much time is boring and not particularly helpful to many people. Maybe so. But on the other hand I have often been grateful for a post someone else wrote when they got stuck.
You will notice this issue when you upgrade a fully functioning VBA customization with code for the Update1 control to Dynamics SL 2015. In other words, the customization works without any errors on version 2011. If you open the customization and try to save it you will get System Message 20217 “The VBA code could not be compiled for execution. The project was successfully saved to the database.” Most likely none of the code in your customization will run, so you may well get other errors as a result. For example, if you have a control on a form that uses a buffer you declared with a VBA_SetAddr statement, you will see System Message 10051 “Setaddr() has not been called for <YourBufferName>. Error in property of control Form1.<CustomControlName>. A setaddr call should be made in Form1_Load event of Basic Script Language macro code.”… and so forth. What, you ask? Basic Script Language isn’t installed and there are no Basic Script Language customizations associated with the screen. Perhaps there were not even any for version 2011. Now, both of these errors can occur for other reasons, which I why I italicized fully functioning.
The problem is that a signature changed for the methods associated with the control named Update1 by default, whose name is never changed in the standard Dynamics SL screens. The method used to have a signature for its event handlers like this:
Sub Update1_OnUpdate(Level As Integer, RetVal As Integer)
or
Sub Update1_OnUpdate(level%, insertflg%, retval%)
Now, it’s:
Sub Update1_OnUpdate(ByVal Level As Integer, ByVal InsertFlg As Integer, ByRef RetVal As Integer)
Chances are that you have never written the line of code that broke. You just let the VBA Developer Environment create it. It created the handler without ByVal on the initial parameters. Thus it’s about the last place you might expect to look for an error.
The documentation for this has not been updated… not in the help (it just has “(level%…)”, or in the PDF documentation. The compiler doesn’t give you a clue that this is what’s wrong. You can export the customization and import it without creating an event log. It’s easy to just overlook the ByVal, even if you let the IDE recreate the method. ByRef is the default for VBA, unless ByVal is specified. Now ByVal is required for all but the RetVal parameter on all the Update1 events (OnCancel, OnDelete, OnInsert, OnUpdate), and it’s not documented. Simply adding this keyword (to all but the last parameter; some have three parameters) resolves the issue.
One suggestion Tom made was to export all the customizations and merge them into a single text file. Then it is possible to fix all the Update1 handlers with a single “Replace All” command. Thanks, Tom, for refreshing my memory about something that will doubtlessly come up again, and motivating me to write about it.
(Posted from 30,000 feet. 🙂 )

12 Comments

  1. Melissa November 12, 2015 1:49 pm  Reply

    Thank you!!!! You just saved me a TON of time!

  2. Gregg Katz January 29, 2016 11:29 am  Reply

    Hi Tom,
    I am running into an issue where none of the Update control events seem to be firing, ugh!

    • Delmer Johnson January 29, 2016 11:42 am  Reply

      Hi Greg,

      Thanks for your comment. I was writing about Tom Malia’s presentation in this blog post, but this isn’t his site.

      Are other events firing in your customization? Can you set breakpoints in the VBA editor and hit them? If not, make sure you’re on the same customization level.

      Delmer

  3. Adam March 22, 2016 1:35 pm  Reply

    Thanks. This post was a huge help and time saver.

  4. Mike Lee April 21, 2016 1:39 pm  Reply

    Thanks Delmer! You Just saved me a ton of time.

  5. John February 20, 2017 10:04 am  Reply

    I just ran into this today with an upgrade. The post is well worth it! I have used Tom several times with helping me writing code. A great programmer and a great teacher as well.

  6. Vicktor Halim November 5, 2017 11:36 pm  Reply

    How to replace all event update1 in screen customization? Which editor can i use for that?
    Thanks

    • Delmer Johnson November 6, 2017 8:13 am  Reply

      Export all the customizations as text. Then you can use any text editor (for example, Notepad++) and, when finished, import them all again.

  7. Delmer Johnson February 20, 2019 3:10 pm  Reply

    This also applies if you’re upgrading from Dynamics SL 2011 to SL 2018 with or without CU1.

  8. Alex February 27, 2020 12:32 pm  Reply

    Don´t work in SL 2018, something change?

    • Delmer Johnson February 27, 2020 12:53 pm  Reply

      I have used this several times with SL 2018 with CU1 through CU3, including earlier this week. Can you reply with the line in your customization that contains “Sub Update1_On…”?

  9. mark g November 5, 2020 1:20 pm  Reply

    Yep, spent 3 days trying exports between 2011 and 2018 trying to figure out why some screens wouldnt launch.

Leave a Reply to John Cancel reply