如何在Power Apps模型驱动应用表单中稳定获取HTML Web资源的formContext？

核心问题分析 #

不稳定的根源通常是Web资源加载时机与表单OnLoad执行时机不匹配，或是切换表单标签页导致Web资源重新渲染，丢失之前传递的formContext。多人访问时的环境加载速度差异，也会放大这个问题。

具体修改方案 #

方案1：给表单OnLoad添加重试机制，确保Web资源加载完成后再传递 #

修改表单的OnLoad函数，增加重试逻辑，避免Web资源未加载完成时调用getContentWindow失败：

function OnLoad(executionContext) {
    const formContext = executionContext.getFormContext();
    const webResourceName = "webResourceControl"; // 替换为你的Web资源控件名称

    // 重试函数：最多尝试5次，每次间隔500ms
    function tryPassContext(attemptsLeft) {
        const webResourceControl = formContext.getControl(webResourceName);
        if (!webResourceControl) {
            if (attemptsLeft > 0) {
                setTimeout(() => tryPassContext(attemptsLeft - 1), 500);
            }
            return;
        }

        webResourceControl.getContentWindow()
            .then(contentWindow => {
                // 先检查setClientApiContext是否存在，避免报错
                if (typeof contentWindow.setClientApiContext === "function") {
                    contentWindow.setClientApiContext(Xrm, formContext);
                } else {
                    // 若Web资源还没加载好函数，再重试一次
                    if (attemptsLeft > 0) {
                        setTimeout(() => tryPassContext(attemptsLeft - 1), 500);
                    }
                }
            })
            .catch(error => {
                if (attemptsLeft > 0) {
                    setTimeout(() => tryPassContext(attemptsLeft - 1), 500);
                }
            });
    }

    // 启动重试
    tryPassContext(5);
}

方案2：让Web资源主动获取formContext（更稳定） #

修改HTML Web资源代码，不再依赖表单传递，而是直接通过Power Apps全局上下文获取当前表单的formContext，即使Web资源重新渲染也能重新获取：

<script>
let _formContext;

// 初始化获取formContext
function initFormContext() {
    // 通过全局Xrm对象获取当前表单上下文
    _formContext = Xrm.Page.context.getFormContext();
}

// 页面加载时初始化，同时监听标签页切换重新获取
window.onload = function() {
    initFormContext();
    window.addEventListener("focus", initFormContext);
};

function OpenWebsite() {
    // 先检查formContext是否存在，不存在则重新获取
    if (!_formContext) {
        initFormContext();
    }
    if (_formContext) {
        const attribute = _formContext.getAttribute("new_examplename");
        if (attribute) {
            const value = attribute.getValue();
            // 后续打开网站逻辑
        } else {
            console.error("无法找到目标字段");
        }
    } else {
        console.error("无法获取表单上下文");
    }
}
</script>
<body>
    <button id="openButton" onClick="OpenWebsite()">Open website</button>
</body>

方案3：按钮点击时直接用Web API获取字段值（简化版） #

如果只需要获取单个字段值，可以跳过formContext，直接调用Web API查询，避免上下文传递问题：

function OpenWebsite() {
    const globalContext = Xrm.Utility.getGlobalContext();
    const entityId = globalContext.getQueryStringParameters().id;
    const entityName = globalContext.getQueryStringParameters().etn;
    
    // 调用Web API获取字段值
    Xrm.WebApi.retrieveRecord(entityName, entityId, "?$select=new_examplename").then(
        function success(result) {
            const fieldValue = result.new_examplename;
            // 打开外部网站逻辑
        },
        function error(error) {
            console.error(error.message);
        }
    );
}

额外注意事项 #

• 确保HTML Web资源的安全设置中勾选了“允许跨域访问”（在Power Apps解决方案编辑Web资源时设置）。
• 测试时切换表单标签页，验证Web资源是否能重新获取上下文。
• 避免在Web资源中依赖全局变量持久化，Power Apps表单环境会动态刷新。

内容的提问来源于stack exchange，提问作者catnipper