How to handle dashboard link in email notifications when sharing content

In a client application that embeds a dashboard page, if you want the share link in the embedded dashboard page to be the client application URL instead of the embedded dashboard URL, you need to configure the "Host Web Portal" in the client application settings:

If you set the "Host Web Portal" value to be the URL of the client application, when you share the dashboard via email:

The link in the email would be a url like:

http://{hostWebPortal}?mstrLibraryLink=https%3A%2F%2Fdemo%2Emicrostrategy%2Ecom%3A8080%2FMicroStrategyLibrary%2Fapp%2F9D8A49D54E04E0BE62C877ACC18A5A0A%2F0627433046E1B80BCE681C87E48F5C28%2Fbookmarks%3Fids%3D77776092475755EE696EEABF94CF3A61

You can see it's the client application URL, not the embedded dashboard URL. However, in this URL, the url-encoded result of the embedded dashboard url is still stored in the value of the query parameter mstrLibraryLink. In the above case, it's the url-encoded result of

https://demo.microstrategy.com:8080/MicroStrategyLibrary/app/9D8A49D54E04E0BE62C877ACC18A5A0A/0627433046E1B80BCE681C87E48F5C28/bookmarks?ids=77776092475755EE696EEABF94CF3A61

So the client application could use this URL to recover the status of the embedded dashboard page. It could get the embedded dashboard url via the parameter mstrLibraryLink like this:

// The original embeded dashboard URL. Would be used if there is no "mstrLibraryLink" parameter
let dossierUrl =
  "https://demo.microstrategy.com:8080/MicroStrategyLibrary/app/9D8A49D54E04E0BE62C877ACC18A5A0A/0627433046E1B80BCE681C87E48F5C28";
// The logic to get the embedded dashboard URL
const url = new URL(window.location.href);
const mstrLibraryLink = url.searchParams.get("mstrLibraryLink");
// Use this URL to replace the original URL if you want
if (mstrLibraryLink) {
  dossierUrl = mstrLibraryLink;
}

microstrategy.dossier.create({
  url: dossierUrl,
  placeholder: document.getElementById("containerA"),
});