Dynamics 365站点地图中添加动态链接

我是微软Dynamics 365 & Power Platform方面的工程师/顾问罗勇，也是2015年7月到2018年6月连续三年Dynamics CRM/Business Solutions方面的微软最有价值专家(Microsoft MVP)，欢迎关注我的微信公众号 MSFTDynamics365erLuoYong ，回复424或者20201010可方便获取本文，同时可以在第一间得到我发布的最新博文信息，follow me!

有时候我们需要在站点地图中添加链接，如果是静态链接，比较好办，比如链接到某个公共网址裁判文书网，网址是 https://wenshu.court.gov.cn/ ，这么设置下就可以

但是如果这个网址是动态的，比如一个Canvas App 的URL，不同的环境(environment)是不同的，那如何设置呢？如果设置为某个环境的URL，那么新环境就需要手动更改，每次更改容易忘记，也不方便。这时候可以考虑将这个导航项目设置为某个HTML 类型的Web资源，类似如下。

这种做法可以做到在当前页面打开，也就是在导航项目的右边打开，如果需要在新窗口中打开呢？那就需要在代码中使用类似 window.open 代码。这个还有个问题，那么右边的显示区域是空白的，还好颜色是主题的背景色，不算太违和。你会发现，如果导航项目设置的是绝对URL，那么点击这个导航项目会直接将绝对URL在新Tab中打开，导航项目不会变化，比如之前打开的是Case实体，还是保留在Case实体。如何也做到类似的效果呢？没有特别好的办法，只有在代码中加上类似 window.history.back(); 的代码就做出来的效果就非常像了。

还有一个问题，我这做的动态链接其实都存放在一个实体中，我需要的只是一个名称name就可以去获取了，当设置导航项目是Web资源时候可以传递参数过来吗？答案是可以的。界面上设置似乎效果不好，可以直接编辑站点地图的URL，我这里举个例子。值得注意的是要用 data 这个query string key来传递值，传递的键值对要用JavaScript encodeURIComponent 函数编码下，比如 = 需要转换成 %3D 。

            <SubArea Id="NewSubArea_1ac8c778" ResourceId="SitemapDesigner.NewSubArea" Url="$webresource:ly_/page/common/dynamicredirectpage.html?data=name%3DConiguration_Name" Client="All,Outlook,OutlookLaptopClient,OutlookWorkstationClient,Web" AvailableOffline="true" PassParams="false" Sku="All,OnPremise,Live,SPLA">
              <Titles>
                <Title LCID="1033" Title="Dynamics URL Demo" />
              </Titles>
            </SubArea>

下面再给这个HTML Web资源的代码示例如下：

<!DOCTYPE html>

<html lang="en" xmlns="http://www.w3.org/1999/xhtml">
<head>
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
    <meta http-equiv="X-UA-Compatible" content="IE=edge" charset="utf-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Lenovo</title>
    <script src="../../../ClientGlobalContext.js.aspx" type="text/javascript"></script>
</head>
<body onload="onLoad()">
    <script type="text/javascript">
        function onLoad() {
            window.history.back();
            var name = "YouKey";
            var queryStrArray = new Array();
            var vals = new Array();
            if (location.search !== "") {
                queryStrArray = location.search.substr(1).split("&");
                for (var i in queryStrArray) {
                    queryStrArray[i] = queryStrArray[i].replace(/+/g, " ").split("=");
                }
                for (var i in queryStrArray) {
                    if (queryStrArray[i][0].toLowerCase() === "data") {
                        vals = decodeURIComponent(queryStrArray[i][1]).split("&");
                        for (var i in vals) {
                            vals[i] = vals[i].replace(/+/g, " ").split("=");
                            if (vals[i][0].toLowerCase() === "name") {
                                name = vals[i][1];
                            }
                        }
                        break;
                    }
                }
            }
            if (typeof GetGlobalContext !== "undefined") {
                var clientUrl = GetGlobalContext().getClientUrl() + "/api/data/v9.1/";
                var req = new XMLHttpRequest();
                req.open("GET", encodeURI(clientUrl + "ly_configs?$select=ly_url&$filter=ly_name eq '" + name + "' and statecode eq 0&$top=1"), false);
                req.setRequestHeader("Accept", "application/json");
                req.setRequestHeader("Content-Type", "application/json; charset=utf-8");
                req.setRequestHeader("OData-MaxVersion", "4.0");
                req.setRequestHeader("OData-Version", "4.0");
                req.onreadystatechange = function () {
                    if (this.readyState === 4 /* complete */) {
                        req.onreadystatechange = null;
                        if (this.status === 200) {
                            var responseJson = JSON.parse(this.responseText);
                            if (responseJson.value.length >= 1) {
                                window.open(responseJson.value[0].ly_url);
                            }
                        }
                        else {
                            throw new Error("Query data error:" + JSON.parse(this.responseText));
                        }
                    }
                };
                req.send();
            } else {
                throw new Error("Reference to ClientGlobalContext.js.aspx error.");
            }
        }
    </script>
</body>
</html>