上传并处理静态文件
本文介绍如何将静态文件上传到 Microsoft Dynamics 365 Commerce 站点构建器,以及如何创建可用于请求该文件的自定义 URL 和文件名。
有些第三方连接器需要文件从电子商务站点托管和提供。 这些连接器预期文件将由对特定回叫 URL 路径和文件名的请求返回。 因此,本文说明如何在 Dynamics 365 Commerce 电子商务站点上载和提供具有用户可定义 URL 和文件名的静态文件。
创建返回静态文件的站点 URL
若要在 Commerce 站点构建器中创建返回静态文件的站点 URL,请按照下列步骤操作。
- 转到您的站点的媒体库,上载应由对您定义的 URL 的请求提供的文件。 如果您已经上载文件,则可以跳过此步骤。
- 转到您的站点的 URL。
- 选择新建 > 新建 URL。
- 在新建 URL 对话框中,选择媒体库资产。
- 在 URL 路径字段中,输入 URL 路径。 在路径中包括文件名。
- 选择下一步。 媒体库将打开,显示所有已上载的文档类型的媒体资产。
- 选择应为对您在步骤 5 中定义的 URL 的请求提供的文件。
- 选择保存。
此时,您创建的 URL 处于草稿状态。 在您发布 URL 之前,URL 指向的文件不会返回。 在发布 URL 之前,您可以验证它是否返回正确的数据。
验证和发布 URL
要在发布之前验证 URL,请按照下列步骤操作。
- 转到您的站点的 URL,选择要预览的 URL。
- 在右侧的属性窗格中,在编辑按钮下,选择正确的 URL 链接。 一个新浏览器窗口将打开,您应会收到 404 错误。
- 将 ?preview=inprogress 查询字符串追加到 URL(例如,
https://yoursite.com/callback.html?preview=inprogress
),然后重新加载页面。 您上载到媒体库的文件应在响应中返回。
验证 URL 后,可以将其发布。
- 转到您的站点的 URL,选择 URL。
- 在命令栏上选择发布。
更新 URL 指向的文件
URL 发布后,您可以对它进行更新,让它指向另一个文件。 或者,您可以更新 URL,让它指向不同的资源类型,如下一节中所述。 例如,您可以将 URL 指向内部页面或重定向。
要更新 URL 指向的文件,请按照下列步骤操作。
- 转到您的站点的 URL,选择要更新的 URL。
- 在右侧的属性窗格中,选择编辑。
- 在 URL 分配下,选择步骤 2 框,然后从媒体库中选择一个新文档。
- 选择应用。
更新 URL 指向的资产类型
您还可以更新 URL,让它指向其他类型的资产(资源),如内部页面或重定向。
要更新 URL 指向的资产类型,请按照下列步骤操作。
- 转到您的站点的 URL,选择要更新的 URL。
- 在右侧的属性窗格中,选择编辑。
- 在 URL 分配下,在步骤 1 下,选择其他资产类型。
- 选择步骤 2 框,然后选择新资产。
- 选择应用。
更改 URL 路径
创建 URL 后,它的路径无法更改。 如果必须更改用于提供文件或任何其他类型资源的 URL 路径,必须创建一个新 URL,将其映射到现有文件或其他资源,然后取消发布并删除旧 URL。
若要更改 URL 路径,请执行以下步骤。
- 要创建新的 URL 并将其映射到现有文件或另一个资源,请按照本文前面的创建返回静态文件的站点 URL 一节中的说明操作。
- 选择新 URL,然后在命令栏上选择发布。 新 URL 将发布。
- 要取消发布旧 URL,选择它,然后在命令栏上选择取消发布。 现在,您可以根据需要删除旧 URL 了。