Microsoft 365 Developer Blog
·
弃用引用文件附件的Insights项目中的previewImageUrl属性
内容提要
我们将弃用Insights项目中资源可视化的previewImageUrl属性，特别是文件附件的情况。此更改简化了API，并与支持的预览场景一致。请更新应用逻辑以处理该属性缺失，建议使用现代附件（云文件）。
关键要点
-
弃用Insights项目中资源可视化的previewImageUrl属性，特别是文件附件的情况。
-
此更改简化了API，并与支持的预览场景一致。
-
previewImageUrl属性不再返回文件附件项，因文件附件在Microsoft 365中没有一致的预览体验。
-
引用云文件（如driveItem）的项不受影响。
-
弃用通知：立即生效，移除日期为2027年11月1日。
-
如果应用使用resourceVisualization.previewImageUrl处理文件附件洞察，需更新逻辑以处理该属性缺失。
-
建议使用现代附件（云文件）并在适用时使用driveItem: preview操作。
延伸解读
API简化与一致性
弃用previewImageUrl属性旨在简化API设计，并确保与Microsoft 365中支持的预览场景一致。文件附件缺乏一致的预览体验，因此这一变更有助于提升开发者的使用体验，减少潜在的错误和混淆。
更新应用逻辑的重要性
开发者需要及时更新应用逻辑，以应对previewImageUrl属性的缺失。未进行更新可能导致应用在处理文件附件时出现错误，影响用户体验。因此，建议尽早适应这一变更，确保应用的稳定性。
现代附件的推荐
文章建议使用现代附件（如云文件）替代文件附件，以获得更好的预览体验。开发者应考虑使用driveItem: preview操作，这不仅符合新标准，还能提升用户对文件的访问和展示效果。
延伸问答
为什么要弃用previewImageUrl属性？
弃用previewImageUrl属性是因为文件附件在Microsoft 365中没有一致的预览体验，这样可以简化API并与支持的预览场景一致。
这个更改对使用文件附件的应用有什么影响？
使用文件附件的应用需要更新逻辑，以处理previewImageUrl属性缺失的情况。
弃用previewImageUrl属性的生效时间是什么时候？
该属性的弃用立即生效，移除日期为2027年11月1日。
如何处理缺失的previewImageUrl属性？
建议更新应用逻辑以处理该属性缺失，并优先使用现代附件（云文件）和driveItem: preview操作。
哪些资源不受此更改影响？
引用云文件（如driveItem）的项不受此更改影响。
弃用previewImageUrl属性后，如何进行文件预览？
弃用后，建议使用现代附件（云文件）并在适用时使用driveItem: preview操作进行文件预览。
