Skip to main content

Notifications

Announcements

No record found.

News and Announcements icon
Community site session details

Community site session details

Session Id :
Dynamics 365 Community / Forums / Microsoft Dynamics CRM (Archived) / MIGRATING FROM SELF HO...
Microsoft Dynamics CRM (Archived)

MIGRATING FROM SELF HOSTED PORTAL TO ONLINE

(0) ShareShare
ReportReport
Posted on by mchgn.nstars 2

Hello,

some of our customers are using Self-hosted Dynamics 365 Portal (official open source release from Microsoft). Link to portal solution download page: https://www.microsoft.com/en-us/download/details.aspx?id=55789

I've found an article on internet about important changes coming out with next major release related to Dynamics 365 Customer Engagement. Link to article: https://docs.microsoft.com/en-us/dynamics365/get-started/whats-new/customer-engagement/important-changes-coming

In this article is written that some APIs will become deprecated (for example Xrm.Page). I've found out these APIs are also used in web resources with adx prefix, so our customers will have to upgrade their portal to online version.

For example Xrm.Page is used in: adx_ace\ace.js , adx_adx.js, adx_annotations\adx.annotations.js .

What is the best way to migrate from open source MS Portal to online version without destroying customizations made by our company?

I predict that solution components for Dynamics CRM online portal are different from components included in current open source portal solution? What is best praxis to do migration?

Thank you in advance!

Matej

*This post is locked for comments

  • mchgn.nstars Profile Picture
    mchgn.nstars 2 on at
    RE: MIGRATING FROM SELF HOSTED PORTAL TO ONLINE

    Thank you both for your help and answers. We are using open source version of portal with no major changes in code. All portal customizations were made within CRM (entity lists, web templates, etc..).

  • Verified answer
    Nicholas Hayduk Profile Picture
    Nicholas Hayduk 2,863 on at
    RE: MIGRATING FROM SELF HOSTED PORTAL TO ONLINE

    Hi Matej,

    The official guidance from Microsoft on moving from self-hosted to online can be found at cloudblogs.microsoft.com/.../migrate-from-adxstudio-7-to-portal-capabilities-for-dynamics-365

    Long story short, you need to be on the open-source version of the code (so you have to upgrade if you're on Adxstudio v7), and then you can ask Microsoft to switch you over to the online version.  The key is that you can't customize any of the code in the MasterPortal project.  This is the code that Microsoft hosts for you, and you can't change.  So if you have any functionality that involves editing that code, it will have to be reimplemented using either out-of-the-box features, or you'll need to do something like a Companion App to build out the features.

    Hope that helps.

    Nick

  • Verified answer
    oliver.rodrigues Profile Picture
    oliver.rodrigues 4,052 on at
    RE: MIGRATING FROM SELF HOSTED PORTAL TO ONLINE

    hello again Matej

    first, you need to identify any changes made within the Portal source code, and see how (if possible) you can migrate those to a D365 Online Portals

    in regards the Portal components itself, there is no major difference on how we make customization like creating entity list / entity form / metadatas / etc.. so this is all easy to migrate

    I suggest you create a trial environment and push your portal data into it (as well as your custom entities/solutions etc)... so you can identify any possible gaps

Under review

Thank you for your reply! To ensure a great experience for everyone, your content is awaiting approval by our Community Managers. Please check back later.

Helpful resources

Quick Links

🌸 Community Spring Festival 2025 Challenge Winners! 🌸

Congratulations to all our community participants!

Adis Hodzic – Community Spotlight

We are honored to recognize Adis Hodzic as our May 2025 Community…

Kudos to the April Top 10 Community Stars!

Thanks for all your good work in the Community!

Leaderboard > Microsoft Dynamics CRM (Archived)

#1
Mohamed Amine Mahmoudi Profile Picture

Mohamed Amine Mahmoudi 83 Super User 2025 Season 1

#2
Community Member Profile Picture

Community Member 52

#3
Victor Onyebuchi Profile Picture

Victor Onyebuchi 6

Overall leaderboard

Featured topics

Product updates

Dynamics 365 release plans