CRM365 Classic转Unified Interface列表视图自定义图标不显示问题求助
本地部署Dynamics 365 Unified Interface列自定义图标不显示的共性排查
这类问题是从Classic Interface迁移到Unified Interface过程中非常高频的共性场景,和你观察到的现象完全匹配:DOM层已经为图片生成了预留占位div,自定义图标的URL配置本身没有错误,但实际资源完全不加载,尤其在on-prem本地部署环境下,由于权限、配置逻辑和云版本存在差异,踩坑概率比云环境高很多。常见的诱因和对应的解决方向如下:
- 跨域资源白名单拦截(on-prem环境最高发)
Classic模式对列渲染的图片资源没有严格的域名校验,直接配置任意公网/内网可访问的绝对URL即可正常加载;但Unified Interface会对列内渲染的所有图片资源做域名信任校验,只要图片所在域名不在系统的已信任跨域资源列表中,就只会在DOM里生成空占位div,根本不会发起实际的图片资源请求。
解决时需要将托管自定义图标的站点域名添加到系统跨域信任列表,特别注意:就算图片文件和Dynamics系统部署在同一台服务器上,只要访问端口不一致,就会被判定为跨域资源,需要单独添加对应端口的信任规则。 - 图片资源引用方式不兼容UI渲染规则
Classic模式兼容在列图标配置中直接填写外部图片的绝对URL、甚至本地文件路径;但Unified Interface的列图标渲染逻辑,要求被引用的图片必须是提前上传到系统Web资源库的托管资源,手写的外部绝对URL会被渲染引擎在加载时静默过滤,最终只留下空占位元素。
解决时需要将所有自定义图标按视图列适配的尺寸要求(通常为16px×16px的透明底PNG)上传为系统Web资源,在列图标配置中直接选择对应已上传的Web资源条目,不要手动填写外部图片地址。 - 服务端资源代理接口权限不足
Unified Interface下的列图片资源,不会由前端浏览器直接请求原始图片地址,而是需要经过系统内置的Web资源代理接口拉取后,再返回给前端渲染。如果on-prem部署的IIS站点中,该代理接口的匿名访问权限被关闭,或是被引用的Web资源没有给当前登录用户分配访问权限,就会出现占位div已生成,但资源请求返回401/403状态、图片加载失败的情况。
排查时可以打开浏览器开发者工具的网络面板,定位对应占位元素关联的资源请求状态码,根据返回结果调整Web资源的角色访问权限,或是核对IIS站点中Web资源处理器的权限配置。 - 客户端本地视图缓存残留
Unified Interface的视图列渲染配置会缓存到浏览器本地存储中,如果之前配置过不带自定义图标的视图版本,就算服务端已经完成配置修正,本地缓存的旧配置依然会生成不带实际图片的空占位。
排查时可以用无痕窗口打开对应视图,如果图标在无痕窗口里正常显示,清除当前浏览器中对应Dynamics站点的本地存储缓存即可。
内容的提问来源于stack exchange,提问作者Maf
相关产品推荐
相关产品推荐

